iter(g164): 描述列表支持竖排与标题操作区

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-26T08:04:47.351Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-26T08:09:26.855Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -1074,6 +1074,8 @@ segmented({ options: [{ value: 'day', label: '日' }, { value: 'week', label: '
 - bordered（默认 false）：boolean —— 表格形态（带分隔线与字段名底纹）；缺省 false 纯网格
 - size（默认 md）：'sm' | 'md' —— 尺寸档位；缺省 md
 - title：string —— 分组标题；缺省不渲染标题行
+- layout（默认 'horizontal'）：'horizontal' | 'vertical' —— 字段名位置：horizontal 在值左侧，vertical 在值上方（窄栏 / 长文本更耐读，配 bordered 时去掉标签区的分隔线）
+- extra（回调）：unknown —— 标题行右侧内容（如更新时间、刷新按钮）；仅在传了 title 时渲染
 
 示例：
 
@@ -1089,6 +1091,7 @@ descriptions({ title: '订单信息', column: 2, bordered: true, items: [{ label
 4. bordered: true 是表格形态（适合打印与密集信息），纯网格形态更轻，适合卡片内嵌
 5. 窄屏自动降为单列，无需在调用方写媒体查询
 6. 纯展示组件，无状态无回调：值变了由调用方重新渲染或传函数式 value
+7. 窄栏或长文本场景把 layout 设成 'vertical'：字段名落到值上方，bordered 形态会自动去掉标签右侧的分隔线与底纹；标题行要放操作就传 extra（数组可放多个节点）
 
 现场演示：apps/docs/demo.html#sec-descriptions