Separator
コンテンツを区切る線です。
静的なセパレーター向けのWAI-ARIA APGパターンはありません。<hr>は垂直方向を表現できないため、Separatorはseparatorロールを持つ<div>をレンダリングします。
leve-ui
Headless UI for Qwik.
DocsGitHubnpm
import { component$, useStyles$ } from '@builder.io/qwik';
import { Separator } from '@leve-ui/separator';
import styles from './default.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<div class="separator-default-card">
<p class="separator-default-title">leve-ui</p>
<p class="separator-default-text">Headless UI for Qwik.</p>
<Separator.Root class="separator-default" />
<div class="separator-default-links">
<span>Docs</span>
<span>GitHub</span>
<span>npm</span>
</div>
</div>
);
});.separator-default-card {
width: 240px;
font-family: inherit;
}
.separator-default-title {
margin: 0;
font-size: 14px;
font-weight: 600;
color: light-dark(#0f172a, #ffffff);
}
.separator-default-text {
margin: 0;
font-size: 13px;
color: light-dark(#475569, #c9ddf0);
}
.separator-default {
height: 1px;
margin: 12px 0;
background: light-dark(#e2e8f0, #ffffff1f);
}
.separator-default-links {
display: flex;
gap: 12px;
font-size: 13px;
color: light-dark(#0f172a, #ffffff);
}インストール#
個別のパッケージをインストールするか、@leve-ui/coreを使用してすべてのコンポーネントを一度に取得します。
pnpm add @leve-ui/separatornpm install @leve-ui/separatoryarn add @leve-ui/separatorbun add @leve-ui/separatorpnpm add @leve-ui/corenpm install @leve-ui/coreyarn add @leve-ui/corebun add @leve-ui/core構造#
import { Separator } from '@leve-ui/separator'; // or '@leve-ui/core'
<Separator.Root />
| パーツ | 要素 | 説明 |
|---|---|---|
Separator.Root | <div> | セパレーター。子要素を持ちません。 |
例#
装飾用#
decorativeはrole="none"を使用して純粋に視覚的なセパレーターを支援技術から隠します。
leve-ui
Headless UI for Qwik.
DocsGitHubnpm
import { component$, useStyles$ } from '@builder.io/qwik';
import { Separator } from '@leve-ui/separator';
import styles from './decorative.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<div class="separator-decorative-card">
<p class="separator-decorative-title">leve-ui</p>
<p class="separator-decorative-text">Headless UI for Qwik.</p>
{/* Purely visual: hidden from assistive technology */}
<Separator.Root decorative class="separator-decorative" />
<div class="separator-decorative-links">
<span>Docs</span>
<span>GitHub</span>
<span>npm</span>
</div>
</div>
);
});.separator-decorative-card {
width: 240px;
font-family: inherit;
}
.separator-decorative-title {
margin: 0;
font-size: 14px;
font-weight: 600;
color: light-dark(#0f172a, #ffffff);
}
.separator-decorative-text {
margin: 0;
font-size: 13px;
color: light-dark(#475569, #c9ddf0);
}
.separator-decorative {
height: 1px;
margin: 12px 0;
background: light-dark(#e2e8f0, #ffffff1f);
}
.separator-decorative-links {
display: flex;
gap: 12px;
font-size: 13px;
color: light-dark(#0f172a, #ffffff);
}垂直方向#
orientation="vertical"は行内のアイテムを区切ります。
DocsGitHub
import { component$, useStyles$ } from '@builder.io/qwik';
import { Separator } from '@leve-ui/separator';
import styles from './vertical.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<div class="separator-vertical-row">
<span>Docs</span>
<Separator.Root orientation="vertical" class="separator-vertical" />
<span>GitHub</span>
</div>
);
});.separator-vertical-row {
display: flex;
align-items: center;
gap: 12px;
font-family: inherit;
font-size: 13px;
color: light-dark(#0f172a, #ffffff);
}
.separator-vertical {
width: 1px;
height: 16px;
align-self: center;
background: light-dark(#e2e8f0, #ffffff1f);
}APIリファレンス#
Root#
| Prop | デフォルト | 型 |
|---|---|---|
| orientation | 'horizontal' | 'horizontal' | 'vertical' セパレーターの向き。 |
| decorative | false | boolean セパレーターを支援技術から非表示にします( |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-separator | 常に存在 |
data-orientation | "horizontal" | "vertical" |
decorativeが設定されている場合でもdata-orientationはレンダリングされるため、両方で同じスタイルが機能します。
アクセシビリティ#
Separator.Rootはrole="separator"をレンダリングし、垂直方向の場合はaria-orientation="vertical"をレンダリングします。水平方向がこのロールのデフォルトであるため、aria-orientationはレンダリングされません。decorativeを指定するとrole="none"をレンダリングし、aria-orientationはレンダリングしません。セパレーターが意味のあるセクションを分割しない場合に使用します。- Separatorはフォーカス不可であり、キーボード操作はありません。