Skip to content

Divider 分割线

分割线组件用于在不同内容区域之间创建清晰的视觉分隔,支持水平和垂直两种方向,可自定义样式和文字内容。

基础用法

最简单的分割线用法,默认为水平方向的实线分割线。

上方内容区域

中间内容区域

下方内容区域

带文字的分割线

在水平分割线中添加文字内容,用于更清晰地标识不同区域的用途。

用户信息

姓名、邮箱等基本信息

账户设置

安全设置

密码、二次验证等安全选项

通知偏好

消息通知

邮件、短信等通知设置

文字位置

通过 content-position 属性控制分割线文字的对齐方式,支持左对齐、居中和右对齐三种位置。

📋 任务列表
🔥 紧急任务

修复生产环境Bug

📅 今日计划

完成功能开发

💡 想法记录

优化用户体验

垂直分割线

设置 direction="vertical" 创建垂直分割线,常用于导航菜单、工具栏等水平布局中的元素分隔。

边框样式

通过 border-style 属性自定义分割线的样式,支持实线、虚线和点线三种样式,适用于不同的设计需求。

📄 正式文档

使用实线分割线表示正式的内容分隔

实线分割线

📝 草稿内容

使用虚线分割线表示临时或草稿状态

虚线分割线

💡 提示信息

使用点线分割线表示轻量级的内容分隔

点线分割线

不同样式适用于不同的内容层级和重要程度

自定义颜色

使用 border-color 属性自定义分割线颜色,可以根据不同的内容主题或状态使用相应的颜色。

🎨 设计系统

使用品牌色彩增强视觉层次

默认颜色

💼 商务信息

专业、可信赖的蓝色主题

品牌蓝

✅ 成功状态

表示成功、完成或正确的绿色

成功绿

⚠️ 警告提示

用于错误、警告或重要提醒

警告红

💡 注意事项

提醒用户注意的黄色主题

提醒黄

组合使用

分割线的各种属性可以灵活组合,创造出符合特定设计需求的分割效果。

🎨 创意工作流

展示不同阶段的创意过程

💡 灵感收集

收集和整理创意想法,建立灵感库

🛠️ 设计开发

将想法转化为具体的设计方案

🚀 发布上线

完成测试并正式发布产品

实际应用场景

分割线在实际项目中的常见应用场景展示。

🏠 首页
📦 产品中心
💻 软件开发
UI组件库
👤

张三

高级前端工程师

📧 联系方式

📧 zhangsan@example.com

📱 +86 138 0013 8000

🏢 工作信息

🏢 阿里巴巴集团

📍 杭州市余杭区

API

Divider Props

属性名类型默认值说明可选值
directionstring'horizontal'分割线方向horizontal / vertical
border-stylestring'solid'边框样式solid / dashed / dotted
content-positionstring'center'文字位置(仅水平方向有效)left / center / right
border-colorstring自定义边框颜色任意有效的CSS颜色值

Divider Slots

插槽名说明参数
default分割线文字内容(仅水平方向有效)

使用示例

vue
<!-- 基础用法 -->
<vk-divider />

<!-- 带文字的水平分割线 -->
<vk-divider>分割线文字</vk-divider>

<!-- 垂直分割线 -->
<vk-divider direction="vertical" />

<!-- 自定义样式 -->
<vk-divider content-position="left" border-style="dashed" border-color="#1890ff">
  自定义分割线
</vk-divider>

设计指南

何时使用

  • 对不同章节的文本段落进行分割
  • 对行内文字/链接进行分割,例如表格的操作列
  • 对不同区块的内容进行分割

使用建议

  • 水平分割线:用于分隔不同的内容区域,可以添加文字说明
  • 垂直分割线:用于分隔水平排列的元素,如导航菜单、操作按钮等
  • 样式选择:实线用于正式分隔,虚线用于临时或草稿状态,点线用于轻量级分隔
  • 颜色使用:可以根据内容主题或状态使用相应的颜色,增强视觉层次

无障碍性

  • 分割线具有适当的语义化标记
  • 支持屏幕阅读器识别
  • 颜色对比度符合WCAG标准

样式变量

组件提供了以下 CSS 变量用于自定义样式:

变量名默认值说明
--vk-divider-margin16px 0水平分割线的外边距
--vk-divider-text-padding0 16px分割线文字的内边距
--vk-divider-border-colorvar(--vk-border-color)分割线的颜色
--vk-divider-text-colorvar(--vk-text-color-regular)分割线文字的颜色

基于 MIT 协议发布