CSS: side-nav-bar

.instui-side-nav-bar — 由圖示置於標籤上方的垂直導覽欄，並提供縮小的僅顯示圖示模式。

在導覽項目之間以及自身的 padding 之間設定其自己的 gap；串接 -gap-*/-p-*/-padding-* 的間距實用修飾子會覆寫那些內建值。個別導覽項目請參見 side-nav-bar.item 成員。

Source: item.css

無障礙

為 <nav> 加上 aria-label，以便被宣告為具名稱的導覽地標。

使用方法

@import "@pantoken/components/components.css";
@import "@pantoken/components/side-nav-bar.css";

範例

<nav class="instui-side-nav-bar" aria-label="Primary">
  <a class="item -selected" href="#">
    <span class="instui-icon -icon-house"></span>
    <span class="label">首頁</span>
  </a>
  <a class="item" href="#">
    <span class="instui-icon -icon-inbox"></span>
    <span class="label">收件匣</span>
  </a>
  <a class="item" href="#">
    <span class="instui-icon -icon-calendar"></span>
    <span class="label">行事曆</span>
  </a>
  <a class="item" href="#">
    <span class="instui-icon -icon-settings"></span>
    <span class="label">設定</span>
  </a>
</nav>

結構

.instui-side-nav-bar
  side-nav-bar.item (component, 1..n)

flowchart TD n0[".instui-side-nav-bar"]:::cssdoc-root n1(["side-nav-bar.item"]):::cssdoc-component n0 -->|1..n| n1 click n1 "/api/css/side-nav-bar.item.md" classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

修飾器

修飾器	說明
.-icon-*	在每個導覽項目中呈現一個字形（glyph）圖示。
.-minimized	收合為僅圖示（隱藏標籤）。 @affects side-nav-bar.item — 隱藏該項目的標籤。

部件

部件	說明
.label	導覽項目的文字標籤。

已使用的代幣

Token	型別	值
--instui-component-side-nav-bar-background-color	<color>	LightDarklight-dark(#ffffff, #273540)
--instui-component-side-nav-bar-content-gap	<length>	0.25rem
--instui-component-side-nav-bar-content-margin	<length>	0.375rem
--instui-component-side-nav-bar-font-color	<color>	LightDarklight-dark(#273540, #ffffff)
--instui-component-side-nav-bar-item-font-family	[ <font-family-name> | <generic-font-family> ]#	Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-component-side-nav-bar-minimized-width	<length>	3.75rem

子元件

• side-nav-bar.item