三分区可点击切换。激活态 = .active 类,未激活面板挂 hidden。
引入 behaviors/tabs 后调用 initTabs(),事件委托在 [data-tabs] 容器上。
契约:data-tabs(容器)→ data-tab(页签)→ data-tab-panel(面板);可选 data-tabs-hash 与 location.hash 同步。
<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 pnpm add @icen.ai/ui npm install @icen.ai/ui yarn 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();