Skip to content

Divider 分割线

用于将内容分隔为多个区域。

组件类型

基本使用

默认渲染一条水平分割线。

html
<wd-divider />

展示文本

使用默认插槽在分割线中间插入内容。

html
<wd-divider>展示文本</wd-divider>

组件变体

内容位置

通过 content-position 指定内容所在位置。

html
<wd-divider>中间</wd-divider>
<wd-divider content-position="left">左侧</wd-divider>
<wd-divider content-position="right">右侧</wd-divider>

虚线

添加 dashed 使分割线渲染为虚线。

html
<wd-divider dashed>虚线分割</wd-divider>

组件样式

自定义渲染内容

使用默认插槽渲染自定义内容。

html
<wd-divider>
  <wd-icon name="down" size="20" />
</wd-divider>

自定义颜色

设置 color 自定义分割线颜色。

html
<wd-divider color="#4D80F0">自定义颜色</wd-divider>

特殊样式

垂直分割线

添加 vertical 使分割线渲染为垂直方向,垂直模式下默认插槽不生效。

html
<view class="content">
  文本
  <wd-divider vertical />
  文本
  <wd-divider vertical dashed />
  文本
  <wd-divider vertical :hairline="false" />
  文本
  <wd-divider vertical color="#1989fa" />
  文本
</view>
css
.content {
  padding: 12rpx 15px;
}

Attributes

参数说明类型默认值
color自定义颜色,支持所有合法颜色值string-
content-position v1.5.0内容位置,可选值为 leftcenterrightDividerPosition'center'
dashed v1.5.0是否显示为虚线booleanfalse
vertical v1.5.0是否显示为垂直分割线booleanfalse
hairline v1.5.0是否显示为 0.5px 细线booleantrue
custom-class根节点自定义类名string''
custom-style根节点自定义样式string''

Slots

名称说明参数
default分割线内容,仅在 verticalfalse 时生效-

外部样式类

类名说明
custom-class根节点样式类

主题定制

CSS 变量

组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 全局配置

名称默认值描述
--wot-divider-color-default$text-auxiliary默认文字颜色
--wot-divider-color-line$border-main分割线颜色
--wot-divider-padding$padding-zero $padding-extra-loose组件水平内边距
--wot-divider-margin$spacing-extra-loose $spacing-zero组件垂直外边距
--wot-divider-line-height$n-3分割线厚度
--wot-divider-size-line-height$typography-body-line--height-size-main内容文字行高
--wot-divider-size-vertical-height$spacing-extra-loose纵向分割线高度
--wot-divider-size-vertical-line-width$n-3纵向分割线宽度
--wot-divider-size-content-left-width10%左对齐模式左侧线段宽度
--wot-divider-size-content-right-width10%右对齐模式右侧线段宽度
--wot-divider-font-size-default$typography-body-size-main默认文字字号
--wot-divider-margin-default$spacing-extra-loose默认外边距
--wot-divider-margin-vertical-content$spacing-tight纵向模式内容间距
--wot-divider-margin-content-left$spacing-loose内容左侧间距
--wot-divider-margin-content-right$spacing-loose内容右侧间距
--wot-divider-padding-default$spacing-zero默认内边距

源代码

文档
组件

Released under the MIT License.

Released under the MIT License.