直接跳到内容

ListView / ListItem 可滚动列表视图

ListView 是可键盘导航的滚动列表容器,每个列表项用 ListItem 包裹,ListItem 内部可放置 LabelStatic 等子组件。

底层:Textual ListView

基本用法

Props

ListView

属性类型默认值说明
initial_indexint0初始聚焦(高亮)的列表项索引

ListItem

属性类型默认值说明
内容通过默认 slot 传入(通常为 LabelStatic

v-model

  • ListViewv-model 默认绑定属性 items,绑定列表项数据集合
  • ListItemv-model 默认绑定属性 label

事件

事件说明
@list_view_selected列表项被按 Enter 选中时触发(ListView.Selected),event.list_view.index 为选中索引,event.item 为选中的 ListItem
@list_view_highlighted键盘移动高亮时触发(ListView.Highlighted),event.list_view.index 为当前高亮索引

动态列表示例

通用属性

所有 Textual-vuepy 组件均支持以下属性:

属性类型说明
idstr组件 CSS ID
stylestrTCSS 内联样式
classstrTCSS 类名(空格分隔)
border_titlestr边框标题
border_subtitlestr边框副标题
ListView / ListItem 可滚动列表视图已经加载完毕