+
+
Description
+
The jQuery Mobile theme framework contains multiple color "swatches" for bars, content blocks and buttons. The key to the theme system used in jQuery UI is separation of color and texture (theme) from structural styles that define things like padding and dimensions. This allows the theme colors and textures to be defined once in the stylesheet then re-used throughout the interface as configurable color swatches that can be mixed and matched. We also take advantage of CSS3 properties to add rounded corners, box and text shadow and gradients to make the theme styles very lightweight and reduce server requests.
+
+
Themes include at least 3 swatches for bars, content blocks and buttons. To make mapping of color swatches consistent across our widgets, we have followed the convention that swatch "a" is the highest level of visual priority (black in our default theme), "b" is secondary level (blue) and "c" is the baseline level (gray) that we use by default in many situations. Themes may have additional swatches but these are used for accents colors or specific situations within an app or site.
+
+
+
+
Bars
+
The default theme contains 4 color swatches for bars to use in header, footer and tool bars. The swatches are designated by letters (a, b, c, etc.) and are organized into a visual hierarchy where "a" is the highest level of visual priority, "b" is secondary, "c" is the baseline, and "d" is for accents. Each swatch defines the border color, text color, gradient, text-shadow, font family and link color. Our default theme looks like this:
+
+
+
Bar A
+
Bar B
+
Bar C
+
Bar D
+
+
+
By default, the framework assigns the "a" swatch (black in the default theme) to all headers and footer because these are typically given high visual priority in an application. To set the color of a bar to a different swatch color, simply add the data-theme attribute to your header or footer and specify a letter (a, b, c, d) and the specified theme swatch color will be applied.
+
+
+
+
Content Blocks
+
The default theme contains 3 color swatches for use in content blocks. These are designed to coordinate with the header color swatches in the default theme. Just as with bars, you can add as many content block swatches you want by extending the theme stylesheet. If a theme isn't specified on a content block, the framework will default to "c", just like the header.
+
+
+
Block A
+
Block B
+
Block C
+
+
+
+
Lists
+
There are 2 supported list view styles. FIX THIS.
+
+
+
+
+
Buttons
+
A set of 4 button colors are also included in the default theme. Each button has styles for normal, hover/focus and pressed states. Each button is intentionally styled to match the color of a bar so they feel tightly integrated.
+
+
+
+
Buttons in Bars
+
When a link is placed in a header or footer bar, it is automatically transformed into a compact-sized button and assigned a theme swatch letter that matches it's parent bar to visually integrate the button into the bar. Below, the same exact button code is in each of the 4 bars and is automatically adapting the right color swatch based on the parent bar swatch.
+
+
+
+
To add visual emphasis of certain buttons in a toolbar, the theme swatch can be manually on a button to make it stand out by adding data-theme="a" to the anchor.
+
+
+
+
Icons
+
+
+
+
+
Extensible themes
+
The powerful thing about the new jQuery Mobile theme system is that you can now add as many color swatches as you like within a single theme. In the future ThemeRoller tool, you will be able to add new swatches through an easy-to-use web interface. Until then, you can add new swatches manually by copying the block of theme style rules for an existing swatch, renaming the rules a new letter (e) and changing colors. You can then you can reference the new theme by adding the data-theme="e" attribute to your toolbars.
+
+
+