返回知识库

界面与交互 · 内容与数据展示

描述列表Descriptions

以标签—值对呈现单个对象只读属性的详情组件;对齐、缺值占位、长值折行、敏感值掩码与响应式堆叠的状态长在行上。

订单详情:标签值对齐、缺值与复制都长在行上

亲手把这张「订单 #1024」描述表的 4 处缺陷逐个修好,切桌面/窄屏视图,再复制订单号——每一处变化都长在描述表的行上,不只靠底部说明。

第 0 步:这是「订单 #1024」的只读详情,初始有 4 处缺陷(标签错位、长值截断、缺值空白、手机明文)。 逐个点修正,看描述表每一行怎么变;切视图看响应式堆叠;最后复制订单号。

订单详情 · #1024待修正 4
订单号
#1024
收货地址
上海市静安区南京西路 1788 号恒隆广场 3 座 45 层
联系电话
138-9024-4821
发票信息
(空白)
备注
客户要求周末送达,请避开周一至周五的工作日
当前视图:桌面两列;对齐;折行
修正:
视图:

对照:还有 4 处未修(标签对齐、长值折行、缺值占位、手机掩码)。原因:未修时标签列宽错位、长值被截断、缺值空白、手机号明文,核对时要逐字猜。下一步:把剩余修正逐个打开,描述表每一行的状态会即时变化。

面板教会的知识点

把刚才操作里看到的现象命名为六条规则。

  • 标签—值是一对:dl/dt/dd 把字段名和当前值绑定;标签稳定命名,值贴近可读,这是描述列表区别于表格和列表的核心。
  • 对齐让配对可见:标签列宽统一后,眼睛沿一条竖线扫就能配对;错位时每行标签宽度不同,要逐行找值。
  • 缺值要有占位:未填用「—」,加载中、失败、无权限各用状态文案;留白会让人分不清「没有」还是「没加载」。
  • 长值优先折行:地址、备注等长文本默认折行而非截断,省略号只在确认可截断时使用,避免丢信息。
  • 敏感值默认掩码:手机号、证件号只露核对所需的末几位;掩码是只读展示态,不是把字段变成不可用。
  • 窄屏改单列堆叠:桌面两列对齐,窄屏改成标签在上、值在下的单列,不依赖横向滚动。

什么时候用描述列表

从「看一个对象的属性」判断,而不是看字段多不多。

适合

单个对象的只读属性核对——订单、成员、设备、合同详情;字段名稳定、值需要贴近可读、关键字段要可复制。

先别用

跨记录比较(→ 表格)、单项富内容逐条扫(→ 列表)、需要编辑(→ 表单)、按时间线阅读(→ 时间线)。

怎么用:从字段到窄屏的最短路径

一次到位的检查顺序。

  1. 定字段:列出标签和值的来源,标签用业务稳定名词,值来自只读数据,不内嵌编辑。
  2. 给占位与掩码:未填写「—」;加载/失败/无权限各自文案;敏感值默认掩码,查看是明确动作。
  3. 桌面对齐:标签列固定宽度对齐,长值默认折行;仅关键字段(订单号、ID)给复制入口。
  4. 窄屏堆叠:改单列,标签在上、值在下;不强迫横向滚动,复制与掩码规则保持一致。

正反例:同一个「订单详情」需求

只改一处关键判断——是否让状态长在物件上。

正例

标签列对齐、缺值显示「—」、手机号掩码、订单号可复制;窄屏自动堆叠。用户一眼配对、分清缺值、能存单号。

反例

标签错位、缺值留白、手机号全显、订单号不可复制;窄屏硬挤两列。用户逐行找值、猜缺值、手抄单号还看不全。

快速自测

设备详情页里某个字段显示空白,用户反馈分不清是没填还是没加载,最直接的改进是?

继续查证

术语的技术定义和行为以这些一手或权威资料为准。

下一步学

和本知识点经常一起出现的概念。