为什么捐赠
API 资源管理器
列表和列表项

QList 和 QItem 是可以协同工作的一组组件,以垂直方式呈现多个行项目,作为单个连续元素。它们最适合显示类似的数据类型作为信息行,例如联系列表、播放列表或菜单。每一行被称为一项。QItem 也可以在 QList 之外使用。

列表可以包含项目或类似项目的组件,例如 QExpansionItemQSlideItem。此外,QSeparator 可用于在需要的地方分隔部分。

列表项具有以下预置子组件

  • QItemSection - 项目部分可以在特定内容中有多种用途。它们通过 avatarthumbnailside 属性控制。没有属性时,它将渲染 QItem 的主要部分(它跨越可用空间的最大范围)。
  • QItemLabel - 项目标签对 QItemSection 中的预定义文本内容类型或 QList 本身的标题式内容很有用。
加载 QList API...
加载 QItem API...
加载 QItemSection API...
加载 QItemLabel API...

用法

基本

基本



强制黑暗模式



紧凑



QItemSection

左侧头像/缩略图 QItemSection



右侧头像/缩略图 QItemSection



提示

当您有多行项目时,可以在 QItemSection 的 side/avatar 上使用 top 属性,将部分对齐到顶部,覆盖默认的中间对齐。

侧边 QItemSection



活动状态

活动属性



QItemLabel

警告

注意,您可以使用 lines 属性处理标签溢出,告诉它可以跨越多少行。但是,此功能使用 Webkit 特定的 CSS,因此在 IE/Edge 中无法正常工作。

ItemLabel



更复杂的示例

联系列表



设置



电子邮件



文件夹列表



出于以下示例演示目的,我们使用了 active 属性而不是 QItem 的路由属性(toexact)。UMD 没有 Vue 路由器,因此您无法在 Codepen/jsFiddle 中使用它。

菜单



提示

对于更复杂的菜单,还可以考虑使用 QExpansionItem

连接到 Vue 路由器

您可以将 QItem 与 Vue 路由器一起使用,方法是将绑定到它的 <router-link> 属性。这些属性允许监听当前应用程序路由,并在单击/点击时触发路由。

<q-item to="/inbox" exact>
  <q-item-section avatar>
    <q-icon name="inbox" />
  </q-item-section>

  <q-item-section>
    Inbox
  </q-item-section>
</q-item>

您还可以延迟、取消或重定向导航,如下所示。有关下面使用的 @click 事件的更深入说明,请参阅页面顶部的 QItem API 卡。