1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150
|
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>jQuery Mobile Docs - Theming Pages</title>
<link rel="stylesheet" href="../../css/themes/default/jquery.mobile.css" />
<link rel="stylesheet" href="../_assets/css/jqm-docs.css"/>
<script src="../../js/jquery.js"></script>
<script src="../../docs/_assets/js/jqm-docs.js"></script>
<script src="../../js/jquery.mobile.js"></script>
</head>
<body>
<div data-role="page" class="type-interior">
<div data-role="header" data-theme="f">
<h1>Theming pages</h1>
<a href="../../" data-icon="home" data-iconpos="notext" data-direction="reverse">Home</a>
<a href="../nav.html" data-icon="search" data-iconpos="notext" data-rel="dialog" data-transition="fade">Search</a>
</div><!-- /header -->
<div data-role="content">
<div class="content-primary">
<ul data-role="controlgroup" data-type="horizontal" class="localnav">
<li><a href="pages-themes.html" data-role="button" data-transition="fade" class="ui-btn-active">Theme Overview</a></li>
<li><a href="pages-themes/theme-a.html" data-role="button" data-transition="fade">A </a></li>
<li><a href="pages-themes/theme-b.html" data-role="button" data-transition="fade">B </a></li>
<li><a href="pages-themes/theme-c.html" data-role="button" data-transition="fade">C </a></li>
<li><a href="pages-themes/theme-d.html" data-role="button" data-transition="fade">D </a></li>
<li><a href="pages-themes/theme-e.html" data-role="button" data-transition="fade">E </a></li>
</ul>
<h2>Page Theming</h2>
<p>jQuery Mobile has a rich <a href="../api/themes.html">theming system</a> that gives you full control of how pages are styled. There is detailed theming documentation within each page widget, but let's look at a few high-level examples of how theming is applied.</p>
<p>The <code> data-theme</code> attribute can be applied to the header and footer containers to apply any of the lettered theme color swatches. While the <code>data-theme</code> attribute could be added to the content container, we recommend adding it instead to <code>div</code> or container that has been assigned the <code> data-role="page"</code> attribute to ensure that the background color is applied to the full page. When this is done, all widgets on the page will also inherit the theme specified in the page container. However, headers and footers will default to theme "a". If you want to have a page with, for example, only theme "b" for all its elements, including its header and footer, you will need to specify <code>data-theme="b"</code> to the page <code>div</code> as well as the header and footer <code>divs</code>. </p>
<p>The default Theme mixes styles from multiple swatches to create visual texture and present the various elements in optimal contrast to one another:</p>
<div data-role="header">
<h1>Default Theme</h1>
</div>
<div class="ui-body ui-body-c">
<h3>Default Theme Content Header</h3>
<p>This is the default content color swatch and a preview of a <a href="#" class="ui-link">link</a>.</p>
<a href="#" data-role="button" data-inline="true">Button</a>
</div>
<p>And each of the five "swatches" applies its style consistently across all page elements, as shown below:</p>
<h2>Swatch A</h2>
<div data-role="header">
<h1>Header A</h1>
</div>
<div class="ui-body ui-body-a">
<h3>Header</h3>
<p>This is content color swatch "A" and a preview of a <a href="#" class="ui-link">link</a>.</p>
<a href="#" data-role="button" data-inline="true">Button</a>
</div>
<h2>Swatch B</h2>
<div data-role="header" data-theme="b">
<h1>Header B</h1>
</div>
<div class="ui-body ui-body-b">
<h3>Header</h3>
<p>This is content color swatch "B" and a preview of a <a href="#" class="ui-link">link</a>.</p>
<a href="#" data-role="button" data-inline="true">Button</a>
</div>
<h2>Swatch C</h2>
<div data-role="header" data-theme="c">
<h1>Header C</h1>
</div>
<div class="ui-body ui-body-c">
<h3>Header</h3>
<p>This is content color swatch "C" and a preview of a <a href="#" class="ui-link">link</a>.</p>
<a href="#" data-role="button" data-inline="true">Button</a>
</div>
<h2>Swatch D</h2>
<div data-role="header" data-theme="d">
<h1>Header D</h1>
</div>
<div class="ui-body ui-body-d">
<h3>Header</h3>
<p>This is content color swatch "D" and a preview of a <a href="#" class="ui-link">link</a>.</p>
<a href="#" data-role="button" data-inline="true">Button</a>
</div>
<h2>Swatch E</h2>
<div data-role="header" data-theme="e">
<h1>Header E</h1>
</div>
<div class="ui-body ui-body-e">
<h3>Header</h3>
<p>This is content color swatch "E" and a preview of a <a href="#" class="ui-link">link</a>.</p>
<a href="#" data-role="button" data-inline="true">Button</a>
</div>
</div><!--/content-primary -->
<div class="content-secondary">
<div data-role="collapsible" data-collapsed="true" data-theme="b" data-content-theme="d">
<h3>More in this section</h3>
<ul data-role="listview" data-theme="c" data-dividertheme="d">
<li data-role="list-divider">Pages & Dialogs</li>
<li><a href="page-anatomy.html">Anatomy of a page</a></li>
<li><a href="page-template.html" data-ajax="false">Single page template</a></li>
<li><a href="multipage-template.html" data-ajax="false">Multi-page template</a></li>
<li><a href="page-titles.html">Page titles</a></li>
<li><a href="page-links.html">Linking pages</a></li>
<li><a href="page-transitions.html">Page transitions</a></li>
<li><a href="page-dialogs.html">Dialogs</a></li>
<li><a href="page-cache.html">Prefetching & caching pages</a></li>
<li><a href="page-navmodel.html">Ajax, hashes & history</a></li>
<li><a href="page-dynamic.html">Dynamically injecting pages</a></li>
<li><a href="page-scripting.html">Scripting pages</a></li>
<li><a href="phonegap.html">PhoneGap apps</a></li>
<li><a href="touchoverflow.html">touchOverflow feature</a></li>
<li data-theme="a"><a href="pages-themes.html">Theming pages</a></li>
</ul>
</div>
</div>
</div><!-- /content -->
<div data-role="footer" class="footer-docs" data-theme="c">
<p>© 2011-12 The jQuery Foundation</p>
</div>
</div><!-- /page -->
</body>
</html>
|