管理画面で並べ替えられるメニューを作る
リンクの名前と順番をコードに固定せず、EmDashのメニューから読み込みます。
目次
EmDashに登録したメニューは、リンクの名前や順番を管理画面で編集できます。テーマからそのメニューを読み込むと、編集結果を公開ページに反映できます。ここでは「記事一覧」と「10件ずつ読む」の順番を変え、公開用ページにも反映されることを確かめます。
先に用意するもの
写真付き一覧のガイドの「練習用サイトを準備する」まで済ませてください。同じダウンロード教材「週末ノート」を使います。EmDash 1.4.0、Astro 7.4.5、Node.js 24.22.1が対象です。実行確認はmacOSで行いました。Windows向けの入力例はコマンドプロンプト用で、Windows実機では未確認です。
以下のファイル名は、特に断りがなければ教材の weekend-note フォルダーからの場所です。ファイルの内容はVS Codeで編集し、指定された名前で保存します。コマンドはファイルに保存せず、コマンド入力画面へ貼り付けて実行します。どちらも、囲みの前にある説明で作業する場所を確認してください。開発サーバーは weekend-note のコマンド入力画面で npm run dev を実行しておきます。
起動に使った画面は開いたままにします。このあとのコマンドは、別の入力画面で実行します。VS Code左側のファイル一覧で weekend-note フォルダーを右クリックし、**Open in Integrated Terminal(統合ターミナルで開く)**を選ぶと、そのフォルダーを作業場所にした画面を開けます。Windowsでは、パソコンの準備で選んだコマンドプロンプトを使います。
1. 読み込むメニューを確かめる
管理画面の「メニュー」を開くと、教材には「ヘッダーメニュー」があります。表示名とは別に primary という識別名が付いています。コードでは、この識別名を指定します。
src/pages/menu.astro の内容を確認してください。
---
import { getMenu } from 'emdash';
import Layout from '../layouts/Layout.astro';
const menu = await getMenu('primary');
---
<Layout title="メニュー"><h1>管理画面で変えるメニュー</h1>
<nav aria-label="メインメニュー">{menu?.items.map(item => <a href={item.url} target={item.target ?? undefined} rel={item.target === '_blank' ? 'noopener noreferrer' : undefined}>{item.label}</a>)}</nav>
<p>管理画面でヘッダーメニューの順番を変え、ここを開き直してください。</p></Layout>getMenu('primary') は、そのメニューの保存済み情報を読む命令です。menu?.items は、メニューがある場合に項目を取り出します。項目がなくてもページ全体がエラーにならない書き方です。
この教材は、上下関係のない1段のメニューです。子メニューを表示する場合は、子の項目をたどる表示処理も追加します。
メニューの識別名、リンクの文字、子項目がどこに入るかは、getMenu() の引数と戻り値で確認できます。
2. 管理画面で並べ替える
「ヘッダーメニュー」の「編集」を開きます。「10件ずつ読む」の上へ移動する矢印を押してください。「順序を保存しました」と出たら、別のタブで http://127.0.0.1:4350/menu/ を開き直します。
「10件ずつ読む」が先、「記事一覧」が後になれば成功です。コードの書き換えや、サイトのビルドは不要でした。これはアクセス時にメニューを読む、この練習サイトの構成での結果です。
項目の「編集」から表示名を変えた場合も、保存してから公開用ページを開き直します。URLの /cards/ と /paged/ は、このサイトの中の移動先です。
3. 表示が変わらない場合
メニューの識別名が primary か、保存した言語と表示側の言語が一致しているかを見ます。教材ではEnglishのまま進めます。メニューを編集した後に、初回用の setup/dev-bypass URLを再び開くと、練習データでメニューが戻る場合があります。普段は通常の管理画面URLを使ってください。
この実習のページでは、HTMLを保存して再利用するキャッシュを使っていません。メニューを含むページにキャッシュを追加する場合は、公式のメニュー取得とキャッシュの案内(別タブで開く)も確認し、メニュー更新時に古いHTMLを残さない設計にします。
終了するとき・次回続けるとき
npm run devを実行した画面が入力待ちに戻っていなければ、その画面でControl + Cを押して停止します。入力待ちに戻ったあともサイトが動き続けている場合は、weekend-noteでnpx astro dev stopを実行します。次回は同じフォルダーでnpm run devを実行してください。初期データを入れるseedコマンドを繰り返す必要はありません。