Appearance
Prompts 提示集组件
Prompts 是一个用于展示提示列表的通用组件,包含多个提示项,支持自定义样式、禁用状态、徽章、纵向展示、自动换行、响应式布局、底部内容等功能。
代码示例
基本
基本用法
loading
禁用状态
要将 Prompt 标记为禁用,请向 Prompt 添加 disabled
属性
loading
徽章
使用 badge
属性,给 Prompt 项右上角添加徽章
loading
纵向展示
使用 vertical
属性,控制 Prompts 展示方向。
loading
自动换行
使用 wrap
属性,控制 Prompts 超出区域长度时是否可以换行
loading
响应式布局
配合 wrap
与 item-style
或者 item-class
实现响应式布局
loading
底部内容
使用 footer
插槽,给 Prompts 列表底部添加内容
loading
API
PromptProps
单个提示项的属性配置。
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
label | string | 是 | 提示标签,显示提示的主要内容 |
id | string | 否 | 唯一标识用于区分每个提示项,用于 Prompts 列表。如果不传此参数,则使用 index 作为 key |
description | string | 否 | 提示描述,提供额外的信息 |
icon | VNode | 否 | 提示图标,显示在提示项的左侧 |
disabled | boolean | 否 | 是否禁用,默认 false |
badge | string | VNode | 否 | 提示徽章,显示在提示项的右上角 |
PromptsProps
提示列表组件的属性配置。
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
items | PromptProps[] | 是 | 包含多个提示项的列表 |
itemStyle | string | CSSProperties | 否 | 自定义样式,用于各个提示项的不同部分 |
itemClass | string | string[] | 否 | 自定义类名,用于各个提示项的不同部分 |
vertical | boolean | 否 | 提示列表是否垂直排列,默认 false |
wrap | boolean | 否 | 提示列表是否折行,默认 false |
PromptsEvents
提示列表组件的事件定义。
事件名 | 参数 | 说明 |
---|---|---|
item-click | (ev: MouseEvent, item: PromptProps) | 当点击提示项时触发 |
PromptsSlots
提示列表组件的插槽定义。
插槽名 | 说明 |
---|---|
footer | 底部插槽,用于在提示列表底部添加自定义内容 |