본문 바로가기
----- IT -----/jQuery Moblie

jQuery Mobile - API Methods (API 함수)

by 대소니 2011. 7. 15.

jQuery Mobile은 사용자 어플리케이션에서 사용할 수 있도록 $.mobile.object의 여러 methods와 properties를 제공합니다. 상세한 인수와 옵션은 JQM 홈페이지에서 참고하세요.
http://jquerymobile.com/demos/1.0b1/docs/api/methods.html

$.mobile.changePage(method)
페이지 전환시 프로그램적으로 변경합니다. 이 매소드는 폼을 전송하거나 링크를 클릭할 때 발생하는 페이지 로딩이나 페이지 전환시 내부적으로 사용됩니다.

// 페이지 이동시 전환효과는 slideup이 되며, about/us.html 페이지로 이동됩니다.
$.mobile.changePage( "about/us.html", { transition: "slideup"} );

// searchresults.php로 페이지 이동하며, post 방식으로 form아래 ID가 search인 데이터를 전송합니다.
$.mobile.changePage( "searchresults.php", {
    type: "post",
    data: $("form#search").serialize()
});

// confirm.html로 페이지 이동하며, 페이지 전환효과는 pop방식이고, hash에 등록되지 않으며 back버튼이 동작하지 않습니다.
$.mobile.changePage( "../alerts/confirm.html", {
    transition: "pop",
    reverse: false,
    changeHash: false
});

$.mobile.loadPage (method)
외부 페이지를 로드하고, DOM에 추가합니다. 이 method는 첫번째 인수로 URL이 올 때 changePage()함수를 통해 내부적으로 호출됩니다. 이 함수는 현재 활성화된 페이지에는 영향을 주지 않고, 백그라운드에서 페이지를 로드할 때 사용됩니다. 이 함수는 페이지가 로딩되고, 문서에 추가된 후에 미리 정의된 객체를 리턴합니다.

// about/us.html페이지를 로드해서 DOM에 추가합니다.
$.mobile.loadPage( "about/us.html" );

// searchresults.php페이지를 로드하고, post방식을 form안에 ID가 search인 데이터를 전송합니다.
$.mobile.loadPage( "searchresults.php", {
    type: "post",
    data: $("form#search").serialize()
});

jqmData(), jqmRemoveData(), and jqmHasData() (method)
jqmData와 jqmRemoveData는 jQuery core의 data와 removeData 입니다. Data 속성의Setting과 getting을 자동으로 만들어줍니다.

$(“div[data-role=’page’]”) 대신에 $(“div:jqmData(role=’page’)”)로 사용합니다.
$(“div[data-“+ $.mobile.ns +”role=’page’]”) 이런식으로 사용해도 됩니다.

$.mobile.showPageLoadingMsg()
페이지 로딩중 메시지를 보여줍니다.

$.mobile.hidePageLoadingMsg()
페이지 로딩중 메시지를 숨깁니다.

$.mobile.path.parseUrl (method)
URL을 파싱하는 유틸리티 함수입니다. URL의 각 요소에 접근하는 것이 간단합니다. 파싱할때 해당 값이 없으면 항목에 빈 string 값으로 채워집니다. Tel: urls 와 같은 권한 없는 URL을 파싱할 때, 경로 속성은 protocol/scheme 콜론 뒤에 데이터를 포함할 것입니다.

Var obj = $.mobile.path.parseUrl
("http://jblas:password@mycompany.com:8080/mail/inbox?msg=1234");


//  obj.href:         http://jblas:password@mycompany.com:8080/mail/inbox?msg=1234&type=unread#msg-content
//  obj.hrefNoHash:   http://jblas:password@mycompany.com:8080/mail/inbox?msg=1234&type=unread
//  obj.hrefNoSearch: http://jblas:password@mycompany.com:8080/mail/inbox
//  obj.domain:       http://jblas:password@mycompany.com:8080
//  obj.protocol:     http:
//  obj.authority:    jblas:password@mycompany.com:8080
//  obj.username:     jblas
//  obj.password:     password
//  obj.host:         mycompany.com:8080
//  obj.hostname:     mycompany.com
//  obj.port:         8080
//  obj.pathname:     /mail/inbox
//  obj.directory:    /mail/
//  obj.filename:     inbox
//  obj.search:       ?msg=1234&type=unread
//  obj.hash:         #msg-content


$.mobile.path.makePathAbsolute (method)
상대 경로를 절대 경로로 바꿔주는 유틸리티 함수입니다.

$.mobile.path.makeUrlAbsolute (method)
상대 경로 URL을 절대 경로 URL로 바꿔주는 유틸리티 함수입니다.

$.mobile.path.isSameDomain (method)
두개의 URL을 비교해서 같은 도메인인지 판단해 Boolean 값을 리턴합니다.

$.mobile.path.isRelativeUrl (method)
URL이 상대 경로인지를 판단하여 Boolean 값을 리턴합니다.

$.mobile.path.isAbsoluteUrl (method)
URL이 절대 경로인지를 판단하여 Boolean 값을 리턴합니다.

$.mobile.base (methods, properties)
일반화된 base element로 동작하도록 하는 유틸리티입니다.

$.mobile.silentScroll (method)
스크롤 이벤트 리스너를 사용하지 않고 인수로 지정한 Y위치로 스크롤 합니다.

$.mobile.addResolutionBreakpoints (method)
HTML 요소로 추가된 min/max width classes에 breakpoint를 추가합니다.
//add a 400px breakpoint
$.mobile.addResolutionBreakpoints(400);
//add 2 more breakpoints
$.mobile.addResolutionBreakpoints([600,800]);

$.mobile.activePage (property)
화면에 보여지고 있는 현재 페이지의 참조를 리턴합니다.

댓글