Divider

View Source

NOTE: Introduced feature in v0.2.0.

Divider is typically used to visually separate content for easier reading comprehension.

<script>
    import {Divider} from "@kahi-ui/framework";
</script>

<Divider />

Imports

<script>
    import {Divider} from "@kahi-ui/framework";
</script>

Palette

You can change the color palette of the Divider via the palette property.

<script>
    import {
        Divider,
        Mosaic,
        Text,
    } from "@kahi-ui/framework";
</script>

<Mosaic.Container sizing="medium" spacing="medium">
    <div>
        <Text is="strong">DEFAULT</Text>
        <Divider />
    </div>

    <div>
        <Text is="strong">ACCENT</Text>
        <Divider palette="accent" />
    </div>

    <div>
        <Text is="strong">NEUTRAL</Text>
        <Divider palette="neutral" />
    </div>

    <div>
        <Text is="strong">DARK</Text>
        <Divider palette="dark" />
    </div>

    <div>
        <Text is="strong">LIGHT</Text>
        <Divider palette="light" />
    </div>

    <div>
        <Text is="strong">ALERT</Text>
        <Divider palette="alert" />
    </div>

    <div>
        <Text is="strong">AFFIRMATIVE</Text>
        <Divider palette="affirmative" />
    </div>

    <div>
        <Text is="strong">INFORMATIVE</Text>
        <Divider palette="informative" />
    </div>

    <div>
        <Text is="strong">NEGATIVE</Text>
        <Divider palette="negative" />
    </div>
</Mosaic.Container>

Orientation

You can set the Divider to render vertically via the orientation property.

<script>
    import {
        Box,
        Divider,
        Mosaic,
        Stack,
        Text,
    } from "@kahi-ui/framework";
</script>

<Stack.Container
    class="divider-orientation"
    orientation="horizontal"
    spacing="medium"
    variation="wrap"
>
    <div>
        <Text is="strong">DEFAULT</Text>
        <Box palette="dark" padding="small">
            <Divider />
        </Box>
    </div>

    <div>
        <Text is="strong">VERTICAL</Text>
        <Box
            palette="dark"
            padding="small"
            width="content-min"
        >
            <Divider orientation="vertical" />
        </Box>
    </div>
</Stack.Container>

<style>
    :global(.divider-orientation
            > div:first-child
            > .box) {
        display: flex;
        align-items: center;
        height: 2rem;
        width: 6rem;
    }

    :global(.divider-orientation
            > div:last-child
            > .box) {
        height: 6rem;
    }
</style>

Text

Divider components can also render text within their separators via passing content into the default slot.

<script>
    import {
        Box,
        Divider,
        Mosaic,
        Stack,
        Text,
    } from "@kahi-ui/framework";
</script>

<Stack.Container
    class="divider-text"
    orientation="horizontal"
    spacing="medium"
    variation="wrap"
>
    <div>
        <Box palette="dark" padding="small">
            <Divider>DEFAULT</Divider>
        </Box>
    </div>

    <div>
        <Box palette="dark" padding="small">
            <Divider orientation="vertical">
                VERTICAL
            </Divider>
        </Box>
    </div>
</Stack.Container>

<style>
    :global(.divider-text > div:first-child > .box) {
        width: 12rem;
    }

    :global(.divider-text > div:last-child > .box) {
        display: flex;
        justify-content: center;

        width: 3rem;
        height: 12rem;
    }
</style>

Properties

Divider

Name Description Types
palette Alters the displayed color scheme.
auto inverse inherit accent neutral off dark light alert affirmative informative negative
orientation Renders the Divider vertically.
vertical {VIEWPORT}:vertical

Slots

Divider

Name Description Types
default Default unnamed slot. Renders the Divider as a text divider when provided.
{}