Skip to content

Divider

Used to separate content into multiple areas.

Component Type

Basic Usage

Default renders a horizontal divider line.

html
<wd-divider />

Display Text

Use default slot to insert content in the middle of the divider.

html
<wd-divider>Display Text</wd-divider>

Component Variant

Content Position

Specify content position through content-position.

html
<wd-divider>Center</wd-divider>
<wd-divider content-position="left">Left</wd-divider>
<wd-divider content-position="right">Right</wd-divider>

Dashed Line

Add dashed to render divider as dashed line.

html
<wd-divider dashed>Dashed Divider</wd-divider>

Component Style

Custom Render Content

Use default slot to render custom content.

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

Custom Color

Set color to customize divider color.

html
<wd-divider color="#4D80F0">Custom Color</wd-divider>

Special Style

Vertical Divider

Add vertical to render divider as vertical direction, default slot does not take effect in vertical mode.

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

Attributes

ParameterDescriptionTypeDefault Value
colorCustom color, supports all valid color valuesstring-
content-position v1.5.0Content position, optional values are left, center, rightDividerPosition'center'
dashed v1.5.0Whether to display as dashed linebooleanfalse
vertical v1.5.0Whether to display as vertical dividerbooleanfalse
hairline v1.5.0Whether to display as 0.5px thin linebooleantrue
custom-classRoot node custom class namestring''
custom-styleRoot node custom stylestring''

Slots

NameDescriptionParameters
defaultDivider content, only takes effect when vertical is false-

External Style Classes

Class NameDescription
custom-classRoot node style 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默认内边距

Source Code

Documentation
Component

Released under the MIT License.

Released under the MIT License.