コンテンツにスキップ
Page

Navigation Menu

ドロップダウンパネルを持てる最上位のサイトナビゲーションです。

import {
NavigationMenu,
NavigationMenuList,
NavigationMenuItem,
NavigationMenuTrigger,
NavigationMenuContent,
NavigationMenuLink,
} from "@pelagornis/page/components";

上のプレビューはこのファイルを描画したものです。src/components/ にコピーして使い始めてください。

src/components/NavigationMenuExample.tsx
import {
NavigationMenu,
NavigationMenuContent,
NavigationMenuItem,
NavigationMenuLink,
NavigationMenuList,
NavigationMenuTrigger,
} from "@pelagornis/page/components";
export default function NavigationMenuDemo() {
return (
<NavigationMenu aria-label="Main">
<NavigationMenuList>
<NavigationMenuItem>
<NavigationMenuLink href="/" active>
Home
</NavigationMenuLink>
</NavigationMenuItem>
<NavigationMenuItem value="docs">
<NavigationMenuTrigger>Docs</NavigationMenuTrigger>
<NavigationMenuContent>
<NavigationMenuLink href="/guides/getting-started/">Getting started</NavigationMenuLink>
<NavigationMenuLink href="/components/">Components</NavigationMenuLink>
</NavigationMenuContent>
</NavigationMenuItem>
<NavigationMenuItem>
<NavigationMenuLink href="https://ui.pelagornis.com/">RefineUI</NavigationMenuLink>
</NavigationMenuItem>
</NavigationMenuList>
</NavigationMenu>
);
}

Navigation Menu は React の状態を共有する複数のパーツで構成されます。MDX に書いた子要素はそれぞれ別のアイランドとして描画されるため、パーツ同士がつながりません。上の例のように .tsx ファイルで組み立て、そのファイルをインポートしてください。

src/content/docs/example.mdx
---
title: Example
---
import NavigationMenuExample from "../../components/NavigationMenuExample";
<NavigationMenuExample client:load />

client:load はページの読み込み時にアイランドをハイドレートします。ページの下の方にあるコンテンツには client:visible を使ってください。

Markdoc のタグは Astro コンポーネントを描画しますが、このコンポーネントにはクライアントの状態が必要です。例をハイドレートする .astro ファイルで包み、そのファイルをタグとして登録してください。

src/components/markdoc/NavigationMenuExample.astro
---
import NavigationMenuExample from "../NavigationMenuExample";
---
<NavigationMenuExample client:load />
markdoc.config.mjs
import { component, defineMarkdocConfig } from "@astrojs/markdoc/config";
import starlightMarkdoc from "@astrojs/starlight-markdoc";
import pageMarkdoc from "@pelagornis/page/markdoc";
export default defineMarkdocConfig({
extends: [starlightMarkdoc(), pageMarkdoc()],
tags: {
"navigation-menu-example": {
render: component("./src/components/markdoc/NavigationMenuExample.astro"),
selfClosing: true,
},
},
});
src/content/docs/example.mdoc
{% navigation-menu-example /%}

コンポーネントを構成するパーツと、それぞれが描画する data-refineui のロールです。

パーツロール
rootnavigation-menu
contentnavigation-menu-content
content_panelnavigation-menu-content-panel
indicatornavigation-menu-indicator
itemnavigation-menu-item
linknavigation-menu-link
listnavigation-menu-list
triggernavigation-menu-trigger

コンポーネントがスタイルを当てる状態です。コンポーネントの状態は data 属性として公開されます。

種類状態
疑似クラスfocus-visible
data-stateopen closed

フォーカスがあるときにコンポーネントが処理するキーです。

キー動作
Escapeclose
Enteractivate
Spaceactivate