Skip to content

Divider 分割线

xy-divider 提供 direction / content-position / border-style 这组核心配置,同时补了 sizestatus。它适合做轻量分段,而不是代替卡片、折叠面板这类更重的容器结构。

基础用法

最常见的场景是把两段正文、两组说明或者卡片内的不同小节切开,让页面阅读节奏更清楚。

基础用法内容分隔

分割线用于划分内容区域,帮助用户理解信息的层次结构。

发版前检查

确认版本号、变更记录和审批单已经同步到本周发布计划。

发版后回收

发布完成后补齐回归记录、异常结论和负责人同步,避免信息留在聊天窗口里。

内容位置

带默认插槽时可以把说明放在左、中、右,适合用来表达阶段名、字段组标题或当前语义标签。

线型样式

border-style 直接透传 CSS 的边框线型,除了 solid,常用的 dashed / dotted / double 也都能直接用。

状态语义

如果当前分割线需要参与页面语义表达,可以通过 status 让线条和文字一起带上强调色。

尺寸体系

xy-divider 会跟随全局 size,也可以局部覆盖为 sm / md / lg。尺寸主要影响间距、文字字号和竖向分割的留白。

竖向分割

direction='vertical' 适合切分操作栏、面包屑附加信息和行内状态。竖向模式下不会渲染默认插槽内容。

草稿最近保存于 10:24查看草稿历史提交审批

真实场景

这里的重点不是“加一根线”,而是用 Divider 把发布摘要拆成几个更容易扫读的段落。横向分割更适合章节式分段,竖向分割更适合切开元信息和轻操作;如果你已经需要明显容器边界,优先考虑 Card、Collapse 或 Drawer,而不是继续堆更多 Divider。

版本发布摘要

用 Divider 把发布信息切成可扫读的小节,让风险、范围和动作都各归其位。

发布中
版本号 v2.8.0负责人 李响窗口 20:00 - 21:00环境 生产灰度 20%
用户侧

统一消息入口、通知筛选与站内信聚合,减少重复跳转和入口分散。

管理端

审批列表筛选重构,补齐结果态和抽屉内联动作,统一后台操作节奏。

监控侧

新增发布后 30 分钟的异常聚合看板,重点追踪审批链路和消息去重命中率。

灰度观察点

首批灰度用户集中在审批量较高的团队,若 10 分钟内错误率上升,需要回退消息聚合策略。

灰度期间建议保留旧入口兜底,并在客服后台同步常见问题口径,避免前台入口切换造成误判。

已完成数据库变更脚本已在预发布环境回放通过。
待观察消息去重策略需盯 30 分钟,确认重复通知没有明显反弹。
已同步运营、客服和值班同学已收到发布窗口与回退预案。

何时使用

  • 需要把一块连续内容拆成几个更容易扫读的小节时。
  • 需要在一排轻操作、状态信息之间建立视觉边界,但又不希望容器感太重时。
  • 需要在表单说明、卡片摘要或抽屉内容里做"轻量分组",而不是再套一层卡片或折叠面板时。

何时不使用

  • 需要明确的内容容器边界时,优先使用 xy-card
  • 需要可折叠展开的内容分组时,优先使用 xy-collapse
  • 需要步骤式流程分段时,优先使用 xy-steps
  • 需要页签式内容切换时,优先使用 xy-tabs

最佳实践

横向 vs 竖向

方向适用场景
horizontal章节分段、表单字段组、说明区块收尾
vertical操作栏内分隔、面包屑附加信息、行内状态切割

带文字分割线

当分割线需要表达分组标题时,配合默认插槽和 content-position 使用:

vue
<xy-divider content-position="left">基本信息</xy-divider>
<xy-divider content-position="center">操作记录</xy-divider>
<xy-divider content-position="right">关联数据</xy-divider>

行为约定

  • 默认插槽只在 direction='horizontal' 时展示,竖向分割线只承担“切开内容”的作用。
  • 横向 Divider 更适合章节标题、说明区块和动作区收尾;竖向 Divider 更适合一行内的元信息、状态和轻操作切割。
  • size 会影响留白节奏和文字大小,不会改变 API 语义。
  • status 更适合表达当前区块的语义重点;如果只是普通分组,推荐保留默认 neutral
  • Divider 适合轻量分组,不替代 Card、Collapse、Drawer 这类本身就承担结构层级的重容器。

Divider API

Divider Attributes

属性说明类型默认值
direction分割线方向DividerDirection'horizontal'
content-position默认插槽内容的位置DividerContentPosition'center'
border-style分割线样式,兼容 CSS border-styleDividerBorderStyle'solid'
size组件尺寸,未传时跟随全局配置DividerProps["size"]全局 size / 'md'
status分割线语义色DividerProps["status"]'neutral'

Divider Slots

插槽说明
default分割线上的自定义内容,仅在横向模式下渲染

Divider CSS Variables

变量名说明默认值
--xy-divider-border-style分割线样式solid
--xy-divider-thickness线条粗细1px
--xy-divider-spacing横向分割的上下留白24px
--xy-divider-color分割线颜色color-mix(in srgb, var(--xy-border-strong) 72%, white)
--xy-divider-text-color插槽文字颜色var(--xy-text-secondary)
--xy-divider-font-size插槽文字字号var(--xy-font-size-md)
--xy-divider-text-padding插槽文字两侧留白18px
--xy-divider-content-offset左右定位时的边距24px
--xy-divider-vertical-gap竖向分割与两侧内容的间距12px
--xy-divider-vertical-height竖向分割线高度1em