Skip to content

Prompts 提示集组件

Prompts 是一个用于展示提示列表的通用组件,包含多个提示项,支持自定义样式、禁用状态、徽章、纵向展示、自动换行、响应式布局、底部内容等功能。

代码示例

基本

基本用法

loading

禁用状态

要将 Prompt 标记为禁用,请向 Prompt 添加 disabled 属性

loading

徽章

使用 badge 属性,给 Prompt 项右上角添加徽章

loading

纵向展示

使用 vertical 属性,控制 Prompts 展示方向。

loading

自动换行

使用 wrap 属性,控制 Prompts 超出区域长度时是否可以换行

loading

响应式布局

配合 wrapitem-style 或者 item-class 实现响应式布局

loading

底部内容

使用 footer 插槽,给 Prompts 列表底部添加内容

loading

API

PromptProps

单个提示项的属性配置。

属性类型必填说明
labelstring提示标签,显示提示的主要内容
idstring唯一标识用于区分每个提示项,用于 Prompts 列表。如果不传此参数,则使用 index 作为 key
descriptionstring提示描述,提供额外的信息
iconVNode提示图标,显示在提示项的左侧
disabledboolean是否禁用,默认 false
badgestring | VNode提示徽章,显示在提示项的右上角

PromptsProps

提示列表组件的属性配置。

属性类型必填说明
itemsPromptProps[]包含多个提示项的列表
itemStylestring | CSSProperties自定义样式,用于各个提示项的不同部分
itemClassstring | string[]自定义类名,用于各个提示项的不同部分
verticalboolean提示列表是否垂直排列,默认 false
wrapboolean提示列表是否折行,默认 false

PromptsEvents

提示列表组件的事件定义。

事件名参数说明
item-click(ev: MouseEvent, item: PromptProps)当点击提示项时触发

PromptsSlots

提示列表组件的插槽定义。

插槽名说明
footer底部插槽,用于在提示列表底部添加自定义内容