Descriptions 描述列表

以列表形式展示多个字段。

基础用法

User Info
UsernamekooriookamiTelephone18100000000PlaceSuzhou
RemarksSchoolAddress No.1188, Wuzhong Avenue, Wuzhong District, Suzhou, Jiangsu Province

尺寸

With border
Username
kooriookami
Telephone
18100000000
Place
Suzhou
Remarks
School
Address
No.1188, Wuzhong Avenue, Wuzhong District, Suzhou, Jiangsu Province
Without border
UsernamekooriookamiTelephone18100000000PlaceSuzhou
RemarksSchoolAddress No.1188, Wuzhong Avenue, Wuzhong District, Suzhou, Jiangsu Province

垂直列表

Vertical list with border
UsernameTelephonePlace
kooriookami18100000000Suzhou
RemarksAddress
School No.1188, Wuzhong Avenue, Wuzhong District, Suzhou, Jiangsu Province
Vertical list without border
UsernameTelephonePlace
kooriookami18100000000Suzhou
RemarksAddress
School No.1188, Wuzhong Avenue, Wuzhong District, Suzhou, Jiangsu Province

跨行

Width horizontal list
Photo
UsernamekooriookamiTelephone18100000000
PlaceSuzhouRemarksSchool
Address No.1188, Wuzhong Avenue, Wuzhong District, Suzhou, Jiangsu Province
Width vertical list
PhotoUsernameTelephone
kooriookami18100000000
PlaceRemarks
SuzhouSchool
Address
No.1188, Wuzhong Avenue, Wuzhong District, Suzhou, Jiangsu Province

自定义样式

Customized style list
Username kooriookami Telephone 18100000000 Place Suzhou
RemarksSchoolAddress No.1188, Wuzhong Avenue, Wuzhong District, Suzhou, Jiangsu Province

标签对齐

通过 label-align 属性可以单独控制每个描述项的标签(label)对齐方式,支持左对齐(left)和右对齐(right),适用于无边框和有边框两种模式。

使用 label-align="left" 设置标签左对齐(默认),label-align="right" 设置标签右对齐。在表单类场景中,右对齐可使标签与内容之间形成清晰的视觉分界线。

无边框模式 - 标签左对齐(默认)

用户信息
用户名张三
手机号138****8888
地址 江苏省苏州市吴中区吴中大道1188号

无边框模式 - 标签右对齐

用户信息
用户名张三
手机号138****8888
地址 江苏省苏州市吴中区吴中大道1188号

有边框模式 - 标签左/右对齐混合使用

订单详情
订单编号(标签右对齐)ORD-20240315-001
商品名称(标签左对齐)高端商务笔记本
收货地址(标签右对齐)江苏省苏州市吴中区吴中大道1188号
备注(标签左对齐)请尽快发货,谢谢

动态切换标签对齐方式

动态控制
操作
无边框
用户名张三
手机号138****8888
地址江苏省苏州市吴中区吴中大道1188号

文本省略

通过 text-ellipsis 属性可开启内容文本超出时的省略号显示效果;配合 text-ellipsis-width 可自定义触发省略的最大宽度。

使用 text-ellipsis 开启文本省略,text-ellipsis-width 设置截断宽度(单位 px)。适用于内容较长需要控制显示区域的场景。

开启文本省略(默认宽度截断)

用户信息
用户名张三
简介 这是一段很长的个人简介文字,当开启 text-ellipsis 后,超出容器宽度的内容将以省略号形式显示。

自定义省略宽度(通过 text-ellipsis-width 设置最大显示宽度)

订单详情
订单号ORD-20240315-001
商品描述 高端商务笔记本电脑,搭载最新一代处理器,16GB内存,512GB固态硬盘,2K高清屏幕,超长续航,适合办公与娱乐。

无边框模式下使用(同时展示不同宽度的省略效果)

项目信息
项目名称智能数据平台
项目概述 本项目旨在构建一套完整的企业级数据分析与管理平台,支持多维度数据可视化、实时监控预警、自动化报表生成等功能模块。
负责人李四

动态切换省略状态

动态控制
操作
动态内容 这是一段可动态控制的文本内容,你可以通过上方按钮开关省略功能,并通过数字输入框调整触发省略的最大宽度值。

描述列表 API

描述列表 属性

名称说明类型默认值
border是否带边框booleanfalse
column一行展示的 Descriptions Item 数量number3
direction排列方向enumhorizontal
size列表尺寸enum
title左上角标题文案string''
extra右上角额外区域文案string''
label-width标签统一宽度string / number

Descriptions 插槽

名称说明子标签
default自定义默认内容Descriptions Item
title自定义标题区域
extra自定义右上角

描述列表项 API

描述列表项 属性

名称说明类型默认值
label标签文本string''
span列占位( colspan )number1
rowspan跨行数number1
width列宽;同一列多行时取最大宽度(无 border 时宽度包含标签与内容)string / number''
min-width列最小宽度;设了 width 的列为固定宽,仅设 min-width 的列按比例分配(无 border 时宽度含标签与内容)string / number''
label-width当前项标签宽度;未设置时与同列一致;优先级高于 Descriptionslabel-widthstring / number
align内容对齐(无 border 时同时作用于标签与内容)enumleft
label-align标签对齐方式,支持左对齐(left)和右对齐(right);适用于无边框和有边框两种模式enum
class-name内容单元格自定义类名string''
label-class-name标签单元格自定义类名string''
text-ellipsis是否开启内容文本省略,超出宽度时显示省略号booleanfalse
text-ellipsis-width内容文本触发省略的最大宽度(需配合 text-ellipsis 使用),单位 pxstring / number''

描述列表项 插槽

名称说明
default自定义默认内容
label自定义标签