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-positionContent position, optional values are left, center, rightDividerPosition'center'
dashedWhether to display as dashed linebooleanfalse
verticalWhether to display as vertical dividerbooleanfalse
hairlineWhether 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.