導覽列
用法
章節連結:用法導覽列放在每一頁的最上方,讓讀者知道自己在哪個網站,並且能前往網站的幾個主要區域。左邊放網站名稱或標誌,中間放主要選單,右邊放搜尋、語言等操作;畫面寬度小於 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)以下,導覽會收合為漢堡選單,點擊後以垂直抽屜呈現。下方為可互動的真實元件:
變體(variant)
章節連結:變體(variant)brand 變體以品牌深藍底搭配 on-brand 文字;light(預設)為白底搭配預設文字色。
黏附(sticky)
章節連結:黏附(sticky)設定 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>行動抽屜(open)
章節連結:行動抽屜(open)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);});純 HTML
章節連結:純 HTML<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>React
章節連結:Reactimport { TcNavbar } from '@tzuchi/react';
<TcNavbar variant="brand" sticky onTcMenuToggle={(e) => console.log(e.detail.open)}> <strong slot="brand">慈濟</strong> <TcLink href="/news">全球消息</TcLink></TcNavbar>;API
章節連結:API下表自 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`。 |
無障礙(Accessibility)
章節連結:無障礙(Accessibility)- 外層為原生
<header>並帶role="banner"。 - 導覽區為原生
<nav>並帶aria-label="主要導覽"。 - 漢堡按鈕帶
aria-label="選單"、aria-controls(指向 nav)與aria-expanded(隨open同步)。 Escape與點擊列外區域皆會關閉抽屜。- 焦點環使用
--tc-focus-ring-*token。