Toolbar
ボタンやトグルなどのコントロールが並び、タブストップが1つの行。
ToolbarはToolbar WAI-ARIAデザインパターンに準拠しています。
import { $, component$, type PropsOf, Slot, sync$, useSignal, useStyles$ } from '@builder.io/qwik';
import { ToggleGroup } from '@leve-ui/toggle-group';
import { Toolbar } from '@leve-ui/toolbar';
import {
LuAlignCenter,
LuAlignLeft,
LuAlignRight,
LuBold,
LuItalic,
LuUnderline,
} from '@qwikest/icons/lucide';
import styles from './default.css?inline';
// Example of a router link component (such as Qwik City's <Link>) that spreads received props onto <a>
const ClientLink = component$<PropsOf<'a'>>(({ onClick$, ...props }) => {
const visited = useSignal(false);
const preventDefault$ = sync$((event: MouseEvent) => {
event.preventDefault();
});
const handleClick$ = $(() => {
visited.value = true;
});
return (
<a
{...props}
data-visited={visited.value ? 'true' : undefined}
onClick$={[preventDefault$, handleClick$, onClick$]}
>
<Slot />
</a>
);
});
export default component$(() => {
useStyles$(styles);
return (
<Toolbar.Root aria-label="Formatting" class="toolbar-default">
{/* Toggle Group items inside a Toolbar join its arrow-key navigation */}
<ToggleGroup.Root type="multiple" aria-label="Text style" class="toolbar-default-group">
<ToggleGroup.Item value="bold" aria-label="Bold" class="toolbar-default-item">
<LuBold class="toolbar-default-icon" aria-hidden="true" />
</ToggleGroup.Item>
<ToggleGroup.Item value="italic" aria-label="Italic" class="toolbar-default-item">
<LuItalic class="toolbar-default-icon" aria-hidden="true" />
</ToggleGroup.Item>
<ToggleGroup.Item value="underline" aria-label="Underline" class="toolbar-default-item">
<LuUnderline class="toolbar-default-icon" aria-hidden="true" />
</ToggleGroup.Item>
</ToggleGroup.Root>
<Toolbar.Separator class="toolbar-default-separator" />
<ToggleGroup.Root
defaultValue={['left']}
aria-label="Text alignment"
class="toolbar-default-group"
>
<ToggleGroup.Item value="left" aria-label="Align left" class="toolbar-default-item">
<LuAlignLeft class="toolbar-default-icon" aria-hidden="true" />
</ToggleGroup.Item>
<ToggleGroup.Item value="center" aria-label="Align center" class="toolbar-default-item">
<LuAlignCenter class="toolbar-default-icon" aria-hidden="true" />
</ToggleGroup.Item>
<ToggleGroup.Item value="right" aria-label="Align right" class="toolbar-default-item">
<LuAlignRight class="toolbar-default-icon" aria-hidden="true" />
</ToggleGroup.Item>
</ToggleGroup.Root>
<Toolbar.Separator class="toolbar-default-separator" />
<Toolbar.Link as={ClientLink} href="/history" class="toolbar-default-link">
Edited 5 minutes ago
</Toolbar.Link>
<Toolbar.Button class="toolbar-default-button">Share</Toolbar.Button>
</Toolbar.Root>
);
});.toolbar-default {
display: flex;
align-items: center;
gap: 6px;
padding: 6px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
font-family: inherit;
}
.toolbar-default-group {
display: inline-flex;
gap: 2px;
}
.toolbar-default-item {
display: inline-flex;
align-items: center;
justify-content: center;
width: 30px;
height: 30px;
border: none;
border-radius: 6px;
background: transparent;
color: light-dark(#475569, #c9ddf0);
cursor: pointer;
}
.toolbar-default-item:hover {
background: light-dark(#f1f5f9, #ffffff14);
color: light-dark(#0f172a, #ffffff);
}
/* Pressed */
.toolbar-default-item[data-state="on"] {
background: light-dark(#f1f5f9, #ffffff14);
color: #009dfd;
}
.toolbar-default-icon {
width: 16px;
height: 16px;
}
/* A vertical line between groups; the Toolbar sets data-orientation="vertical" on it */
.toolbar-default-separator[data-orientation="vertical"] {
align-self: stretch;
width: 1px;
margin: 2px 4px;
background: light-dark(#cbd5e1, #ffffff3d);
}
.toolbar-default-link {
margin-left: auto;
padding: 0 4px;
font-size: 13px;
color: light-dark(#475569, #c9ddf0);
text-decoration: none;
}
.toolbar-default-link:hover {
text-decoration: underline;
}
.toolbar-default-button {
padding: 6px 12px;
border: none;
border-radius: 6px;
background: #009dfd;
font: inherit;
font-size: 13px;
font-weight: 500;
color: #ffffff;
cursor: pointer;
}
.toolbar-default-button:hover {
background: #006ce9;
}
.toolbar-default-item:focus-visible,
.toolbar-default-link:focus-visible,
.toolbar-default-button:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}インストール#
個別のパッケージをインストールするか、@leve-ui/coreを使用してすべてのコンポーネントを一度に取得します。
pnpm add @leve-ui/toolbarnpm install @leve-ui/toolbaryarn add @leve-ui/toolbarbun add @leve-ui/toolbarpnpm add @leve-ui/corenpm install @leve-ui/coreyarn add @leve-ui/corebun add @leve-ui/core構造#
import { Toolbar } from '@leve-ui/toolbar'; // or '@leve-ui/core'
<Toolbar.Root>
<Toolbar.Button />
<Toolbar.Separator />
<Toolbar.Link />
</Toolbar.Root>
| パーツ | 要素 | 説明 |
|---|---|---|
Toolbar.Root | <div> | ツールバー。アイテム間でフォーカスを移動します。 |
Toolbar.Button | <button> | Toolbar内のボタンです。別の要素やコンポーネントをレンダリングするにはasを使用します。 |
Toolbar.Link | <a> | Toolbar内のリンクです。別の要素やルーターリンクコンポーネントをレンダリングするにはasを使用します。 |
Toolbar.Separator | <div> | アイテムのグループ間の区切り線。 |
Toolbar.ButtonまたはToolbar.Linkのasに渡すコンポーネントは、id、tabIndex、aria-*、data-*、およびon*$イベントハンドラーを含め、受け取ったpropsを単一の要素にスプレッドする必要があります。
Toolbar内に配置されたToggleおよびToggle Groupのアイテムは、自動的にツールバーアイテムになります。矢印キーでそれらすべてを移動できるようになり、Toggle Group自体は矢印キーの処理を行わなくなります。
例#
垂直方向#
orientation="vertical"はアイテムを垂直に並べるため、上矢印キーと下矢印キーでフォーカスが移動します。セパレーターは水平になります。無効化されたアイテムはスキップされ、ツールバー内のToggleもこれに参加します。
import { component$, type PropsOf, Slot, useStyles$ } from '@builder.io/qwik';
import { Toggle } from '@leve-ui/toggle';
import { Toolbar } from '@leve-ui/toolbar';
import { LuGrid3X3, LuRedo2, LuUndo2 } from '@qwikest/icons/lucide';
import styles from './vertical.css?inline';
// Custom button component passed via `as` must spread received props onto one element
const IconButton = component$<PropsOf<'button'>>(({ type = 'button', ...props }) => (
<button type={type} {...props}>
<Slot />
</button>
));
export default component$(() => {
useStyles$(styles);
return (
<Toolbar.Root orientation="vertical" aria-label="Canvas" class="toolbar-vertical">
<Toolbar.Button as={IconButton} aria-label="Undo" class="toolbar-vertical-item">
<LuUndo2 class="toolbar-vertical-icon" aria-hidden="true" />
</Toolbar.Button>
<Toolbar.Button aria-label="Redo" disabled class="toolbar-vertical-item">
<LuRedo2 class="toolbar-vertical-icon" aria-hidden="true" />
</Toolbar.Button>
<Toolbar.Separator class="toolbar-vertical-separator" />
{/* A Toggle inside a Toolbar joins its arrow-key navigation */}
<Toggle.Root aria-label="Show grid" class="toolbar-vertical-item">
<LuGrid3X3 class="toolbar-vertical-icon" aria-hidden="true" />
</Toggle.Root>
</Toolbar.Root>
);
});.toolbar-vertical {
display: inline-flex;
flex-direction: column;
align-items: center;
gap: 4px;
padding: 6px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
font-family: inherit;
}
.toolbar-vertical-item {
display: inline-flex;
align-items: center;
justify-content: center;
width: 32px;
height: 32px;
border: none;
border-radius: 6px;
background: transparent;
color: light-dark(#475569, #c9ddf0);
cursor: pointer;
}
.toolbar-vertical-item:hover:not(:disabled) {
background: light-dark(#f1f5f9, #ffffff14);
color: light-dark(#0f172a, #ffffff);
}
/* Pressed Toggle */
.toolbar-vertical-item[data-state="on"] {
background: light-dark(#f1f5f9, #ffffff14);
color: #009dfd;
}
.toolbar-vertical-item:disabled {
opacity: 0.5;
cursor: not-allowed;
}
.toolbar-vertical-item:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}
.toolbar-vertical-icon {
width: 16px;
height: 16px;
}
/* A horizontal line in a vertical toolbar */
.toolbar-vertical-separator[data-orientation="horizontal"] {
align-self: stretch;
height: 1px;
margin: 2px 4px;
background: light-dark(#cbd5e1, #ffffff3d);
}APIリファレンス#
Root#
| Prop | デフォルト | 型 |
|---|---|---|
| orientation | 'horizontal' | 'horizontal' | 'vertical' フォーカスを移動する矢印キーを決定するツールバーの向き。 |
| loop | true | boolean 矢印キーで最後の項目から最初の項目へ、またはその逆にラップするかどうか。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-toolbar | 常に存在 |
data-orientation | "horizontal" | "vertical" |
Button#
| Prop | デフォルト | 型 |
|---|---|---|
| as | 'button' | keyof HTMLElementTagNameMap | Component<any>
|
すべての<button>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-toolbar-button | 常に存在 |
data-leve-toolbar-item | 常に存在(Toolbar内のToggleおよびToggle Groupアイテムにも存在) |
data-disabled | 無効時に存在 |
Link#
| Prop | デフォルト | 型 |
|---|---|---|
| as | 'a' | keyof HTMLElementTagNameMap | Component<any>
|
すべての<a>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-toolbar-link | 常に存在 |
data-leve-toolbar-item | 常に存在 |
Separator#
独自のpropはありません。 すべての<div>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-toolbar-separator | 常に存在 |
data-orientation | 水平ツールバーでは"vertical"、垂直ツールバーでは"horizontal" |
アクセシビリティ#
Toolbar WAI-ARIAデザインパターンに準拠しています。
Toolbar.Rootはrole="toolbar"およびaria-orientationをレンダリングします。aria-labelまたはaria-labelledbyで名前を指定してください。- ツールバーのタブストップは1つです。最初に有効なアイテム、その後は最後にフォーカスされたアイテムになります。他のアイテムには
tabindex="-1"が付与されます。 Toolbar.Separatorは、ツールバーと直交するaria-orientationを持つrole="separator"をレンダリングします。- 無効化されたボタンはネイティブの
disabled属性を使用し、矢印キーによる移動ではスキップされます。 - アイコンのみのアイテムには
aria-labelを指定してください。
キーボード操作#
| キー | 説明 |
|---|---|
Tab | ツールバー内(最後にフォーカスされたアイテム)にフォーカスを移動するか、ツールバー外へ移動します。 |
ArrowRight / ArrowLeft | 水平ツールバーにおいて、次または前のアイテムにフォーカスを移動します。loopがtrueの場合は最初または最後へ循環します。 |
ArrowDown / ArrowUp | 垂直ツールバーにおいて、次または前のアイテムにフォーカスを移動します。loopがtrueの場合は最初または最後へ循環します。 |
Home / End | 最初または最後のアイテムにフォーカスを移動します。 |
Enter / Space | フォーカスされているアイテムをアクティブにします。 |