mirror of
https://github.com/shoelace-style/webawesome.git
synced 2026-01-12 12:09:26 +00:00
8121faa1d4
* keep header styles with repositioned description text * `animated-image` move description to component * code style * `avatar` add summary from docs * `badge` add summary from docs * `breadcrumb` add summary from docs * `button` add summary from docs * lead sentence is now part of the header * `button-group` add summary from docs * `card` add summary from docs * `checkbox` add summary from docs * `color-picker` add summary from docs * `details` add summary from docs * `dialog` add summary from docs * `divider` add summary from docs * `drawer` add summary from docs * `dropdown` add summary from docs * `format-bytes` add summary from docs * `format-date` add summary from docs * `format-number` add summary from docs * `icon` add summary from docs * `icon-button` add summary from docs * `image-comparer` add summary from docs * `include` add summary from docs * `input` add summary from docs * `menu` add summary from docs * `menu-item` add summary from docs * `menu-label` add summary from docs * `popup` add summary from docs * `progressbar` add summary from docs * `progress-ring` add summary from docs * `radio` add summary from docs * `radio-button` add summary from docs * `range` add summary from docs * `rating` add summary from docs * `relative-time` add summary from docs * `select` add summary from docs * `skeleton` add summary from docs * `spinner` add summary from docs * `split-panel` add summary from docs * `switch` add summary from docs * `tab-group` add summary from docs * `tag` add summary from docs * `textarea` add summary from docs * `tooltip` add summary from docs * `visually-hidden` add summary from docs * `animation` add summary from docs * `breadcrumb-item` add summary from docs * `mutation-observer` add summary from docs * `radio-group` add summary from docs * `resize-observer` add summary from docs * `tab` add summary from docs * `tab-panel` add summary from docs * `tree` add summary from docs * `tree-item` add summary from docs * remove `title` for further usage of `Sl` classnames in docs * revert: use markdown parser for component summary
136 lines
2.9 KiB
Markdown
136 lines
2.9 KiB
Markdown
# Divider
|
|
|
|
[component-header:sl-divider]
|
|
|
|
```html preview
|
|
<sl-divider></sl-divider>
|
|
```
|
|
|
|
```jsx react
|
|
import { SlDivider } from '@shoelace-style/shoelace/dist/react';
|
|
|
|
const App = () => <SlDivider />;
|
|
```
|
|
|
|
## Examples
|
|
|
|
### Width
|
|
|
|
Use the `--width` custom property to change the width of the divider.
|
|
|
|
```html preview
|
|
<sl-divider style="--width: 4px;"></sl-divider>
|
|
```
|
|
|
|
```jsx react
|
|
import { SlDivider } from '@shoelace-style/shoelace/dist/react';
|
|
|
|
const App = () => <SlDivider style={{ '--width': '4px' }} />;
|
|
```
|
|
|
|
### Color
|
|
|
|
Use the `--color` custom property to change the color of the divider.
|
|
|
|
```html preview
|
|
<sl-divider style="--color: tomato;"></sl-divider>
|
|
```
|
|
|
|
```jsx react
|
|
import { SlDivider } from '@shoelace-style/shoelace/dist/react';
|
|
|
|
const App = () => <SlDivider style={{ '--color': 'tomato' }} />;
|
|
```
|
|
|
|
### Spacing
|
|
|
|
Use the `--spacing` custom property to change the amount of space between the divider and it's neighboring elements.
|
|
|
|
```html preview
|
|
<div style="text-align: center;">
|
|
Above
|
|
<sl-divider style="--spacing: 2rem;"></sl-divider>
|
|
Below
|
|
</div>
|
|
```
|
|
|
|
```jsx react
|
|
import { SlDivider } from '@shoelace-style/shoelace/dist/react';
|
|
|
|
const App = () => (
|
|
<>
|
|
Above
|
|
<SlDivider style={{ '--spacing': '2rem' }} />
|
|
Below
|
|
</>
|
|
);
|
|
```
|
|
|
|
### Vertical
|
|
|
|
Add the `vertical` attribute to draw the divider in a vertical orientation. The divider will span the full height of its container. Vertical dividers work especially well inside of a flex container.
|
|
|
|
```html preview
|
|
<div style="display: flex; align-items: center; height: 2rem;">
|
|
First
|
|
<sl-divider vertical></sl-divider>
|
|
Middle
|
|
<sl-divider vertical></sl-divider>
|
|
Last
|
|
</div>
|
|
```
|
|
|
|
```jsx react
|
|
import { SlDivider } from '@shoelace-style/shoelace/dist/react';
|
|
|
|
const App = () => (
|
|
<div
|
|
style={{
|
|
display: 'flex',
|
|
alignItems: 'center',
|
|
height: '2rem'
|
|
}}
|
|
>
|
|
First
|
|
<SlDivider vertical />
|
|
Middle
|
|
<SlDivider vertical />
|
|
Last
|
|
</div>
|
|
);
|
|
```
|
|
|
|
### Menu Dividers
|
|
|
|
Use dividers in [menus](/components/menu) to visually group menu items.
|
|
|
|
```html preview
|
|
<sl-menu style="max-width: 200px;">
|
|
<sl-menu-item value="1">Option 1</sl-menu-item>
|
|
<sl-menu-item value="2">Option 2</sl-menu-item>
|
|
<sl-menu-item value="3">Option 3</sl-menu-item>
|
|
<sl-divider></sl-divider>
|
|
<sl-menu-item value="4">Option 4</sl-menu-item>
|
|
<sl-menu-item value="5">Option 5</sl-menu-item>
|
|
<sl-menu-item value="6">Option 6</sl-menu-item>
|
|
</sl-menu>
|
|
```
|
|
|
|
```jsx react
|
|
import { SlDivider, SlMenu, SlMenuItem } from '@shoelace-style/shoelace/dist/react';
|
|
|
|
const App = () => (
|
|
<SlMenu style={{ maxWidth: '200px' }}>
|
|
<SlMenuItem value="1">Option 1</SlMenuItem>
|
|
<SlMenuItem value="2">Option 2</SlMenuItem>
|
|
<SlMenuItem value="3">Option 3</SlMenuItem>
|
|
<sl-divider />
|
|
<SlMenuItem value="4">Option 4</SlMenuItem>
|
|
<SlMenuItem value="5">Option 5</SlMenuItem>
|
|
<SlMenuItem value="6">Option 6</SlMenuItem>
|
|
</SlMenu>
|
|
);
|
|
```
|
|
|
|
[component-metadata:sl-divider]
|