jQuery Mobile Data 屬性
jQuery Data 屬性
jQuery Mobile使用HTML5 data-*屬性來為移動設備創建更具觸摸友好性和吸引性的外觀。
在下面的參考列表中, 粗體顯示的值為默認值。
按鈕
在1.4版本以後已廢棄。 使用CSS類替代。 帶有data-role="button"的超鏈接。 button 元素、工具欄中的鏈接以及input 字段都會自動渲染成按鈕樣式,不需要添加data-role="button"。
Data-属性 | 值 | 描述 |
---|---|---|
data-corners | true | false | 规定按钮是否圆角 |
data-icon | 图标参考手册 | 规定按钮的图标。默认没有图标。 |
data-iconpos | left | right | top | bottom | notext | 规定图标的位置 |
data-iconshadow | true | false | 规定按钮图标是否有阴影 |
data-inline | true | false | 规定按钮是否内联 |
data-mini | true | false | 规定按钮是小尺寸还是常规尺寸 |
data-shadow | true | false | 规定按钮是否有阴影 |
data-theme | 字母 (a-z) | 规定按钮的主题颜色 |
如需組合多個按鈕,請使用帶有data-role="controlgroup" 屬性和data-type="horizontal|vertical" 的容器來規定是否水平或垂直組合按鈕。 |
複選框
帶有type="checkbox"的成雙成對的label和input。 它們會被自動渲染程按鈕樣式,data-role 不是必需的。
Data-属性 | 值 | 描述 |
---|---|---|
data-mini | true | false | 规定复选框是小尺寸还是常规尺寸 |
data-role | none | 防止 jQuery Mobile 把复选框渲染成按钮样式 |
data-theme | 字母 (a-z) | 规定复选框的主题颜色 |
如需組合多個複選框,請使用帶有data-role="controlgroup" 屬性和data-type="horizontal|vertical" 的容器來規定是否水平或垂直組合複選框。 |
可折疊塊
在帶有data-role="collapsible"的容器內部的後跟任意HTML標記的標題元素。
Data-属性 | 值 | 描述 |
---|---|---|
data-collapsed | true | false | 规定内容是折叠还是展开 |
data-collapsed-icon | 图标参考手册 | 规定可折叠按钮的图标。默认是 "plus" |
data-content-theme | 字母 (a-z) | 规定可折叠内容的主题颜色。是否为可折叠内容添加圆角 |
data-expanded-icon | 图标参考手册 | 规定当内容展开时可折叠按钮的图标。默认是 "minus" |
data-iconpos | left | right | top | bottom | 规定图标的位置 |
data-inset | true | false | 规定可折叠按钮是否渲染成圆角且带外边距 |
data-mini | true | false | 规定可折叠按钮是小尺寸还是常规尺寸 |
data-theme | 字母 (a-z) | 规定可折叠按钮的主题颜色 |
可折疊集合
在帶有data-role="collapsible-set"的容器內部的可折疊內容塊。
Data-属性 | 值 | 描述 |
---|---|---|
data-collapsed-icon | 图标参考手册 | 规定可折叠按钮的图标。默认是 "plus" |
data-content-theme | 字母 (a-z) | 规定可折叠按钮的主题颜色 |
data-expanded-icon | 图标参考手册 | 规定当内容展开时可折叠按钮的图标。默认是 "minus" |
data-iconpos | left | right | top | bottom | notext | 规定图标的位置 |
data-inset | true | false | 规定可折叠块是否渲染成圆角且带外边距 |
data-mini | true | false | 规定可折叠按钮是小尺寸还是常规尺寸 |
data-theme | 字母 (a-z) | 规定可折叠集合的主题颜色 |
內容
在1.4版本已廢棄, 1.5版本後不再支持。 使用data-role="content"的容器。
Data-屬性 | 值 | 描述 |
---|---|---|
data-theme | 字母 (az) | 規定內容的主題顏色。 |
控件組
帶有data-role="controlgroup"的<div>或<fieldset>容器。 組合單個類型(基於鏈接的按鈕、單選按鈕、複選框、select 元素)的多個按鈕樣式的input。 對於組合表單複選框和單選按鈕,推薦在帶有data-role="fieldcontain" 的<div> 內使用<fieldset> 容器來改進標籤樣式。
Data-属性 | 值 | 描述 |
---|---|---|
data-mini | true | false | 规定控件组是小尺寸还是常规尺寸 |
data-type | horizontal | vertical | 规定控件组是水平显示还是垂直显示 |
對話框
帶有data-role="dialog"的容器或帶有data-rel="dialog"的鏈接。
Data-属性 | 值 | 描述 |
---|---|---|
data-close-btn-text | sometext | 规定对话框关闭按钮的文本 |
data-dom-cache | true | false | 规定是否清除各个页面的 jQuery DOM 缓存(如果设置为 true,您必须自己管理 DOM 并在所有移动设备上进行测试) |
data-overlay-theme | 字母 (a-z) | 规定对话框页面的蒙版(背景)颜色 |
data-theme | 字母 (a-z) | 规定对话框页面的主题颜色 |
data-title | sometext | 规定对话框页面的标题 |
增強
帶有data-enhance="false"或data-ajax="false"的容器。
Data-属性 | 值 | 描述 |
---|---|---|
data-enhance | true | false | 如果设置为 "true"(默认),jQuery Mobile 会自动渲染页面,使其更适合于移动设备。如果设置为 "false",框架将不会渲染页面 |
data-ajax | true | false | 规定是否通过 ajax 加载页面 |
注意: data-enhance="false"必須與$.mobile.ignoreContentEnabled=true"一同使用來阻止jQuery Mobile自動渲染頁面。
當$.mobile.ignoreContentEnabled 設置為true 時,data-ajax="false" 容器內的任何鏈接或表單元素將會被框架的導航功能忽略。
域容器
1.4版本後已廢棄,在1.5版本後不再支持,將使用class="ui-fieldcontain替代"。 包裹在label/form元素對,並帶有data-role="fieldcontain"的容器。
固定工具欄
帶有data-role="header"或data-role="footer" ,並帶有data-position="fixed"屬性的容器。
Data-属性 | 值 | 描述 |
---|---|---|
data-disable-page-zoom | true | false | 规定用户是否能缩放页面 |
data-fullscreen | true | false | 规定工具栏是否一直固定在顶部或底部 |
data-tap-toggle | true | false | 规定用户是否能够通过点击改变工具栏的可见性 |
data-transition | slide | fade | none | 规定当点击发生时的切换效果 |
data-update-page-padding | true | false | 规定页面顶部和底部的内边距是否在 resize、transition 和 "updatelayout" 事件发生时更新(jQuery Mobile 在 "pageshow" 事件发生时总是更新内边距) |
data-visible-on-page-show | true | false | 规定当父页面显示时工具栏的可见性 |
翻轉撥動開關
一個帶有data-role="slider"的<select>元素和兩個<option>元素。
Data-属性 | 值 | 描述 |
---|---|---|
data-mini | true | false | 规定开关是小尺寸还是常规尺寸 |
data-role | none | 防止 jQuery Mobile 把拨动开关渲染成按钮样式 |
data-theme | 字母 (a-z) | 规定拨动开关的主题颜色 |
data-track-theme | 字母 (a-z) | 规定轨道的主题颜色 |
尾部欄
帶有data-role="footer"的容器。
Data-属性 | 值 | 描述 |
---|---|---|
data-id | sometext | 规定唯一 ID。对于持续的尾部栏是必需的 |
data-position | inline | fixed | 规定尾部栏是与页面内容内联还是保持固定在底部 |
data-fullscreen | true | false | 规定尾部栏是固定在底部还是覆盖在页面内容上(查看范围更大) |
data-theme | 字母 (a-z) | 规定尾部栏的主题颜色。默认是 "a" |
注意:如需啟用全屏定位,請使用data-position="fixed",然後添加data-fullscreen屬性到元素上。
頭部欄
帶有data-role="header"的容器。
Data-属性 | 值 | 描述 |
---|---|---|
data-id | sometext | 规定唯一 ID。对于持续的头部栏是必需的 |
data-position | inline | fixed | 规定头部栏是与页面内容内联还是保持固定在顶部 |
data-fullscreen | true | false | 规定头部栏是固定在顶部还是覆盖在页面内容上(查看范围更大) |
data-theme | 字母 (a-z) | 规定头部栏的主题颜色。默认是 "a" |
注意:如需啟用全屏定位,請使用data-position="fixed",然後添加data-fullscreen屬性到元素上。
鏈接
所有的鏈接,包含那些帶有data-role="button" 的鏈接和表單提交按鈕。
Data-属性 | 值 | 描述 |
---|---|---|
data-ajax | true | false | 规定是否通过 ajax 加载页面来提高用户体验和交互。如果设置为 false,jQuery Mobile 将会执行一个正常的页面请求。 |
data-direction | reverse | 反向转换动画(仅用于页面和对话框) |
data-dom-cache | true | false | 规定是否清除各个页面的 jQuery DOM 缓存(如果设置为 true,您必须自己管理 DOM 并在所有移动设备上进行测试) |
data-prefetch | true | false | 规定是否预先读取页面到 DOM 中,以便当用户访问它们时可用 |
data-rel | back | dialog | external | popup | 规定链接行为的选项。Back - 回退到历史记录中的前一个页面。Dialog - 以对话框形式打开链接,不保存到历史记录中。External - 用于链接到另一个域。Popup - 打开一个弹出窗口。 |
data-transition | fade | flip | flow | pop | slide | slidedown | slidefade | slideup | turn | none | 规定一个页面切换到下一个页面的效果。请查看我们的 jQuery Mobile 页面切换章节。 |
data-position-to | origin | jQuery selector | window | 规定弹出框的位置。Origin - 默认。定位弹窗在打开它的链接上。jQuery selector - 定位弹窗在指定元素上。Window - 定位弹窗在窗口屏幕的中央。 |
列表
帶有data-role="listview"的<ol>或<ul>。
Data-属性 | 值 | 描述 |
---|---|---|
data-autodividers | true | false | 规定是否自动划分列表项 |
data-count-theme | 字母 (a-z) | 规定计数气泡的主题颜色。 |
data-divider-theme | 字母 (a-z) | 规定列表分隔的主题颜色。 |
data-filter | true | false | 规定是否在列表中添加搜索框 |
data-filter-placeholder | sometext | 1.4 版本后废弃。使用 HTML placeholder 属性替代。规定搜索框内的文本。默认是 "Filter items..." |
data-filter-theme | 字母 (a-z) | 规定搜索过滤的主题颜色。 |
data-icon | 图标参考手册 | 规定列表的图标 |
data-inset | true | false | 规定列表是否渲染成圆角且带外边距 |
data-split-icon | 图标参考手册 | 规定分割按钮的图表。默认是 "arrow-r" |
data-split-theme | 字母 (a-z) | 规定分割按钮的主题颜色。 |
data-theme | 字母 (a-z) | 规定列表的主题颜色 |
列表項
帶有data-role="listview"的<ol>或<ul>內的<li>。
Data-属性 | 值 | 描述 |
---|---|---|
data-filtertext | sometext | 规定当过滤元素时要搜索的文本。该文本将会被过滤,而不是实际的列表项文本 |
data-icon | 图标参考手册 | 规定列表项图标 |
data-role | list-divider | 规定列表项的分隔 |
data-theme | 字母 (a-z) | 规定列表项的主题颜色 |
注意: data-icon屬性只作用於帶有鏈接的列表項。
導航欄
帶有data-role="navbar"容器內部的<li>元素。
Data-属性 | 值 | 描述 |
---|---|---|
data-icon | 图标参考手册 | 规定列表项的图标 |
data-iconpos | left | right | top | bottom | notext | 规定图标的位置 |
導航欄從他們的父容器中繼承了主題樣本。 為導航欄設置data-theme 屬性是不可能的。 可以為導航欄中的每個鏈接單獨設置data-theme 屬性。 |
頁面
帶有data-role="page"的容器。
Data-属性 | 值 | 描述 |
---|---|---|
data-add-back-btn | true | false | 自动添加后退按钮,仅限头部栏 |
data-back-btn-text | sometext | 规定后退按钮的一些文本 |
data-back-btn-theme | 字母 (a-z) | 规定后退按钮的主题颜色 |
data-close-btn-text | 字母 (a-z) | 规定对话框上关闭按钮的一些文本 |
data-dom-cache | true | false | 规定是否清除各个页面的 jQuery DOM 缓存(如果设置为 true,您必须自己管理 DOM 并在所有移动设备上进行测试) |
data-overlay-theme | 字母 (a-z) | 规定对话框页面的蒙版(背景)颜色 |
data-theme | 字母 (a-z) | 规定页面的主题颜色。 |
data-title | sometext | 规定页面标题 |
data-url | url | 更新 URL 的值,而不是用于请求页面的 URL |
彈窗
帶有data-role="popup"的容器。
Data-属性 | 值 | 描述 |
---|---|---|
data-corners | true | false | 规定弹窗是否圆角 |
data-overlay-theme | 字母 (a-z) | 规定弹出框的蒙版(背景)颜色。默认是透明背景(无) |
data-shadow | true | false | 规定弹出框是否有阴影 |
data-theme | 字母 (a-z) | 规定弹出框的主题颜色。默认是继承的,"none" 设置弹窗为透明的 |
data-tolerance | 30, 15, 30, 15 | 规定窗口边缘(上 top、右 right、下 bottom、左 left)的距离 |
帶有data-rel="popup"的錨:
Data-属性 | 值 | 描述 |
---|---|---|
data-position-to | origin | jQuery selector | window | >规定弹出框的位置。Origin - 默认。定位弹窗在打开它的链接上。jQuery selector - 定位弹窗在指定元素上。Window - 定位弹窗在窗口屏幕的中央。 |
data-rel | popup | 用于打开弹出框 |
data-transition | fade | flip | flow | pop | slide | slidedown | slidefade | slideup | turn | none | 规定一个页面切换到下一个页面的效果。请查看我们的 jQuery Mobile 页面切换章节。 |
單選按鈕
帶有type="radio"的成雙成對的label和input。 它們會被自動渲染程按鈕樣式,data-role 不是必需的。
Data-属性 | 值 | 描述 |
---|---|---|
data-mini | true | false | 规定按钮是小尺寸还是常规尺寸 |
data-role | none | 防止 jQuery Mobile 渲染单选按钮的样式为增强状态的按钮,使元素以 HTML 原生的状态显示 |
data-theme | 字母 (a-z) | 规定单选按钮的主题颜色 |
如需組合多個單選按鈕,請使用帶有data-role="controlgroup" 屬性和data-type="horizontal|vertical" 的容器來規定是否水平或垂直組合單選按鈕。 |
選擇
所有的<select>元素。 這些會被自動渲染成按鈕樣式,date-role 是不必需的。
Data-属性 | 值 | 描述 |
---|---|---|
data-icon | 图标参考手册 | 规定 select 元素的图标。默认是 "arrow-d" |
data-iconpos | left | right | top | bottom | notext | 规定图标的位置 |
data-inline | true | false | 规定 select 元素是否内联 |
data-mini | true | false | 规定 select 元素是小尺寸还是常规尺寸 |
data-native-menu | true | false | 当设置为 false 时,它使用 jQuery 自带的自定义的选择菜单(如果您想要让选择菜单在所有的移动设备上都显示相同,则推荐这么使用) |
data-overlay-theme | 字母 (a-z) | 规定 jQuery 自带的自定义的选择菜单的主题颜色(与 data-native-menu="false" 一起使用) |
data-placeholder | true | false | 可在一个非原生的选择菜单的 <option> 元素上设置 |
data-role | none | 防止 jQuery Mobile 把 select 元素渲染成按钮样式 |
data-theme | 字母 (a-z) | 规定 select 元素的主题颜色 |
如需組合多個select 元素,請使用帶有data-role="controlgroup" 屬性和data-type="horizontal|vertical" 的容器來規定是否水平或垂直組合select 元素。 |
滑動塊
帶有type="range"的輸入框。 這些會被自動渲染成按鈕樣式,date-role 是不必需的。
Data-属性 | 值 | 描述 |
---|---|---|
data-highlight | true | false | 规定滑动轨道是否高亮突出显示 |
data-mini | true | false | 规定滑动块是小尺寸还是常规尺寸 |
data-role | none | 防止 jQuery Mobile 渲染滑动块控件为按钮样式 |
data-theme | 字母 (a-z) | 规定滑动块控件(输入框、手柄和轨道)的主题颜色 |
data-track-theme | 字母 (a-z) | 规定滑动块轨道的主题颜色 |
文本輸入框& 文本輸入域
帶有type="text|search|etc."的input或textarea元素 。 這些會被自動渲染成按鈕樣式,date-role 是不必需的。
Data-属性 | 值 | 描述 |
---|---|---|
data-mini | true | false | 规定输入框是小尺寸还是常规尺寸 |
data-role | none | 防止 jQuery Mobile 把输入框/输入域渲染成按钮样式 |
data-theme | 字母 (a-z) | 规定输入字段的主题颜色 |