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>