jQuery Mobile 列表视图

jQuery Mobile 列表视图

jQuery Mobile 中的列表视图是标准的 HTML 列表：有序列表 (<ol>) 和无序列表 (<ul>)。

如需创建列表，请向 <ol> 或 <ul> 元素添加 data-role="listview"。如需使这些项目可点击，请在每个列表项（<li>）中规定链接：

实例

<ol data-role="listview">
  <li><a href="#">列表项</a></li>
</ol>

<ul data-role="listview">
  <li><a href="#">列表项</a></li>
</ul>

亲自试一试

如需为列表添加圆角和外边距，请使用 data-inset="true" 属性：

实例

<ul data-role="listview" data-inset="true">

亲自试一试

提示：默认地，列表中的列表项会自动转换为按钮（无需 data-role="button"）。

列表分隔符

列表分隔符（List Dividers）用于把项目组织和组合为分类/节。

如需规定列表分隔符，请向 <li> 元素添加 data-role="list-divider" 属性：

实例

<ul data-role="listview">
 <li data-role="list-divider">欧洲</li>
  <li><a href="#">法国</a></li>
  <li><a href="#">德国</a></li>
</ul>

亲自试一试

如果您的列表是字母顺序的（比如通讯录），jQuery Mobile 自动添加恰当的分隔符，通过在 <ol> 或 <ul> 元素上设置 data-autodividers="true" 属性：

实例

<ul data-role="listview" data-autodividers="true">
  <li><a href="#">Adam</a></li>
  <li><a href="#">Angela</a></li>
  <li><a href="#">Bill</a></li>
  <li><a href="#">Calvin</a></li>
  ...
</ul>

亲自试一试

提示：data-autodividers="true" 属性通过对列表项文本的首字母进行大写来创建分隔符。

搜索过滤器

如需在列表中添加搜索框，请使用 data-filter="true" 属性：

实例

<ul data-role="listview" data-filter="true"></ul>

亲自试一试

默认地，搜索框中的文本是 "Filter items..."。

如需修改默认文本，请使用 data-filter-placeholder 属性：

实例

<ul data-role="listview" data-filter="true" data-filter-placeholder="搜索姓名">

亲自试一试

更多实例

只读列表
如何创建没有链接的列表（不是按钮，不可点击）。