ICEN UI
ICEN UI 面板
Docs ⌘K
Core · 稳定

面板

承载一组相关内容的卡片容器：标题栏、副标题、底栏与可折叠变体。

Preview
基础 panel
面板标题 带副标题描述的示例
白卡片容器 + 标题栏 + 副标题，用于承载一组相关内容。panel-subtitle 会自动缩小并转为描述色。
可折叠面板 点击标题栏展开/折叠
点击右上角箭头可折叠/展开此面板内容。
html
<div class="icen-panel">  <div class="icen-panel-title">    <div class="icen-panel-title-text">      <span>面板标题</span>      <span class="icen-panel-subtitle">带副标题描述的示例</span>    </div>    <div class="icen-panel-title-actions"><button class="icen-btn icen-btn-sm">刷新</button></div>  </div>  <div class="icen-panel-body">    白卡片容器 + 标题栏 + 副标题，用于承载一组相关内容。panel-subtitle 会自动缩小并转为描述色。  </div>  <div class="icen-panel-foot">    <button class="icen-btn icen-btn-sm">取消</button>    <button class="icen-btn icen-btn-sm icen-btn-primary">保存</button>  </div></div><div class="icen-panel icen-panel--collapsible" id="demo-panel-collapse" style="margin-top:16px">  <div class="icen-panel-title">    <div class="icen-panel-title-text">      <span>可折叠面板</span>      <span class="icen-panel-subtitle">点击标题栏展开/折叠</span>    </div>    <div class="icen-panel-title-actions">      <button class="icen-panel-toggle" aria-expanded="true" type="button"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" focusable="false" class="icen-symbol icen-panel-toggle-icon" aria-hidden="true"><path d="M5.5 7.75 10 12.25l4.5-4.5"></path></svg></button>    </div>  </div>  <div class="icen-panel-body">点击右上角箭头可折叠/展开此面板内容。</div></div>

特性

接口

初始化
initPanel()（kit 一行入口可直接命名导入）
导出
setPanelExpanded
事件
icen:panel-toggle detail 契约见 IcenEventMap
类型
dist/behaviors/panel.d.mts（随 npm 包发布，含全部 JSDoc 约束）

安装

bun add @icen.ai/ui

一行引入该组件（CSS 与 behavior 自动带上，无需关心内部 CSS 文件名）：

js
import { initPanel } from '@icen.ai/ui/kit/panel';initPanel();

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

bash
bunx --bun @icen.ai/ui add panel

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

用法

html
<div class="icen-panel [--flush] [--accent] [--flat] [--collapsible] [.is-collapsed]">  <div class="icen-panel-title">    <div class="icen-panel-title-text">      <span>标题</span>      <span class="icen-panel-subtitle">副标题</span>    </div>    <div class="icen-panel-title-actions">…</div>  </div>  <div class="icen-panel-body">…内容…</div>  <div class="icen-panel-foot">…底栏…</div></div>