标签页

与 behaviors/tabs 配套的 data 契约分区导航——下面是可点击切换的 live demo。

三分区可点击切换。激活态 = .active 类,未激活面板挂 hidden。

<div data-tabs>  <nav class="page-tabs">    <button class="page-tab active" data-tab="overview">概览</button>    <button class="page-tab" data-tab="usage">用法</button>    <button class="page-tab" data-tab="api">契约</button>  </nav>  <section data-tab-panel="overview">    <p>三分区可点击切换。激活态 = .active 类,未激活面板挂 hidden。</p>  </section>  <section data-tab-panel="usage" hidden>    <p>引入 behaviors/tabs 后调用 initTabs(),事件委托在 [data-tabs] 容器上。</p>  </section>  <section data-tab-panel="api" hidden>    <p>契约:data-tabs(容器)→ data-tab(页签)→ data-tab-panel(面板);可选 data-tabs-hash 与 location.hash 同步。</p>  </section></div>

安装

bun add @icen.ai/ui

一行引入该组件(CSS 与 behavior 自动带上,无需关心内部 CSS 文件名):

import { initTabs } from '@icen.ai/ui/kit/tabs';initTabs();

也可以用脚手架直接打印引入行:

bunx --bun @icen.ai/ui add tabs

Astro 项目注意:kit 入口里的 CSS import 在页面 <script> 里会被 Astro 的 client bundle 摇掉——请改在布局 frontmatter 里引 CSS(import '@icen.ai/ui/components/tabs.css';),JS 行为仍可走 kit。Vite SPA / webpack 项目无此问题。

用法

import { initTabs } from '@icen.ai/ui/behaviors/tabs';initTabs();