# 5.3 列表项(Item)

列表项组件,用于列表中的单个项目

# 基础用法

<template>
  <dof-item title="标题" desc="描述"></dof-item>
</template>
1
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 }