시작하기
페이지 구조
jQuery Mobile은 data-role 속성으로 HTML을 강화합니다. 페이지는 header, main, footer 섹션을 담은 data-role=page div입니다. 모바일 기기에서 올바른 스케일링에는 viewport 메타 태그가 필수입니다. jquery.mobile.js 전에 jQuery 코어를 로드하세요.
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.css">
<script src="https://code.jquery.com/jquery-1.11.1.min.js"></script>
<script src="https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.js"></script>
</head>
<body>
<div data-role="page" id="home">
<div data-role="header"><h1>Home</h1></div>
<div data-role="main" class="ui-content">Content</div>
<div data-role="footer"><h4>Footer</h4></div>
</div>
</body>
</html>하나의 문서에 여러 페이지
단일 HTML 파일에 여러 개의 data-role=page div를 넣을 수 있습니다. 앵커 href(#about)로 서로 연결하세요. jQuery Mobile은 한 번에 한 페이지를 보여주고 전환을 애니메이션합니다. 초기 로드에는 소스 순서상 첫 페이지만 표시됩니다.
<div data-role="page" id="home">
<div data-role="header"><h1>Home</h1></div>
<div data-role="main" class="ui-content">
<a href="#about" class="ui-btn">Go to About</a>
</div>
</div>
<div data-role="page" id="about" data-theme="b">
<div data-role="header"><h1>About</h1></div>
<div data-role="main" class="ui-content">
<a href="#home" class="ui-btn" data-direction="reverse">Back</a>
</div>
</div>AJAX 내비게이션 & 링크
기본적으로 내부(#id)와 같은 오리진 페이지로의 링크는 AJAX로 가져와 전환과 함께 교체됩니다. 일반 전체 페이지 로드를 강제하려면 data-ajax=false를 쓰세요(jQuery Mobile이 아닌 페이지에 유용). data-prefetch는 대상을 미리 로드해 전환이 즉시 느껴지게 합니다.
<!-- Default: links load via AJAX and animate a transition -->
<a href="detail.html" class="ui-btn">Open detail (AJAX)</a>
<!-- Force a full page reload (no AJAX) -->
<a href="external.html" data-ajax="false">Full reload</a>
<!-- Open in new window/tab -->
<a href="https://example.com" rel="external">External site</a>
<!-- Prefetch a page when this page loads -->
<a href="next.html" data-prefetch="true" class="ui-btn">Prefetch next</a>프리페치 & DOM 캐싱
프리페칭은 링크된 페이지를 백그라운드에서 불러와 내비게이션이 즉각적으로 느껴지게 합니다. 기본적으로 방문한 페이지는 DOM에서 제거되지만, domCache는 메모리를 대가로 더 빠른 뒤로 가기 위해 유지합니다. 페이지별로는 data-dom-cache, 전역으로는 page 프로토타입 옵션으로 활성화하세요.
<!-- Prefetch several pages -->
<a href="page1.html" data-prefetch="true">Page 1</a>
<a href="page2.html" data-prefetch="true">Page 2</a>
<!-- Globally enable DOM caching of visited pages -->
<script>
$(document).on("mobileinit", function () {
$.mobile.page.prototype.options.domCache = true;
});
</script>
<!-- Cache a single page -->
<div data-role="page" id="cached" data-dom-cache="true">...</div>다이얼로그 페이지
링크에 data-rel=dialog를(또는 페이지에 data-dialog=true를) 추가하면 닫기 버튼과 전환이 있는 모달 대화상자 스타일 페이지가 열립니다. 링크 에 data-rel=back을 쓰면 닫고 이전 페이지로 돌아갑니다.
<!-- Open a page as a dialog -->
<a href="#dialog" class="ui-btn" data-rel="dialog">Open dialog</a>
<div data-role="page" id="dialog" data-dialog="true">
<div data-role="header"><h1>Dialog</h1></div>
<div data-role="main" class="ui-content">
<p>This page is styled as a dialog.</p>
<a href="#" class="ui-btn" data-rel="back">Close</a>
</div>
</div>전역 설정 (mobileinit)
mobileinit 이벤트는 jQuery 코어가 로드된 뒤, jQuery Mobile이 초기화되기 전에 발생합니다 — jquery.mobile.js를 포함하기 전에 여기서 설정을 바인딩하세요. 흔한 오버라이드: 기본 전환, AJAX 설정, 로딩 메시지 텍스트. autoInitializePage=false는 첫 페이지가 언제 초기화될지 제어하게 해 줍니다.
<script src="jquery-1.11.1.min.js"></script>
<script>
// Bind BEFORE loading jquery.mobile.js
$(document).on("mobileinit", function () {
$.mobile.defaultPageTransition = "slide";
$.mobile.defaultDialogTransition = "pop";
$.mobile.loadingMessage = "Loading...";
$.mobile.ajaxEnabled = true;
$.mobile.linkBindingEnabled = true;
$.mobile.autoInitializePage = true;
});
</script>
<script src="jquery.mobile-1.4.5.min.js"></script>페이지 전환
기본 전환
링크에 data-transition을 추가해 이동 시 애니메이션을 고르세요. 전환은 CSS 기반입니다(가능한 곳은 하드웨어 가속). 'none'은 애니메이션을 건너뛰어 즉시 이동합니다. 같은 속성이 다이얼로그와 팝업에도 동작합니다.
<!-- Apply a transition to a link -->
<a href="#page2" data-transition="slide">Slide</a>
<a href="#page2" data-transition="fade">Fade</a>
<a href="#page2" data-transition="pop">Pop</a>
<a href="#page2" data-transition="flip">Flip</a>
<a href="#page2" data-transition="none">None (instant)</a>전환 타입
jQuery Mobile은 2D/3D CSS 전환 집합을 제공합니다. 3D 전환(turn, flow, flip)은 성능 좋은 기기에서 멋지지만 오래된 하드웨어에서 우아하게 폴백합니다. pop과 fade가 가장 효율적이며 다이얼로그와 팝업에 권장됩니다.
<!-- Available transitions in jQuery Mobile 1.4 -->
fade <!-- default, fade in/out -->
pop <!-- scale in from center (good for dialogs) -->
slide <!-- slide left to right -->
slideup <!-- slide up from bottom -->
slidedown <!-- slide down from top -->
slidfade <!-- slide + fade -->
turn <!-- 3D turn -->
flow <!-- 3D flow -->
flip <!-- 3D flip -->
none <!-- no animation -->방향 & 역방향
data-direction=reverse는 전환을 거꾸로 재생합니다 — 앞으로 가는 내비게이션을 미러링하도록 Back 버튼에 주로 씁니다. data-transition과 짝짓습니다; 전환이 설정되지 않으면 기본 전환이 역방향으로 재생됩니다.
<!-- Reverse a transition (e.g., for Back buttons) -->
<a href="#home" data-transition="slide" data-direction="reverse">Back</a>
<!-- Globally reverse the default -->
<a href="#home" data-direction="reverse">Back (uses default transition reversed)</a>다이얼로그 전환
다이얼로그에는 어떤 전환이든 쓸 수 있지만 모달에는 pop과 slidedown이 가장 자연스럽습니다. mobileinit 중 $.mobile.defaultDialogTransition으로 전역 기본값을 설정하세요. 다이얼로그의 닫기 액션은 전환을 자동으로 역방향으로 재생합니다.
<!-- Combine data-rel=dialog with a transition -->
<a href="#settings" data-rel="dialog" data-transition="pop">Settings</a>
<a href="#settings" data-rel="dialog" data-transition="slidedown">Settings (slide down)</a>
<!-- Set a global default dialog transition -->
<script>
$(document).on("mobileinit", function () {
$.mobile.defaultDialogTransition = "pop";
});
</script>비활성화 & 폴백
data-transition=none이나 전역 기본값을 'none'으로 두면 애니메이션이 꺼집니다 — 저사양 기기나 접근성에 유용합니다. jQuery Mobile은 3D transform 지원을 자동 감지해 지원되지 않을 때 3D 전환(flip, turn, flow)을 단순 fade로 저하시킵니다.
<!-- Disable transitions for a specific link -->
<a href="#page2" data-transition="none">No animation</a>
<!-- Globally disable (useful for older devices / testing) -->
<script>
$(document).on("mobileinit", function () {
$.mobile.defaultPageTransition = "none";
$.mobile.defaultDialogTransition = "none";
});
</script>
<!-- 3D transitions fall back to fade when not supported -->툴바 (Header & Footer)
고정 헤더 & 푸터
data-position=fixed를 추가하면 페이지가 스크롤되는 동안 헤더나 푸터가 뷰포트 위/아래에 고정됩니다. 기본적으로 페이지를 탭하면 툴바 가시성이 토글됩니다. 툴바 뒤에 숨지 않도록 페이지 콘텐츠에 패딩이 붙습니다.
<div data-role="page" id="home">
<div data-role="header" data-position="fixed">
<h1>Fixed Header</h1>
</div>
<div data-role="main" class="ui-content">
<p>Scroll the page — the toolbars stay in place.</p>
</div>
<div data-role="footer" data-position="fixed">
<h4>Fixed Footer</h4>
</div>
</div>풀스크린 툴바
data-fullscreen=true는 공간을 예약하는 대신 고정 툴바를 콘텐츠 위에(반투명으로) 겹칩니다. 콘텐츠가 화면을 채워야 하는 사진 뷰어나 지도에 좋습니다. 툴바는 고정 툴바처럼 탭으로 나타났다 사라집니다.
<div data-role="page" id="photo">
<div data-role="header" data-position="fixed" data-fullscreen="true">
<h1>Photos</h1>
</div>
<div data-role="main" class="ui-content">
<img src="photo.jpg" style="width:100%">
</div>
<div data-role="footer" data-position="fixed" data-fullscreen="true">
<h4>Footer over content</h4>
</div>
</div>지속 툴바
두 페이지가 같은 data-id와 data-position=fixed를 가진 푸터(또는 헤더)를 가지면, 툴바는 페이지와 함께 애니메이션되는 대신 페이지 전환에 걸쳐 지속됩니다. 지속되는 하단 내비게이션 바의 표준 패턴입니다 — 페이지마다 활성 링크만 바뀝니다.
<!-- Both pages use the SAME data-id so the footer persists -->
<div data-role="page" id="home">
<div data-role="footer" data-id="main-nav" data-position="fixed">
<div data-role="navbar">
<ul><li><a href="#home" class="ui-btn-active">Home</a></li>
<li><a href="#settings">Settings</a></li></ul>
</div>
</div>
</div>
<div data-role="page" id="settings">
<div data-role="footer" data-id="main-nav" data-position="fixed">
<div data-role="navbar">
<ul><li><a href="#home">Home</a></li>
<li><a href="#settings" class="ui-btn-active">Settings</a></li></ul>
</div>
</div>
</div>탭 토글 동작
고정 툴바는 사용자가 페이지를 탭하면 가시성을 토글합니다. 툴바를 항상 보이게 하려 data-tap-toggle=false를 쓰세요. 관련 요소별 옵션: data-hide-during-focus(input 포커스 시 숨김)과 data-update-page-padding(리사이즈 시 페이지 패딩 재적용).
<!-- Disable tap-to-toggle on a fixed toolbar -->
<div data-role="header" data-position="fixed" data-tap-toggle="false">
<h1>Always visible</h1>
</div>
<!-- Globally turn off tap toggle -->
<script>
$(document).on("mobileinit", function () {
$.mobile.toolbar.prototype.options.tapToggle = false;
});
</script>툴바 테마 & 버튼
헤더는 ui-btn-left / ui-btn-right 클래스로 배치된 버튼을 담을 수 있습니다. data-theme이 바의 색 스와치를 정합니다. data-iconpos=notext는 아이콘만 보여 컴팩트한 모양을 만듭니다. 헤더 안의 버튼은 인라인 버튼으로 자동 스타일링됩니다.
<div data-role="header" data-theme="b">
<a href="#" class="ui-btn-left" data-icon="home" data-iconpos="notext">Home</a>
<h1>Title</h1>
<a href="#" class="ui-btn-right" data-icon="gear" data-iconpos="notext">Settings</a>
</div>동적 툴바 갱신
런타임에 툴바 마크업을 바꾼 뒤에는 $(el).toolbar('refresh')를 호출해 스타일링과 패딩을 재적용하세요. 툴바 위젯(1.4에서 도입)이 고정 위치와 탭 토글을 관리합니다; 페이지 생성 후 툴바를 추가했다면 $().toolbar()로 수동 초기화하세요.
<script>
// Update the header title and re-enhance after DOM change
$(function () {
$("#my-header h1").text("New Title");
$("#my-header").toolbar("refresh");
});
</script>
<div data-role="header" id="my-header" data-position="fixed">
<h1>Old Title</h1>
</div>