Menu
ボタンから開くアクションのリスト。
MenuはMenu Button WAI-ARIAデザインパターンに準拠しています。
import { $, component$, useSignal, useStyles$ } from '@builder.io/qwik';
import { Menu } from '@leve-ui/menu';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './default.css?inline';
export default component$(() => {
useStyles$(styles);
const last = useSignal('Nothing yet');
const select$ = $((action: string) => {
last.value = action;
});
return (
<div class="menu-default">
<Menu.Root>
<Menu.Trigger class="menu-default-trigger">
Actions
<LuChevronDown class="menu-default-chevron" aria-hidden="true" />
</Menu.Trigger>
<Menu.Content sideOffset={4} class="menu-default-content">
<Menu.Item onSelect$={() => select$('New file')} class="menu-default-item">
New file <span class="menu-default-shortcut">⌘N</span>
</Menu.Item>
<Menu.Item onSelect$={() => select$('Duplicate')} class="menu-default-item">
Duplicate <span class="menu-default-shortcut">⌘D</span>
</Menu.Item>
<Menu.Item disabled class="menu-default-item">
Paste <span class="menu-default-shortcut">⌘V</span>
</Menu.Item>
<Menu.Separator class="menu-default-separator" />
<Menu.Group>
<Menu.GroupLabel class="menu-default-label">Share</Menu.GroupLabel>
<Menu.Item onSelect$={() => select$('Copy link')} class="menu-default-item">
Copy link
</Menu.Item>
<Menu.Item onSelect$={() => select$('Email')} class="menu-default-item">
Email
</Menu.Item>
</Menu.Group>
</Menu.Content>
</Menu.Root>
<p class="menu-default-status">Last action: {last.value}</p>
</div>
);
});.menu-default {
display: flex;
align-items: center;
gap: 16px;
font-family: inherit;
}
.menu-default-trigger {
display: inline-flex;
align-items: center;
gap: 6px;
padding: 8px 12px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
cursor: pointer;
}
.menu-default-trigger:hover,
.menu-default-trigger[data-state="open"] {
background: light-dark(#f1f5f9, #ffffff14);
}
.menu-default-chevron {
width: 14px;
height: 14px;
}
/* The Content is a popover in the top layer; the library sets its position */
.menu-default-content {
box-sizing: border-box;
min-width: max(180px, var(--leve-menu-anchor-width));
padding: 4px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
color: light-dark(#0f172a, #ffffff);
font-family: inherit;
box-shadow: 0 8px 24px rgb(15 23 42 / 0.18);
}
.menu-default-content:focus-visible {
outline: none;
}
.menu-default-item {
display: flex;
align-items: center;
justify-content: space-between;
gap: 16px;
padding: 6px 8px;
border-radius: 4px;
font-size: 14px;
cursor: default;
outline: none;
}
/* The focused item: arrow keys, typeahead and the pointer move focus */
.menu-default-item:focus {
background: #009dfd;
color: #ffffff;
}
.menu-default-item[data-disabled] {
opacity: 0.5;
}
.menu-default-shortcut {
font-size: 12px;
opacity: 0.7;
}
.menu-default-label {
padding: 6px 8px 2px;
font-size: 12px;
font-weight: 600;
color: light-dark(#475569, #c9ddf0);
}
.menu-default-separator {
height: 1px;
margin: 4px 0;
background: light-dark(#e2e8f0, #ffffff1f);
}
.menu-default-status {
margin: 0;
font-size: 14px;
color: light-dark(#475569, #c9ddf0);
}
.menu-default-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}インストール#
個別のパッケージをインストールするか、@leve-ui/coreを使用してすべてのコンポーネントを一度に取得します。
pnpm add @leve-ui/corenpm install @leve-ui/coreyarn add @leve-ui/corebun add @leve-ui/core構造#
import { Menu } from '@leve-ui/menu'; // or '@leve-ui/core'
<Menu.Root>
<Menu.Trigger />
<Menu.Content>
<Menu.Item />
<Menu.Separator />
<Menu.Group>
<Menu.GroupLabel />
<Menu.Item />
</Menu.Group>
<Menu.CheckboxItem>
<Menu.ItemIndicator />
</Menu.CheckboxItem>
<Menu.RadioGroup>
<Menu.RadioItem>
<Menu.ItemIndicator />
</Menu.RadioItem>
</Menu.RadioGroup>
<Menu.Sub>
<Menu.SubTrigger />
<Menu.SubContent>
<Menu.Item />
</Menu.SubContent>
</Menu.Sub>
<Menu.Arrow />
</Menu.Content>
</Menu.Root>
| パーツ | 要素 | 説明 |
|---|---|---|
Menu.Root | <div> | 各パーツをラップし、開閉状態を保持します。 |
Menu.Trigger | <button> | メニューを開くボタン。asを使用して別の要素またはコンポーネントをレンダリングします。 |
Menu.Content | <div> | トップレイヤーにあるpopover="manual"要素のメニュー。 |
Menu.Item | <div> | アクション。asを使用して<a>、Qwik Cityの<Link>、または別のコンポーネントをレンダリングします。 |
Menu.Group | <div> | GroupLabelによって名前が付けられるアイテムのグループ。 |
Menu.GroupLabel | <div> | グループの名前。アイテムではありません。 |
Menu.CheckboxItem | <div> | オンまたはオフを切り替えるアイテム。 |
Menu.RadioGroup | <div> | いずれか1つが選択されるRadioItemのセット。 |
Menu.RadioItem | <div> | RadioGroupのアイテム。 |
Menu.ItemIndicator | <span> | 未選択時には非表示になる、CheckboxItemまたはRadioItemのチェックマーク。 |
Menu.Sub | <div> | サブメニューをラップし、その開閉状態を保持します。 |
Menu.SubTrigger | <div> | サブメニューを開くアイテム。 |
Menu.SubContent | <div> | SubTriggerの横に配置されるサブメニュー。 |
Menu.Separator | <div> | アイテム間の区切り線。 |
Menu.Arrow | <div> | 任意。CSSで描画される、Triggerを指す矢印。 |
別の要素またはコンポーネントをレンダリングするには、Menu.ItemまたはMenu.Triggerでasを使用します。asに渡されるコンポーネントは、id、aria-*、data-*、およびon*$イベントハンドラーを含む受け取ったpropsを単一の要素にスプレッドする必要があります。
例#
リンクアイテム#
Menu.Itemのasに<a>またはQwik Cityの<Link>などのルーターリンクコンポーネントを渡すことで、role="menuitem"、キーボードナビゲーション、およびメニューのクローズを維持しながらアイテムをナビゲートできます。
import {
$,
component$,
type PropsOf,
type QRL,
Slot,
sync$,
useSignal,
useStyles$,
} from '@builder.io/qwik';
import { Menu } from '@leve-ui/menu';
import { LuChevronDown } from '@qwikest/icons/lucide';
import styles from './links.css?inline';
type ClientLinkProps = PropsOf<'a'> & {
onNavigate$?: QRL<(href: string) => void>;
};
// Example of a router link component (such as Qwik City's <Link>) that spreads props onto <a>
const ClientLink = component$<ClientLinkProps>(({ onNavigate$, onClick$, ...props }) => {
const preventDefault$ = sync$((event: MouseEvent) => {
event.preventDefault();
});
const handleClick$ = $(() => {
if (props.href) {
onNavigate$?.(props.href);
}
});
return (
<a {...props} onClick$={[preventDefault$, handleClick$, onClick$]}>
<Slot />
</a>
);
});
export default component$(() => {
useStyles$(styles);
const visited = useSignal('None');
const navigate$ = $((href: string) => {
visited.value = href;
});
return (
<div class="menu-links">
<Menu.Root>
<Menu.Trigger class="menu-links-trigger">
Navigation
<LuChevronDown class="menu-links-chevron" aria-hidden="true" />
</Menu.Trigger>
<Menu.Content sideOffset={4} class="menu-links-content">
<Menu.Item as={ClientLink} href="/docs" onNavigate$={navigate$} class="menu-links-item">
Documentation
</Menu.Item>
<Menu.Item
as={ClientLink}
href="/components"
onNavigate$={navigate$}
class="menu-links-item"
>
Components
</Menu.Item>
<Menu.Item
as={ClientLink}
href="/changelog"
onNavigate$={navigate$}
class="menu-links-item"
>
Changelog
</Menu.Item>
</Menu.Content>
</Menu.Root>
<p class="menu-links-status">Navigated to: {visited.value}</p>
</div>
);
});.menu-links {
display: flex;
align-items: center;
gap: 16px;
font-family: inherit;
}
.menu-links-trigger {
display: inline-flex;
align-items: center;
gap: 6px;
padding: 8px 12px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
cursor: pointer;
}
.menu-links-trigger:hover,
.menu-links-trigger[data-state="open"] {
background: light-dark(#f1f5f9, #ffffff14);
}
.menu-links-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}
.menu-links-chevron {
width: 14px;
height: 14px;
}
/* The Content is a popover in the top layer; the library sets its position */
.menu-links-content {
box-sizing: border-box;
min-width: max(180px, var(--leve-menu-anchor-width));
padding: 4px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
color: light-dark(#0f172a, #ffffff);
font-family: inherit;
box-shadow: 0 8px 24px rgb(15 23 42 / 0.18);
}
.menu-links-content:focus-visible {
outline: none;
}
.menu-links-item {
display: flex;
align-items: center;
padding: 6px 8px;
border-radius: 4px;
font-size: 14px;
color: inherit;
text-decoration: none;
cursor: default;
outline: none;
}
/* The focused item: arrow keys, typeahead and the pointer move focus */
.menu-links-item:focus {
background: #009dfd;
color: #ffffff;
}
.menu-links-status {
margin: 0;
font-size: 14px;
color: light-dark(#475569, #c9ddf0);
}CheckboxおよびRadioアイテム#
Menu.CheckboxItemはオプションのオン・オフを切り替え、Menu.RadioItemはMenu.RadioGroupの値を1つ選択します。どちらも他のコントロールと同様にbind:シグナルを受け取ります。Spaceを押すとメニューを閉じずに切り替わり、クリックまたはEnterを押すと切り替えてメニューを閉じます。
import { component$, useSignal, useStyles$ } from '@builder.io/qwik';
import { Menu } from '@leve-ui/menu';
import { LuCheck, LuDot } from '@qwikest/icons/lucide';
import styles from './checkable.css?inline';
export default component$(() => {
useStyles$(styles);
const grid = useSignal(true);
const zoom = useSignal<string | null>('100');
return (
<div class="menu-checkable">
<Menu.Root>
<Menu.Trigger class="menu-checkable-trigger">View</Menu.Trigger>
<Menu.Content sideOffset={4} class="menu-checkable-content">
<Menu.CheckboxItem bind:checked={grid} class="menu-checkable-item">
<Menu.ItemIndicator class="menu-checkable-indicator">
<LuCheck class="menu-checkable-icon" />
</Menu.ItemIndicator>
Show grid
</Menu.CheckboxItem>
<Menu.CheckboxItem class="menu-checkable-item">
<Menu.ItemIndicator class="menu-checkable-indicator">
<LuCheck class="menu-checkable-icon" />
</Menu.ItemIndicator>
Show rulers
</Menu.CheckboxItem>
<Menu.Separator class="menu-checkable-separator" />
<Menu.Group>
<Menu.GroupLabel class="menu-checkable-label">Zoom</Menu.GroupLabel>
<Menu.RadioGroup bind:value={zoom}>
{['50', '100', '200'].map((value) => (
<Menu.RadioItem key={value} value={value} class="menu-checkable-item">
<Menu.ItemIndicator class="menu-checkable-indicator">
<LuDot class="menu-checkable-icon" />
</Menu.ItemIndicator>
{value}%
</Menu.RadioItem>
))}
</Menu.RadioGroup>
</Menu.Group>
</Menu.Content>
</Menu.Root>
<p class="menu-checkable-status">
Grid: {grid.value ? 'on' : 'off'}, zoom: {zoom.value}%
</p>
</div>
);
});.menu-checkable {
display: flex;
align-items: center;
gap: 16px;
font-family: inherit;
}
.menu-checkable-trigger {
display: inline-flex;
align-items: center;
gap: 6px;
padding: 8px 12px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
font: inherit;
font-size: 14px;
font-weight: 500;
color: light-dark(#0f172a, #ffffff);
cursor: pointer;
}
.menu-checkable-trigger:hover,
.menu-checkable-trigger[data-state="open"] {
background: light-dark(#f1f5f9, #ffffff14);
}
.menu-checkable-chevron {
width: 14px;
height: 14px;
}
/* The Content is a popover in the top layer; the library sets its position */
.menu-checkable-content {
box-sizing: border-box;
min-width: max(180px, var(--leve-menu-anchor-width));
padding: 4px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
color: light-dark(#0f172a, #ffffff);
font-family: inherit;
box-shadow: 0 8px 24px rgb(15 23 42 / 0.18);
}
.menu-checkable-content:focus-visible {
outline: none;
}
.menu-checkable-item {
display: flex;
align-items: center;
justify-content: space-between;
gap: 16px;
padding: 6px 8px;
border-radius: 4px;
font-size: 14px;
cursor: default;
outline: none;
}
/* The focused item: arrow keys, typeahead and the pointer move focus */
.menu-checkable-item:focus {
background: #009dfd;
color: #ffffff;
}
.menu-checkable-item[data-disabled] {
opacity: 0.5;
}
.menu-checkable-shortcut {
font-size: 12px;
opacity: 0.7;
}
.menu-checkable-label {
padding: 6px 8px 2px;
font-size: 12px;
font-weight: 600;
color: light-dark(#475569, #c9ddf0);
}
.menu-checkable-separator {
height: 1px;
margin: 4px 0;
background: light-dark(#e2e8f0, #ffffff1f);
}
.menu-checkable-status {
margin: 0;
font-size: 14px;
color: light-dark(#475569, #c9ddf0);
}
.menu-checkable-trigger:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}
/* The indicator keeps its space while hidden, so that the labels line up */
.menu-checkable-item {
justify-content: flex-start;
gap: 6px;
padding-left: 28px;
position: relative;
}
.menu-checkable-indicator {
position: absolute;
left: 8px;
display: inline-flex;
}
.menu-checkable-icon {
width: 14px;
height: 14px;
}サブメニュー#
Menu.Subはメニューをネストします。Menu.SubTrigger上でArrowRight、Enter、またはSpaceを押すとサブメニューが開き、その最初のアイテムにフォーカスが移動します。ArrowLeftとEscapeはサブメニューのみを閉じます。SubTriggerにホバーするとサブメニューが開き、フォーカスはSubTriggerにとどまります。サブメニュー内のアイテムを選択すると、メニュー全体が閉じます。
Context Menu#
Menu.ContextTriggerは、ボタンからではなく、右クリック、Shift + F10、または長押しによってポインターの位置にメニューを開きます。Context Menuを参照してください。
APIリファレンス#
Root#
| Prop | デフォルト | 型 |
|---|---|---|
| ids | – | { trigger?: string; content?: string } パーツの要素IDをオーバーライドします。 |
| defaultOpen | false | boolean 初期状態でメニューを開くかどうか(非制御)。ページのレジューム時に開きます。 |
| bind:open | – | Signal<boolean> 開閉状態を保持するシグナル(制御)。 |
| onOpenChange$ | – | QRL<(open: boolean) => void> ユーザーの操作によってメニューが開閉されたときに呼び出されます。 |
| loop | false | boolean 最後の項目でArrowDownを押したときに最初の項目へ、最初の項目でArrowUpを押したときに最後の項目へ移動するかどうか。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu | 常に存在 |
data-state | "open" | "closed" |
Trigger#
| Prop | デフォルト | 型 |
|---|---|---|
| as | 'button' | keyof HTMLElementTagNameMap | Component<any>
|
すべての<button>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu-trigger | 常に存在 |
data-state | "open" | "closed" |
Content#
| Prop | デフォルト | 型 |
|---|---|---|
| side | 'bottom' | 'top' | 'right' | 'bottom' | 'left' メニューを配置するTrigger(またはコンテキストメニューのポインター)の側面です。空きスペースがない場合は反転します。 |
| align | 'start' | 'start' | 'center' | 'end' その側に沿った配置方向。 |
| sideOffset | 0 | number Triggerからの距離(px)。 |
| alignOffset | 0 | number 側に沿ったオフセット(px)。 |
| avoidCollisions | true | boolean メニューをビューポート内に収めるために反転およびシフトするかどうか。 |
| collisionPadding | 0 | number 衝突を防ぐ際のビューポート端からのパディング(px)。 |
| arrowPadding | 0 | number 矢印とメニューの角の間のパディング(px単位)。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu-content | 常に存在 |
data-state | "open" | "closed" |
data-side | 反転後の最終的な配置側:"top" | "right" | "bottom" | "left" |
data-align | "start" | "center" | "end" |
| CSS変数 | 値 |
|---|---|
--leve-menu-anchor-width | Triggerの幅(メニューを少なくとも同じ幅にする場合などに使用) |
--leve-menu-anchor-height | Triggerの高さ |
--leve-menu-available-width | ビューポートで利用可能な幅 |
--leve-menu-available-height | ビューポート内で利用可能な高さ(max-heightなどに使用) |
Contentが開いている間、インラインでposition、top、leftが設定されます。displayは:popover-openにのみ設定してください。Content自体に設定すると、閉じたpopoverに対するブラウザのdisplay: noneが上書きされてしまいます。
Item#
| Prop | デフォルト | 型 |
|---|---|---|
| as | 'div' | keyof HTMLElementTagNameMap | Component<any>
|
| disabled | false | boolean アイテムを無効化します。選択できなくなり、矢印キーでスキップされます。 |
| onSelect$ | – | QRL<() => void> クリック、Enter、またはSpaceでアイテムが選択されたときに呼び出されます。 |
| closeOnSelect | true | boolean アイテムの選択時にメニューを閉じるかどうか。 |
| textValue | – | string アイテムのテキストコンテンツが適切でない場合に、先行入力(typeahead)で使用されるテキスト。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu-item | 常に存在 |
data-disabled | 無効時に存在 |
data-text-value | 設定されている場合のtextValue |
フォーカスされたアイテムがハイライト表示されます。矢印キー、先行入力(typeahead)、ポインターでフォーカスが移動するため、:focusでスタイルを設定してください。
CheckboxItem#
| Prop | デフォルト | 型 |
|---|---|---|
| defaultChecked | false | boolean アイテムが初期状態で選択されているかどうか(非制御)。 |
| bind:checked | – | Signal<boolean> チェック状態を保持するシグナル(制御)。 |
| onCheckedChange$ | – | QRL<(checked: boolean) => void> ユーザーがアイテムの選択または選択解除を行ったときに呼び出されます。 |
| disabled | false | boolean アイテムを無効にします。変更できなくなり、矢印キーでスキップされます。 |
| closeOnSelect | true | boolean クリックまたはEnterでメニューを閉じるかどうか。Spaceでは閉じません(APG)。 |
| textValue | – | string アイテムのテキストコンテンツが適切でない場合に、先行入力(typeahead)で使用されるテキスト。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu-checkbox-item | 常に存在 |
data-state | "checked" | "unchecked" |
data-disabled | 無効時に存在 |
RadioGroup#
| Prop | デフォルト | 型 |
|---|---|---|
| defaultValue | null | string | null 初期選択される値(非制御)。 |
| bind:value | – | Signal<string | null> 選択された値を保持するシグナル(制御)。 |
| onValueChange$ | – | QRL<(value: string) => void> ユーザーが値を選択したときに呼び出されます。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu-radio-group | 常に存在 |
RadioItem#
| Prop | デフォルト | 型 |
|---|---|---|
| value (必須) | – | string この項目の値。 |
| disabled | false | boolean アイテムを無効化します。選択できなくなり、矢印キーでスキップされます。 |
| closeOnSelect | true | boolean クリックまたはEnterでメニューを閉じるかどうか。Spaceでは閉じません(APG)。 |
| textValue | – | string アイテムのテキストコンテンツが適切でない場合に、先行入力(typeahead)で使用されるテキスト。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu-radio-item | 常に存在 |
data-state | "checked" | "unchecked" |
data-disabled | 無効時に存在 |
ItemIndicator#
独自のpropはありません。 すべての<span>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu-item-indicator | 常に存在 |
data-state | "checked" | "unchecked" |
インジケーターは、アイテムが未選択の間hidden属性を持ちます。
Sub#
| Prop | デフォルト | 型 |
|---|---|---|
| defaultOpen | false | boolean 初期状態でサブメニューが開いているかどうか(非制御)。 |
| bind:open | – | Signal<boolean> 開閉状態を保持するシグナル(制御)。 |
| onOpenChange$ | – | QRL<(open: boolean) => void> ユーザー操作によってサブメニューが開閉されたときに呼び出されます。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu-sub | 常に存在 |
data-state | "open" | "closed" |
SubTrigger#
| Prop | デフォルト | 型 |
|---|---|---|
| disabled | false | boolean アイテムを無効にします。サブメニューを開くことができなくなり、矢印キーでスキップされます。 |
| textValue | – | string アイテムのテキストコンテンツが適切でない場合に、先行入力(typeahead)で使用されるテキスト。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu-sub-trigger | 常に存在 |
data-state | "open" | "closed" |
data-disabled | 無効時に存在 |
SubContent#
| Prop | デフォルト | 型 |
|---|---|---|
| side | 'right' | 'top' | 'right' | 'bottom' | 'left' サブメニューを配置するSubTrigger側の位置。スペースがない場合は反転します。 |
| align | 'start' | 'start' | 'center' | 'end' その側に沿った配置方向。 |
| sideOffset | 0 | number SubTriggerからの距離(px単位)。 |
| alignOffset | 0 | number 側に沿ったオフセット(px)。 |
| avoidCollisions | true | boolean メニューをビューポート内に収めるために反転およびシフトするかどうか。 |
| collisionPadding | 0 | number 衝突を防ぐ際のビューポート端からのパディング(px)。 |
| arrowPadding | 0 | number 矢印とメニューの角の間のパディング(px単位)。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu-sub-content | 常に存在 |
data-state | "open" | "closed" |
data-side | 反転後の最終的な配置面 |
data-align | "start" | "center" | "end" |
サブメニューは、Contentと同じCSS変数を--leve-menu-sub-プレフィックス付きで公開します。
Group#
独自のpropはありません。 すべての<div>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu-group | 常に存在 |
GroupLabel#
独自のpropはありません。 すべての<div>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu-group-label | 常に存在 |
Separator#
独自のpropはありません。 すべての<div>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu-separator | 常に存在 |
Arrow#
独自のpropはありません。 すべての<div>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-menu-arrow | 常に存在 |
data-side | Contentの最終的な配置側 |
アクセシビリティ#
Menu Button WAI-ARIAデザインパターンに準拠しています。
Menu.Triggerはaria-haspopup="menu"、aria-expanded、aria-controlsを描画します。Menu.Contentはrole="menu"を描画し、Triggerによってaria-labelledbyで名前が付けられます。- アイテムは
role="menuitem"とtabindex="-1"を描画します。キーボード操作でアイテム間をフォーカスが移動し(roving focus)、メニュー全体で1つのタブストップになります。 - 無効化されたアイテムは
aria-disabled="true"を描画します。読み上げはされますが選択できず、矢印キーでスキップされます。 Menu.Groupはrole="group"を描画し、そのMenu.GroupLabelによって名前が付けられます。Menu.SubTriggerはaria-haspopup="menu"、aria-expanded、およびaria-controlsを持つrole="menuitem"を描画します。Menu.SubContentは、SubTriggerによって名前付けされたrole="menu"を描画します。Menu.CheckboxItemとMenu.RadioItemは、aria-checkedを持つrole="menuitemcheckbox"/role="menuitemradio"をレンダリングします。Menu.RadioGroupはrole="group"をレンダリングします。aria-labelで名前を付けるか、ラベル付きのMenu.Group内に配置してください。aria-checkedが状態を伝えるため、Menu.ItemIndicatorは支援技術から隠されます。
キーボード操作#
| キー | 説明 |
|---|---|
Enter / Space / ArrowDown | Trigger上で、メニューを開き最初のアイテムにフォーカスを移動します。 |
ArrowUp | Trigger上で、メニューを開き最後のアイテムにフォーカスを移動します。 |
ArrowDown / ArrowUp | 次の/前の有効なアイテムにフォーカスを移動します。loopが設定されている場合は循環します。 |
Home / End | 最初/最後の有効なアイテムにフォーカスを移動します。 |
| 文字 | 入力された文字で始まる次のアイテムにフォーカスを移動します。 |
Enter / Space | アイテム上で、そのアイテムを選択してメニューを閉じます。 |
Space | チェックボックスまたはラジオアイテムで、メニューを閉じずに切り替えます。 |
Enter | チェックボックスまたはラジオアイテムで、切り替えてメニューを閉じます。 |
ArrowRight / Enter / Space | SubTrigger上では、サブメニューを開いてその最初のアイテムにフォーカスを移動します。 |
ArrowLeft | サブメニュー内では、サブメニューを閉じてSubTriggerにフォーカスを戻します。 |
Escape | サブメニューまたはメニューを閉じ、SubTriggerまたはTriggerにフォーカスを戻します。 |
Tab | メニューを閉じ、フォーカスを次に移動します。 |