---
url: /components/detail-descriptions.md
---
# DetailDescriptions 详情描述

items 配置式的详情描述：值从 `data` 对象自动取（支持 `'a.b'` 路径），支持 formatter 与按名分发插槽，基于 EbDescriptions 渲染。

取值规则：

* `prop` 支持点路径（如 `user.name`），中间为 null/undefined 时安全返回 undefined；
* 没有配置 `formatter` 与 `slot` 时，值为 null/undefined 显示 `placeholder`（缺省 `-`），其余按原值输出；注意空字符串不算空值，会原样显示为空白；
* `formatter: (value, data) => string` 的第二个参数是整个 `data` 对象，可做跨字段计算。

## 基础用法

## 插槽自定义

`item.slot` 指定插槽名，作用域携带 `{ item, value }`，适合渲染状态标签、链接、操作按钮等富内容；未命中的字段继续走默认文本渲染。

## 空值与格式化

`remark` 为 null 时显示 `placeholder`；时间戳经 formatter 转为可读文本；`border: false` 切换为无边框模式。

## 标题扩展区与跨列

`extra` 插槽渲染在标题行右侧，常放编辑按钮；`span` 让字段占据多列，适合备注类长文本。

## API

本组件无事件与实例方法，纯展示。