# 5.3 列表项(Item)
列表项组件,用于列表中的单个项目
# 基础用法
<template>
<dof-item title="标题" desc="描述"></dof-item>
</template>
1
2
3
2
3
# Attributes
| Prop | Type | Required | Default | Description |
|---|---|---|---|---|
title | String | N | '' | 标题 |
desc | String | N | '' | 描述 |
height | String | N | "100" | 列表项高度 |
label | String | N | '' | 标签文本 |
right-text | String | N | '' | 右侧文本 |
click-activied | Boolean | N | false | 是否启用点击态 |
has-top-border | Boolean | N | false | 是否显示顶部边框 |
has-margin | Boolean | N | false | 是否显示外边距 |
has-bottom-border | Boolean | N | true | 是否显示底部边框 |
has-arrow | Boolean | N | false | 是否显示箭头 |
has-vertical-indent | Boolean | N | true | 是否启用垂直缩进 |
cell-style | Object | N | {} | 列表项样式 |
item-img | String | N | '' | 左侧图片地址 |
can-edit | Boolean | N | false | 是否显示编辑操作 |
arrow-icon | String | N | 内置右箭头 | 箭头图标地址 |
need-dark-mode | Boolean | N | false | 是否启用 M-dark/T-dark 内置暗黑适配 |
background-color | String | N | '' | 背景色 |
text-color | String | N | '' | 文字颜色 |
label-color | String | N | '' | 标签文字颜色 |
desc-color | String | N | '' | 描述文字颜色 |
right-text-color | String | N | '' | 右侧文字颜色 |
border-color | String | N | '' | 边框 / 分隔线颜色 |
isRTL | Boolean | N | false | 是否启用 RTL(从右到左)布局;默认关闭 ^2.5.10 |
设置 :need-dark-mode="true" 可启用内置暗黑配色,主题初始化与构建配置见 接入说明。
颜色属性为空时使用内置配色;业务显式颜色和样式覆盖优先于默认配色,关闭暗黑适配后仍有效。
cellStyle 中的业务样式优先于内置默认色。
# Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
dofCellClick | 点击列表项时触发 | { e } |
onDelete | 删除操作时触发 | { e } |
onItemPress | 长按/编辑操作时触发 | { e } |