跳到內容
開始使用

導覽列

導覽 Navbar

慈濟全球消息活動訊息前往捐款關於我們

導覽列放在每一頁的最上方,讓讀者知道自己在哪個網站,並且能前往網站的幾個主要區域。左邊放網站名稱或標誌,中間放主要選單,右邊放搜尋、語言等操作;畫面寬度小於 768px(手機、直向的平板)時,主要選單會收進「選單」按鈕。元件另有一個品牌底色(brand)變體,但目前在網站上看起來和預設一樣(待工程修正),請先用預設。如果只是在同一頁的幾組內容之間切換,請改用「頁籤」;電子書的閱讀畫面請改用「電子書工具列」。

部位說明
容器整條導覽列的底色、高度和下方的分隔線。底色和文字色跟著主題和色彩模式變。
品牌區可省略。左邊的網站名稱或標誌,讓讀者知道自己在哪個網站。
主要選單中間的幾個主要連結,通常用「連結」元件。寬畫面排成一列;窄畫面收進抽屜。螢幕閱讀器會把這一區唸成「主要導覽」。
操作區可省略。右邊的搜尋、語言、登入等小按鈕,通常用「圖示按鈕」。窄畫面上也一直看得到,不會收進抽屜。
選單按鈕只在窄畫面出現的三條線按鈕,按下打開抽屜,圖示變成叉叉,再按一次關閉。
抽屜窄畫面上,主要選單改成一列一個連結,從導覽列下方展開。按 Esc 鍵或點導覽列外面也會關閉。
焦點框用鍵盤選到選單按鈕時出現的外框,讓不用滑鼠的人知道目前在哪裡。顏色跟著主題。
類型 說明
建議 主要選單只放網站最重要的幾個區域,連結文字寫得短,例如「全球消息」「前往捐款」。寬畫面上所有連結排在同一列,不會自動換行。
建議 每一頁都放同一條導覽列,連結的順序和名稱在整個網站保持一致,讀者才不會迷路。
建議 操作區只放圖示時,每個圖示按鈕都要寫好標籤(例如「搜尋」),螢幕閱讀器才唸得出來。
避免 不要在主要選單塞很多連結或很長的文字;放不下的內容請移到頁尾或各區域自己的頁面。
避免 不要把變體名稱 light 當成淺色模式。它是預設的底色,在深色模式下也會跟著變深。
避免 不要把登入、語言這些操作放進主要選單;放在右邊的操作區。

目前顯示:DefaultGreen Natural(示意)。在頁首的「主題」可以切換。 查看所有主題

  • 預設變體: 用元件本身的預設變體。
  • 和預設主題不同的地方: 沒有。這就是預設主題,其他主題沒有特別指定的地方都沿用它。
  • 預設變體: 主題不決定預設變體:用元件本身的預設變體(各網站自己的預設變體要等網站設定檔,還沒有實作)。
  • 和預設主題不同的地方: (以下都是示意值)只有這個元件用到的顏色:主色、主色(滑鼠移上時;連結文字也用它)、品牌底色(襯在內容後的品牌色塊)、主色上的文字、焦點框(用鍵盤選到時的外框)。其餘和預設主題一樣。 看完整的顏色對照

上方的大預覽會跟著頁首的「主題」和「色彩模式」一起變。

以下是給工程師的安裝與 API 說明,美編(設計)、網站的編輯和致遠(廠商)可以略過。

Storybook(給工程師逐一檢查元件狀態的工具網站,在本機用 pnpm run heroui:storybook 開啟)目前只收錄 HeroUI 的元件,還沒有 <tc-navbar> 的頁面;這一段的範例和 API 表就是它的說明。

<tc-navbar> 是響應式的網站頂部列/站台 header:brand 插槽放標誌或站名(inline-start),預設插槽放主要導覽項目(桌機水平排列),actions 插槽放搜尋/語言/登入等操作(inline-end)。於平板斷點(--tc-breakpoint-tablet = 768px)以下,導覽會收合為漢堡選單,點擊後以垂直抽屜呈現。下方為可互動的真實元件:

慈濟全球消息活動訊息前往捐款關於我們

brand 變體以品牌深藍底搭配 on-brand 文字;light(預設)為白底搭配預設文字色。

慈濟基金會全球消息活動訊息

設定 sticky 後,導覽列以 position: sticky; top: 0 黏附於捲動容器頂部,z-index 採用 --tc-z-sticky。

<tc-navbar sticky>
<strong slot="brand">慈濟</strong>
<tc-link href="#news">全球消息</tc-link>
</tc-navbar>

768px 以下會出現漢堡按鈕;點擊切換 open 屬性並發出 tc-menu-toggle。導覽改以垂直抽屜呈現於列下方。按 Escape 或點擊列外區域皆會關閉抽屜。

<tc-navbar open>
<strong slot="brand">慈濟</strong>
<tc-link href="#news">全球消息</tc-link>
<tc-link href="#events">活動訊息</tc-link>
</tc-navbar>
navbar.addEventListener('tc-menu-toggle', (e) => {
console.log('drawer open?', e.detail.open);
});
<link rel="stylesheet" href="@tzuchi/tokens/tokens.css" />
<script type="module" src="@tzuchi/components/cdn"></script>
<tc-navbar variant="light" sticky>
<strong slot="brand">慈濟</strong>
<tc-link href="/news">全球消息</tc-link>
<tc-link href="/events">活動訊息</tc-link>
<tc-icon-button slot="actions" label="搜尋">
<tc-icon name="search"></tc-icon>
</tc-icon-button>
</tc-navbar>
import { TcNavbar } from '@tzuchi/react';
<TcNavbar variant="brand" sticky onTcMenuToggle={(e) => console.log(e.detail.open)}>
<strong slot="brand">慈濟</strong>
<TcLink href="/news">全球消息</TcLink>
</TcNavbar>;

下表自 Custom Elements Manifest 自動產生:

Attribute Type Default Description
variant 'brand' | 'light' 'light' 視覺變體:`light`(白底、預設文字)或 `brand`(品牌深藍底、on-brand 文字)。
sticky boolean false 是否黏附於捲動容器頂部(`position: sticky; top: 0`)。
open boolean false 行動抽屜是否開啟。切換時派發 `tc-menu-toggle`。
  • 外層為原生 <header> 並帶 role="banner"。
  • 導覽區為原生 <nav> 並帶 aria-label="主要導覽"。
  • 漢堡按鈕帶 aria-label="選單"、aria-controls(指向 nav)與 aria-expanded(隨 open 同步)。
  • Escape 與點擊列外區域皆會關閉抽屜。
  • 焦點環使用 --tc-focus-ring-* token。