Descriptions 描述列表

Hidden Title

基础用法：<s-descriptions :options="options" value="value2" label="key"></s-descriptions>

属性事件插槽简介

基础用法

主题（theme 默认值：default）

组件级 tooltipAttrs 会应用到自动生成的 label 和 value s-tooltip；单项 options[].tooltipAttrs 与组件级配置合并，同名属性以单项配置为准。基础写法：<s-descriptions :options="options" :tooltip-attrs="{ width: '180px', lineClamp: 1 }" />。属性：组件级和单项 tooltipAttrs 类型均为 object，默认值 undefined；支持 s-tooltip 属性，例如 width 默认值 100%、lineClamp 默认值 1、placement 默认值 bottom、showAfter 默认值 0。

单项控制 showAll（默认值：继承组件属性）

单项 showAll 优先于根属性；未设置时继承根级 showAll。基础写法：{ label: '内容', value: '长文本', showAll: false }。属性：根级和单项 showAll 类型均为 boolean，根级默认值 false，单项默认值为继承根级设置。

通常用法

每行展示多少项

slot插槽和 render

自定义样式

自定义全部标签和内容(数据全由后端返回)

other

API

属性名	说明	类型	默认值
`options`	描述项配置列表	`ItemOptions[]`	-
`theme`	主题样式，支持 `default` / `chenghua` / `shijingshan` / `sybz`	string	`default`
`size`	尺寸，控制单元格内边距与字体大小，可选 `small` / `default` / `large`	string	`default`
`column`	一行展示的描述项数量	number	`3`
`width`	描述列表容器宽度	string / number	-
`labelWidth`	label 宽度，传 `auto` 时会按最长 label 自动计算	string / number	`auto`
`showAll`	是否完整展示文本；单项 `showAll` 可覆盖此设置	boolean	`false`
`label`	options 中作为标签文本的字段名	string	`label`
`value`	options 中作为内容值的字段名	string	`value`
`customLabel`	统一自定义标签内容，单项 `labelRender`、`labelSlot` 优先	function	-
`customValue`	统一自定义值内容，单项 `render`、`valueSlot` 优先	function	-

ItemOptions

属性名	说明	类型	默认值
`label`	标签文本	string	-
`value`	内容值	any	-
`column`	当前项占用列数；当前行放不下时换行，上一项补齐剩余列	number	`1`
`showAll`	是否完整显示当前项文本；未设置时继承根级 `showAll`	boolean	继承根级
`labelSlot`	自定义 label 插槽名	string	-
`valueSlot`	自定义 value 插槽名	string	-
`labelRender`	自定义 label 渲染函数，`option` 为当前描述项数据	`({ option, value, label, index }) => VNode \| string`	-
`render`	自定义 value 渲染函数，`option` 为当前描述项数据	`({ option, value, label, index }) => VNode \| string`	-
`filter`	内容值格式化函数，`option` 为当前描述项数据	`({ option, value, index, label }) => any`	-
`attrs`	透传给 `el-descriptions-item` 的属性	object	-
`tooltipAttrs`	当前项 label 和 value 的 `s-tooltip` 属性；与组件级配置合并时当前项优先	object	`undefined`

插槽

插槽名	说明	插槽参数
`default`	自定义完整描述内容，会覆盖 `options` 渲染	-
`labelSlot` 对应名称	自定义某一项 label	`{ option, label, value, index }`
`valueSlot` 对应名称	自定义某一项 value	`{ option, label, value, index }`

透传属性

组件默认开启 border，其他属性会继续透传给 Element Plus el-descriptions。

Descriptions 描述列表 ​

Hidden Title ​

属性事件插槽简介 ​

基础用法 ​

主题（theme 默认值：default） ​

Tooltip 属性控制（tooltipAttrs 默认值：undefined） ​

单项控制 showAll（默认值：继承组件属性） ​

通常用法 ​

每行展示多少项 ​

slot插槽 和 render ​

自定义样式 ​

自定义全部标签和内容(数据全由后端返回) ​

other ​

API ​

ItemOptions ​

插槽 ​

透传属性 ​