Divider - Semi Design Next

Demos

How to import

<script setup lang="ts">
    import { Divider } from '@fibrous/semi-ui-vue';
</script>

Basic Usage

水平实线

Semi Design 是一个设计系统。

它定义了一套中后台设计与前端基础组件。

水平虚线

Semi Design 是一个设计系统。

它定义了一套中后台设计与前端基础组件。

垂直实线

左

中

右

垂直虚线

左

中

右

Code

<script setup lang="ts">
    import { Divider } from '@fibrous/semi-ui-vue';
</script>

<template>
    <div>
        <h3>水平实线</h3>
        <span>Semi Design 是一个设计系统。</span>
        <Divider margin="12px" />
        <span>它定义了一套中后台设计与前端基础组件。</span>

        <h3 :style="{ marginTop: '40px' }">水平虚线</h3>
        <span>Semi Design 是一个设计系统。</span>
        <Divider dashed margin="12px" />
        <span>它定义了一套中后台设计与前端基础组件。</span>

        <h3 :style="{ marginTop: '40px' }">垂直实线</h3>

        <div>
            <span>左</span>
            <Divider layout="vertical" margin="12px" />
            <span>中</span>
            <Divider layout="vertical" margin="12px" />
            <span>右</span>
        </div>

        <h3 :style="{ marginTop: '40px' }">垂直虚线</h3>
        <div>
            <span>左</span>
            <Divider dashed layout="vertical" margin="12px" />
            <span>中</span>
            <Divider dashed layout="vertical" margin="12px" />
            <span>右</span>
        </div>
    </div>
</template>

With Children

The content of a horizontal divider is passed through the default slot; a vertical divider shows no content.

这是居左文字

这是居中文字

这是居右文字

Code

<script setup lang="ts">
    import { IconSemiLogo } from '@fibrous/semi-icons-vue';
    import { Divider } from '@fibrous/semi-ui-vue';
</script>

<template>
    <div>
        <Divider align="left" margin="12px">这是居左文字</Divider>

        <Divider align="center" margin="12px">这是居中文字</Divider>

        <Divider align="right" margin="12px">这是居右文字</Divider>

        <Divider margin="12px">
            <IconSemiLogo />
        </Divider>
    </div>
</template>

API Reference

Props

Property	Description	Type	Default
align	Alignment of the content: left, center or right.	`"left" \| "right" \| "center"`	`semiDefault("Divider", "align", "center")`
margin	Margin above and below the divider, or left and right when vertical. A number is in pixels.	`string \| number`	`semiGlobalDefault("Divider", "margin")`
dashed	Whether the line is dashed.	`boolean`	`semiGlobalDefault("Divider", "dashed")`
layout	Direction of the divider: horizontal or vertical.	`"vertical" \| "horizontal"`	`semiDefault("Divider", "layout", "horizontal")`

Events

Event	Description	Callback parameters
None

Slots

Slot	Description	Scope parameters
default	Content of a horizontal divider. A vertical divider shows no content.	`any`

Exposes

Name	Description	Type
None

class, style and native attributes passed as attrs land on the root element; the default separator role can be overridden with role.

Design Tokens

These are the component's internal Sass variables and cannot be overridden. To customize styles, override the --semi-* CSS variables (see the Design Token page) or write unlayered CSS rules.

Sass variable	Value	Usage
$spacing-divider_horizontal-marginLeft	0px	水平模式左间距
$spacing-divider_horizontal-marginRight	0px	水平模式右间距
$spacing-divider_horizontal-marginTop	1px	水平模式上间距
$spacing-divider_horizontal-marginBottom	1px	水平模式下间距
$spacing-divider_vertical-marginLeft	1px	垂直模式左间距
$spacing-divider_vertical-marginRight	1px	垂直模式右间距
$spacing-divider_vertical-marginTop	0px	垂直模式上间距
$spacing-divider_vertical-marginBottom	0px	垂直模式下间距
$spacing-divider_inner_text-paddingLeft	8px	内容为纯文字时内容左间距
$spacing-divider_inner_text-paddingRight	8px	内容为纯文字时内容右间距
$spacing-divider_inner_text-paddingTop	0px	内容为纯文字时内容上间距
$spacing-divider_inner_text-paddingBottom	0px	内容为纯文字时内容下间距
$width-divider_inner_text_left_line	40px	左对齐文字时左间距宽度
$width-divider_inner_text_right_line	40px	右对齐文字时右间距宽度
$width-divider-border	1px	分割线宽度
$height-divider_vertical	20px	垂直分割线高度
$color-divider_border-color	var(--semi-color-border)	分割线颜色
$color-divider_text-default	var(--semi-color-text-0)	标题颜色
$font-divider_text-weight	$font-weight-bold	分割线文字字重