Files
aurora-admin b59247231a
Regression / regression (push) Canceled after 0s
feat(安全+品牌): 对外产物发布脱敏(3注入点/2465文件0泄露) + Kole Cup 定稿
安全:CHANGELOG.md 是仓库内部变更流水(含服务器目录、镜像回滚标签、内网网段、
部署时序、AI 工作流用语),此前被 build-site.ps1 / precompute.mjs / build-mobile.mjs
原样注入站点,而站点是公网可下载的静态文件 —— 抓一次 /site/m/changelog.html
即可拿到内网地址段与服务器目录布局。

- 新增 tools/lib/redact-publish.mjs(零依赖,构建期过滤,不改 CHANGELOG.md,
  内部可追溯性完整保留)
- 接入 precompute.mjs(PC data.json/changelog.json)与 build-mobile.mjs
  (移动端更新日志页);build-site.ps1 不碰(ASCII-only 铁律)
- 只处理 changelog 字段:components[].sources 是规范实现源码,逐字保真
  (详情页代码区主动高亮注释,剥注释会破坏该功能)
- 实测消除:/opt/aurora-admin.prev-*、kole-ui-showcase:pre-*、docker compose、
  192.168.5.7、16 位产物指纹、1531/1531、并发会话/本会话/派子 agent
- settings.html 演示占位 IP 192.168.5.0/24(= 真实网段)改为 RFC 5737 的 192.0.2.0/24

品牌:Kole Cup 饮料杯标记定稿(几何 K → 圆角杯盖 + 杯身负空间 K,无吸管),
brand-mark.json 升 schemaVersion 3(paths 支持 { d, evenodd }),
verify:brand 增至 25 条(新增 B9b:负空间必须带 fill-rule)。

验证:发布集 2465 文件全量扫描 0 泄露;PC 回归 100%(1464/1464) ·
移动端 100%(807/807);门禁品牌 25 / 隔离 31 / 移动文档 12 / 示例 9 / 版本 40 / i18n 17 全绿;
已按 AGENTS §九 发布公网,2461/2461 逐字节一致,五项验收全过。

已知未处理(既有缺口,ROADMAP S7-P28 已记录):data.mobile.json 的
meta.generated 为墙上时钟,会让 CI 的「生成物可复现」断言在重跑构建后永远非空;
该 CI 流水线本身亦从未通过(无 runner)。
2026-09-23 07:31:06 +08:00

1696 lines
88 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<script>
(function () {
var m = 'auto';
try { var v = localStorage.getItem('kole-mode'); if (v === 'light' || v === 'dark' || v === 'auto') m = v; } catch (e) {}
var dark = m === 'dark' || (m === 'auto' && window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches);
document.documentElement.classList.toggle('kole-dark', !!dark);
document.documentElement.style.colorScheme = dark ? 'dark' : 'light';
})();
</script>
<link rel="icon" href="../../assets/kole-mark.svg">
<meta name="theme-color" content="#FFFFFF" media="(prefers-color-scheme: light)">
<meta name="theme-color" content="#1C1F26" media="(prefers-color-scheme: dark)">
<title>折叠面板 Collapse — Kole UI Mobile</title>
<meta name="description" content="折叠面板 Collapse:移动端组件(6 端实现:CSS / H5 原生 / React / Vue 2 / Vue 3 / uni-app)。与 PC 端物理隔离:类名 kole-m-、令牌 --kole-m-。规格来源:移动端规格 25 · 折叠面板 Collapse。">
<link rel="stylesheet" href="../../../.design_library/kole-ui-mobile/colors_and_type.css">
<link rel="stylesheet" href="../style.css">
</head>
<body>
<header class="m-top">
<div class="m-top-inner">
<a class="m-logo" href="../index.html">
<span class="m-logo-mark" data-brand-mark="mono" aria-hidden="true"></span>
<span class="m-logo-text">Kole UI<em>移动端</em></span>
</a>
<div class="m-ver-picker" id="m-ver-picker">
<button id="m-ver-trigger" class="m-ver-trigger" type="button" data-single="1" aria-haspopup="listbox" aria-expanded="false" aria-label="选择版本" title="文档版本(清单来自部署根的 versions.json)">
<span id="m-ver">v1.0.0</span>
<svg class="m-ver-caret" width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg>
</button>
<div id="m-ver-menu" class="m-ver-menu hidden" role="listbox" aria-label="文档版本">
<div class="m-ver-menu-head" id="m-ver-head">文档版本</div>
</div>
</div>
<nav class="m-nav"> <a href="../index.html" class="active" aria-current="page">组件总览</a>
<a href="../guide.html">快速开始</a>
<a href="../design.html">设计规范</a>
<a href="../faq.html">常见问题</a>
<a href="../changelog.html">更新日志</a></nav>
<div class="m-mode">
<button id="m-mode-trigger" class="m-mode-trigger" type="button" aria-haspopup="listbox" aria-expanded="false" aria-label="主题模式" title="主题模式">
<svg class="m-mode-icon" id="m-icon-moon" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/></svg>
<svg class="m-mode-icon" id="m-icon-sun" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" style="display:none"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.93 4.93l1.41 1.41M17.66 17.66l1.41 1.41M2 12h2M20 12h2M4.93 19.07l1.41-1.41M17.66 6.34l1.41-1.41"/></svg>
<svg class="m-mode-icon" id="m-icon-auto" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" style="display:none"><rect x="3" y="4" width="18" height="13" rx="2"/><path d="M8 21h8M12 17v4"/></svg>
<span id="m-mode-cur">自动模式</span>
<svg class="m-mode-caret" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg>
</button>
<div id="m-mode-menu" class="m-menu hidden" role="listbox" aria-label="主题模式">
<div class="m-menu-head">主题模式</div>
<button class="m-menu-opt" type="button" role="option" data-mode="light" aria-selected="false"><span data-mode-label="light">日间模式</span></button>
<button class="m-menu-opt" type="button" role="option" data-mode="dark" aria-selected="false"><span data-mode-label="dark">夜间模式</span></button>
<button class="m-menu-opt" type="button" role="option" data-mode="auto" aria-selected="true"><span data-mode-label="auto">自动模式</span></button>
</div>
</div>
</div>
</header>
<div class="m-body">
<details class="m-side" open>
<summary><span>移动端导航</span><span class="cur">折叠面板</span></summary>
<nav>
<div class="m-side-section"><span>平台</span></div>
<a class="m-side-link m-side-platform" href="../../index.html"><span class="sp-top"><span class="sp-name">PC 端组件</span></span><span class="sp-sub">103 个中后台组件 · 5 端</span></a>
<a class="m-side-link m-side-platform" href="../index.html"><span class="sp-top"><span class="sp-name">移动端组件</span><span class="sp-badge">当前</span></span><span class="sp-sub">47 个组件 · 6 端 · 含 uni-app</span></a>
<div class="m-side-section"><span>开发指南</span></div>
<a class="m-side-link" href="../index.html">组件总览</a>
<a class="m-side-link" href="../guide.html">快速开始</a>
<a class="m-side-link" href="../design.html">设计规范</a>
<a class="m-side-link" href="../faq.html">常见问题</a>
<a class="m-side-link" href="../changelog.html">更新日志</a>
<a class="m-side-link" href="../platform.html">平台与端<em>移动端</em></a>
<a class="m-side-link" href="../../../tests/mobile/index.html" target="_blank">测试与回归<em>移动端</em></a>
<div class="m-side-section"><span>组件</span><span class="cnt">47</span></div>
<div class="m-side-group"><span>通用</span><span class="cnt">5</span></div>
<a class="m-side-link" href="mobile-button.html">按钮<em>Button</em></a>
<a class="m-side-link" href="mobile-divider.html">分割线<em>Divider</em></a>
<a class="m-side-link" href="mobile-icon.html">图标<em>Icon</em></a>
<a class="m-side-link" href="mobile-layout.html">布局<em>Layout</em></a>
<a class="m-side-link" href="mobile-link.html">链接<em>Link</em></a>
<div class="m-side-group"><span>导航</span><span class="cnt">6</span></div>
<a class="m-side-link" href="navbar.html">顶部导航栏<em>NavBar</em></a>
<a class="m-side-link" href="tabbar.html">底部标签栏<em>TabBar</em></a>
<a class="m-side-link" href="mobile-grid.html">宫格<em>Grid</em></a>
<a class="m-side-link" href="mobile-steps.html">步骤条<em>Steps</em></a>
<a class="m-side-link" href="mobile-segmented.html">分段器<em>Segmented</em></a>
<a class="m-side-link" href="mobile-sticky.html">吸顶容器<em>Sticky</em></a>
<div class="m-side-group"><span>数据录入</span><span class="cnt">16</span></div>
<a class="m-side-link" href="mobile-numberkeyboard.html">数字键盘<em>NumberKeyboard</em></a>
<a class="m-side-link" href="mobile-datepicker.html">日期选择器<em>DatePicker</em></a>
<a class="m-side-link" href="mobile-input.html">输入框<em>Input</em></a>
<a class="m-side-link" href="mobile-search.html">搜索框<em>Search</em></a>
<a class="m-side-link" href="mobile-stepper.html">步进器<em>Stepper</em></a>
<a class="m-side-link" href="mobile-switch.html">开关<em>Switch</em></a>
<a class="m-side-link" href="mobile-textarea.html">多行文本框<em>Textarea</em></a>
<a class="m-side-link" href="mobile-checkbox.html">多选框<em>Checkbox</em></a>
<a class="m-side-link" href="mobile-form.html">表单<em>Form</em></a>
<a class="m-side-link" href="mobile-radio.html">单选框<em>Radio</em></a>
<a class="m-side-link" href="mobile-rate.html">评分<em>Rate</em></a>
<a class="m-side-link" href="mobile-slider.html">滑动选择器<em>Slider</em></a>
<a class="m-side-link" href="mobile-cascader.html">级联选择器<em>Cascader</em></a>
<a class="m-side-link" href="mobile-colorpicker.html">颜色选择器<em>ColorPicker</em></a>
<a class="m-side-link" href="mobile-picker.html">选择器<em>Picker</em></a>
<a class="m-side-link" href="mobile-upload.html">上传<em>Upload</em></a>
<div class="m-side-group"><span>数据展示</span><span class="cnt">8</span></div>
<a class="m-side-link" href="cell.html">单元格<em>Cell</em></a>
<a class="m-side-link" href="mobile-badge.html">徽标<em>Badge</em></a>
<a class="m-side-link" href="mobile-tag.html">标签<em>Tag</em></a>
<a class="m-side-link" href="mobile-avatar.html">头像<em>Avatar</em></a>
<a class="m-side-link" href="mobile-list.html">列表<em>List</em></a>
<a class="m-side-link is-active" href="mobile-collapse.html" aria-current="page">折叠面板<em>Collapse</em></a>
<a class="m-side-link" href="mobile-table.html">表格<em>Table</em></a>
<a class="m-side-link" href="mobile-typography.html">排版<em>Typography</em></a>
<div class="m-side-group"><span>反馈</span><span class="cnt">12</span></div>
<a class="m-side-link" href="actionsheet.html">动作面板<em>ActionSheet</em></a>
<a class="m-side-link" href="pullrefresh.html">下拉刷新<em>PullRefresh</em></a>
<a class="m-side-link" href="swipecell.html">滑动单元格<em>SwipeCell</em></a>
<a class="m-side-link" href="mobile-popup.html">弹出层<em>Popup</em></a>
<a class="m-side-link" href="mobile-toast.html">轻提示<em>Toast</em></a>
<a class="m-side-link" href="mobile-dialog.html">对话框<em>Dialog</em></a>
<a class="m-side-link" href="mobile-noticebar.html">通知栏<em>NoticeBar</em></a>
<a class="m-side-link" href="mobile-loading.html">加载<em>Loading</em></a>
<a class="m-side-link" href="mobile-progress.html">进度条<em>Progress</em></a>
<a class="m-side-link" href="mobile-message.html">消息通知<em>Message</em></a>
<a class="m-side-link" href="mobile-overlay.html">遮罩层<em>Overlay</em></a>
<a class="m-side-link" href="mobile-popover.html">弹出气泡<em>Popover</em></a>
</nav>
</details>
<main class="m-main">
<section class="m-hero">
<h1>折叠面板<span class="en" style="font-family: var(--kole-font-family-num); font-size: 14px; color: var(--kole-color-text-secondary); margin-left: 8px;">Collapse</span></h1>
<p>把长内容按主题收起来,让用户先看到标题、按需展开某一段</p>
<p style="margin-top: 8px;" class="m-chips">
<span class="m-chip m">数据展示</span>
<span class="m-chip">规格 25 · 折叠面板 Collapse</span>
<span class="m-chip">6 端实现</span>
<span class="m-chip">触摸优先</span>
</p>
<div class="m-code" style="margin-top: var(--kole-space-12);">
<div class="m-code-head"><span>引入(H5 原生;其余 5 端见「快速开始」)</span><button class="m-copy" type="button" data-copy="code-import">复制</button></div>
<pre id="code-import"><code>&lt;!-- ① 令牌:PC 令牌 + 移动端 --kole-m-* 合成单文件,引一次 --&gt;
&lt;link rel=&quot;stylesheet&quot; href=&quot;kole-ui/mobile/tokens.css&quot;&gt;
&lt;!-- ② 本组件样式(全量则用 kole-ui/mobile/components/index.css) --&gt;
&lt;link rel=&quot;stylesheet&quot; href=&quot;kole-ui/mobile/components/mobile-collapse.css&quot;&gt;
&lt;!-- ③ 结构照抄下方任一演示块(类名与 6 端实现一致) --&gt;</code></pre>
</div>
</section>
<section class="m-block">
<h2 id="demo">演示</h2>
<p class="m-sub">每个演示都是真实渲染:预览帧加载 <code>frameworks-mobile/Collapse.html?demo=&lt;id&gt;</code>(只显示该演示块),代码是该演示块在演示页里的原文,可复制。全部演示同屏可看 <a href="../../../frameworks-mobile/Collapse.html" target="_blank">演示页 ↗</a>。</p>
<h3 class="m-demo-group">01 组件类型</h3>
<div class="m-demo" id="demo-basic">
<div class="m-demo-head"><span class="m-demo-title">基础用法</span><span class="m-chip">accordion=false</span></div>
<p class="m-demo-desc">点标题行展开:整行热区不小于 52px,箭头转 90 度,aria-expanded 同步变化。</p>
<div class="m-demo-stage"><iframe src="../../../frameworks-mobile/Collapse.html?demo=basic" title="折叠面板 Collapse · 基础用法" loading="lazy"></iframe></div>
<details class="m-details"><summary>查看代码(演示页原文 · 17 行)</summary>
<div class="m-code"><div class="m-code-head"><span>frameworks-mobile/Collapse.html · basic</span><button class="m-copy" type="button" data-copy="code-demo-1">复制</button></div>
<pre id="code-demo-1"><code>&lt;section class=&quot;demo-block&quot; data-demo=&quot;basic&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;基础用法(点标题行展开:整行热区 ≥52px,箭头转 90°,aria-expanded 同步)&lt;/p&gt;
&lt;div class=&quot;demo-box&quot;&gt;
&lt;div class=&quot;kole-m-collapse&quot; data-assert=&quot;collapse-basic&quot;&gt;
&lt;div class=&quot;kole-m-collapse__item&quot; id=&quot;col-basic&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;false&quot; aria-controls=&quot;col-basic-panel&quot;
data-behavior=&quot;click-sets-attr:#col-basic-header|aria-expanded|true&quot; id=&quot;col-basic-header&quot;&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;配送与运费说明&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;col-basic-panel&quot; hidden&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;单笔满 99 元免运费;偏远地区按实际重量计费,下单页会先给出预估金额。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/section&gt;</code></pre></div>
</details>
</div>
<div class="m-demo" id="demo-multi">
<div class="m-demo-head"><span class="m-demo-title">多面板同时展开</span><span class="m-chip">accordion=false</span></div>
<p class="m-demo-desc">accordion=false 时各面板各自开合,互不影响。</p>
<div class="m-demo-stage"><iframe src="../../../frameworks-mobile/Collapse.html?demo=multi" title="折叠面板 Collapse · 多面板同时展开" loading="lazy"></iframe></div>
<details class="m-details"><summary>查看代码(演示页原文 · 27 行)</summary>
<div class="m-code"><div class="m-code-head"><span>frameworks-mobile/Collapse.html · multi</span><button class="m-copy" type="button" data-copy="code-demo-2">复制</button></div>
<pre id="code-demo-2"><code>&lt;section class=&quot;demo-block&quot; data-demo=&quot;multi&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;多面板同时展开(accordion=false:点标题行各自开合,互不影响)&lt;/p&gt;
&lt;div class=&quot;demo-box&quot;&gt;
&lt;div class=&quot;kole-m-collapse&quot; data-assert=&quot;collapse-multi&quot;&gt;
&lt;div class=&quot;kole-m-collapse__item is-expanded&quot; id=&quot;col-multi-1&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;true&quot; aria-controls=&quot;col-multi-1-panel&quot;
data-behavior=&quot;click-toggles-class:#col-multi-1|is-expanded&quot;&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;已展开的面板&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;col-multi-1-panel&quot;&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;再次点击标题行即可收起;同时打开第二个面板不会影响这一项。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;div class=&quot;kole-m-collapse__item&quot; id=&quot;col-multi-2&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;false&quot; aria-controls=&quot;col-multi-2-panel&quot;
data-behavior=&quot;click-toggles-class:#col-multi-2|is-expanded&quot;&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;收起的面板&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;col-multi-2-panel&quot; hidden&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;移动端屏幕窄,展开后内容会顶走上下文 —— 主题多时优先用手风琴。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/section&gt;</code></pre></div>
</details>
</div>
<div class="m-demo" id="demo-accordion">
<div class="m-demo-head"><span class="m-demo-title">手风琴</span><span class="m-chip">accordion=true</span></div>
<p class="m-demo-desc">accordion=true 时展开新面板会自动收起当前展开项,适合主题多、屏幕窄的场合。</p>
<div class="m-demo-stage"><iframe src="../../../frameworks-mobile/Collapse.html?demo=accordion" title="折叠面板 Collapse · 手风琴" loading="lazy"></iframe></div>
<details class="m-details"><summary>查看代码(演示页原文 · 26 行)</summary>
<div class="m-code"><div class="m-code-head"><span>frameworks-mobile/Collapse.html · accordion</span><button class="m-copy" type="button" data-copy="code-demo-3">复制</button></div>
<pre id="code-demo-3"><code>&lt;section class=&quot;demo-block&quot; data-demo=&quot;accordion&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;手风琴(accordion=true:展开新面板会自动收起当前展开项)&lt;/p&gt;
&lt;div class=&quot;demo-box&quot;&gt;
&lt;div class=&quot;kole-m-collapse kole-m-collapse--accordion&quot; data-accordion=&quot;true&quot; data-assert=&quot;collapse-accordion&quot;&gt;
&lt;div class=&quot;kole-m-collapse__item is-expanded&quot; id=&quot;acc-1&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;true&quot; aria-controls=&quot;acc-1-panel&quot;&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;支付方式&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;acc-1-panel&quot;&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;支持微信支付、支付宝与对公转账;对公转账需 1~2 个工作日到账。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;div class=&quot;kole-m-collapse__item&quot; id=&quot;acc-2&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;false&quot; aria-controls=&quot;acc-2-panel&quot; id=&quot;acc-2-header&quot;
data-behavior=&quot;click-sets-attr:#acc-2-header|aria-expanded|true&quot;&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;发票与报销&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;acc-2-panel&quot; hidden&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;电子发票在订单完成后 2 小时内开出,可在订单详情页重新下载。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/section&gt;</code></pre></div>
</details>
</div>
<h3 class="m-demo-group">02 组件状态</h3>
<div class="m-demo" id="demo-bordered">
<div class="m-demo-head"><span class="m-demo-title">边框两态</span><span class="m-chip">bordered=true|false</span></div>
<p class="m-demo-desc">bordered=true 有外框与面板间分隔线;false 时靠留白分隔。</p>
<div class="m-demo-stage"><iframe src="../../../frameworks-mobile/Collapse.html?demo=bordered" title="折叠面板 Collapse · 边框两态" loading="lazy"></iframe></div>
<details class="m-details"><summary>查看代码(演示页原文 · 25 行)</summary>
<div class="m-code"><div class="m-code-head"><span>frameworks-mobile/Collapse.html · bordered</span><button class="m-copy" type="button" data-copy="code-demo-4">复制</button></div>
<pre id="code-demo-4"><code>&lt;section class=&quot;demo-block&quot; data-demo=&quot;bordered&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;边框两态(bordered=true 有外框与分隔线 / false 靠留白分隔)&lt;/p&gt;
&lt;div class=&quot;demo-pad&quot; data-assert=&quot;collapse-bordered&quot;&gt;
&lt;div class=&quot;kole-m-collapse kole-m-collapse--bordered&quot;&gt;
&lt;div class=&quot;kole-m-collapse__item is-expanded&quot; id=&quot;brd-1&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;true&quot; aria-controls=&quot;brd-1-panel&quot;&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;带边框(bordered=true)&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;brd-1-panel&quot;&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;面板之间有 1px 分隔线,组外有圆角边框,适合独立卡片。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;div class=&quot;kole-m-collapse__item&quot; id=&quot;brd-2&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;false&quot; aria-controls=&quot;brd-2-panel&quot;&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;同组第二个面板&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;brd-2-panel&quot; hidden&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;分隔线只在面板之间出现,首尾不画。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/section&gt;</code></pre></div>
</details>
</div>
<div class="m-demo" id="demo-disabled">
<div class="m-demo-head"><span class="m-demo-title">禁用面板</span><span class="m-chip">状态 disabled</span></div>
<p class="m-demo-desc">状态 disabled:标题行置灰、不响应点击,aria-disabled 已置位且不可聚焦。</p>
<div class="m-demo-stage"><iframe src="../../../frameworks-mobile/Collapse.html?demo=disabled" title="折叠面板 Collapse · 禁用面板" loading="lazy"></iframe></div>
<details class="m-details"><summary>查看代码(演示页原文 · 17 行)</summary>
<div class="m-code"><div class="m-code-head"><span>frameworks-mobile/Collapse.html · disabled</span><button class="m-copy" type="button" data-copy="code-demo-5">复制</button></div>
<pre id="code-demo-5"><code>&lt;section class=&quot;demo-block&quot; data-demo=&quot;disabled&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;禁用面板(标题行置灰、不响应点击,aria-disabled 已置位)&lt;/p&gt;
&lt;div class=&quot;demo-box&quot;&gt;
&lt;div class=&quot;kole-m-collapse&quot; data-assert=&quot;collapse-disabled&quot;&gt;
&lt;div class=&quot;kole-m-collapse__item is-disabled&quot; id=&quot;col-disabled&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;false&quot; aria-controls=&quot;col-disabled-panel&quot;
aria-disabled=&quot;true&quot; disabled&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;企业协议条款(需管理员权限)&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;col-disabled-panel&quot; hidden&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;无权限时内容不可展开。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/section&gt;</code></pre></div>
</details>
</div>
</section>
<section class="m-block">
<h2 id="api">API</h2>
<p class="m-sub">props / events / slots 为 6 端实现的公共接口(说明文字取自规格对应小节)。字段名与各端源码逐名核对:node tools/verify-mobile-docs.mjs</p>
<h3 class="m-h3">Props</h3>
<table class="m-table">
<thead><tr><th>名称</th><th>类型</th><th>默认值</th><th>说明</th><th>必传</th></tr></thead>
<tbody>
<tr><td><code>items</code></td><td><code>Array</code></td><td><code>[]</code></td><td>数据驱动的面板数组,每项含 key / title / content / disabled(规格 §25.2)</td><td>N</td></tr>
<tr><td><code>accordion</code></td><td><code>boolean</code></td><td><code>false</code></td><td>变体 accordion:手风琴模式,展开新面板时收起当前展开项(规格 §25.3)</td><td>N</td></tr>
<tr><td><code>bordered</code></td><td><code>boolean</code></td><td><code>true</code></td><td>变体 bordered:面板之间有分隔线与外框(规格 §25.3)</td><td>N</td></tr>
<tr><td><code>value</code></td><td><code>Array</code></td><td><code>[]</code></td><td>受控展开项:面板 key 的数组,点击后由 change 事件回传(规格 §25.5)</td><td>N</td></tr>
</tbody>
</table>
<p class="m-note">「必传」按严格定义:实现里**没有默认值**时才为 Y(本门禁逐条核对 props 与各端源码的默认值,防止契约与实现脱节)。</p>
<h3 class="m-h3">事件</h3>
<table class="m-table">
<thead><tr><th>名称</th><th>参数</th><th>说明</th></tr></thead>
<tbody>
<tr><td><code>change</code></td><td><code>(key, expanded)</code></td><td>面板标题行被点击后触发,回传该面板 key 与展开态布尔值(规格 §25.5)</td></tr>
</tbody>
</table>
<h3 class="m-h3">插槽</h3>
<table class="m-table">
<thead><tr><th>名称</th><th>说明</th></tr></thead>
<tbody>
<tr><td><code>default</code></td><td>追加在数据驱动面板之后的自定义面板(规格 §25.2 item)</td></tr>
</tbody>
</table>
<h3 class="m-h3">CSS 变量</h3>
<p class="m-sub">组件级变量(在组件样式表里定义)。业务侧可在自己的作用域内覆盖,不必改组件源码。</p>
<table class="m-table">
<thead><tr><th>名称</th><th>默认值</th><th>说明</th></tr></thead>
<tbody>
<tr><td><code>--kole-m-collapse-header-height</code></td><td><code>52px</code></td><td>标题行高度(≥ 44px 触控最小边长)</td></tr>
<tr><td><code>--kole-m-collapse-duration</code></td><td><code>180ms</code></td><td>箭头旋转时长</td></tr>
</tbody>
</table>
</section>
<section class="m-block">
<h2 id="usage">何时使用</h2>
<ul>
<li>把长内容按主题收起来,让用户先看到标题、按需展开某一段</li>
<li>移动端屏幕窄,展开后内容会顶走上下文,因此一次只展开一个(手风琴)是默认推荐形态</li>
<li>展开态必须明确到不靠颜色也能看出(箭头方向 + aria-expanded)</li>
<li>标题行整行都是热区,高度不小于 44px</li>
<li>手风琴模式下展开新面板会收起当前展开项;accordion=false 时互不影响</li>
</ul>
</section>
<section class="m-block">
<h2 id="interaction">交互与触控</h2>
<ul>
<li>标题行整行都是热区,高度不小于 44px</li>
<li>视觉箭头转 90 度(180ms 过渡),展开时 aria-expanded 同步为 true</li>
<li>手风琴模式下展开新面板会收起当前展开项;accordion=false 时互不影响</li>
<li>内容区不做高度动画,直接切换 hidden(省电,读屏也不会读到中间态);减少动态偏好下箭头同样瞬时切换</li>
</ul>
</section>
<section class="m-block">
<h2 id="a11y">无障碍</h2>
<ul>
<li>标题行用原生 button 并带 aria-expanded / aria-controls</li>
<li>内容区与标题用 id / aria-controls 建立关联,收起时用 hidden 属性隐藏(而不是只靠 CSS 高度)</li>
<li>禁用项置 aria-disabled=&quot;true&quot; 且不可聚焦</li>
</ul>
</section>
<section class="m-block">
<h2 id="related">相似组件</h2>
<p class="m-sub">从「该用哪一个」的角度区分;PC 端的对应实现见 <a href="../../index.html">PC 文档站</a>。</p>
<table class="m-table">
<thead><tr><th>组件</th><th>何时用它而不是本组件</th></tr></thead>
<tbody>
<tr><td><a href="mobile-list.html">列表</a><em style="font-family: var(--kole-font-family-num); font-style: normal; font-size: 11px; color: var(--kole-color-text-placeholder); margin-left: 6px;">List</em></td><td>行点击后跳转或选中用列表;就地展开内容用折叠面板</td></tr>
<tr><td><a href="mobile-popup.html">弹出层</a><em style="font-family: var(--kole-font-family-num); font-style: normal; font-size: 11px; color: var(--kole-color-text-placeholder); margin-left: 6px;">Popup</em></td><td>内容需要遮罩聚焦时用弹出层;内容属于当前上下文的补充说明时用折叠面板</td></tr>
<tr><td><a href="mobile-dialog.html">对话框</a><em style="font-family: var(--kole-font-family-num); font-style: normal; font-size: 11px; color: var(--kole-color-text-placeholder); margin-left: 6px;">Dialog</em></td><td>需要用户先决策再继续时用对话框;只是看说明用折叠面板</td></tr>
</tbody>
</table>
</section>
<section class="m-block">
<h2 id="gaps">规格未定 / 禁止发明</h2>
<table class="m-table">
<thead><tr><th>类别</th><th>条目</th></tr></thead>
<tbody>
<tr><td><span class="m-chip">禁止发明</span></td><td>展开动画的高度换算公式(内容高度由浏览器决定)</td></tr>
<tr><td><span class="m-chip">禁止发明</span></td><td>嵌套折叠面板的层级样式</td></tr>
<tr><td><span class="m-chip">规格未定</span></td><td>默认是否展开第一项</td></tr>
<tr><td><span class="m-chip">规格未定</span></td><td>标题行右侧是否允许放额外操作</td></tr>
</tbody>
</table>
</section>
<section class="m-block">
<h2 id="anatomy">结构(anatomy)</h2>
<table class="m-table">
<thead><tr><th>字段</th><th>说明</th></tr></thead>
<tbody>
<tr><td><code>collapse</code></td><td>根元素,一组面板的容器</td></tr>
<tr><td><code>item</code></td><td>单个面板,含标题行与内容区</td></tr>
<tr><td><code>header</code></td><td>标题行,整行可点,高度不小于 44px</td></tr>
<tr><td><code>arrow</code></td><td>标题行右侧箭头,展开时旋转 90 度</td></tr>
<tr><td><code>panel</code></td><td>内容区,展开时可见(收起时高度为 0 或 hidden)</td></tr>
<tr><td><code>content</code></td><td>内容区内的正文节点</td></tr>
</tbody>
</table>
</section>
<section class="m-block">
<h2 id="variants">变体维度与类名映射</h2>
<p class="m-sub">类名映射由构建脚本从契约 <code>variantClasses</code> 生成,并被 <code>verify:mobile-docs</code> 逐条对照组件 CSS 校验(类/变量必须真实存在)。</p>
<table class="m-table">
<thead><tr><th>维度</th><th>取值</th><th>对应类名 / 变量</th></tr></thead>
<tbody>
<tr><td><code>accordion</code></td><td>false / true</td><td><div><b>false</b> <span class="m-none">(由数据驱动,无专属类)</span></div><div><b>true</b> <span class="m-cls">.kole-m-collapse--accordion</span></div></td></tr>
<tr><td><code>bordered</code></td><td>true / false</td><td><div><b>true</b> <span class="m-cls">.kole-m-collapse--bordered</span></div><div><b>false</b> <span class="m-none">(由数据驱动,无专属类)</span></div></td></tr>
</tbody>
</table>
</section>
<section class="m-block">
<h2 id="rep-variants">代表变体</h2>
<table class="m-table">
<thead><tr><th>变体</th><th>标签</th></tr></thead>
<tbody>
<tr><td><code>accordion=false · bordered=true</code></td><td>多面板带边框(默认:各自开合互不影响)</td></tr>
<tr><td><code>accordion=true · bordered=true</code></td><td>手风琴(同时只展开一个,移动端推荐形态)</td></tr>
<tr><td><code>accordion=false · bordered=false</code></td><td>无边框面板(靠留白分隔,适合嵌在卡片内)</td></tr>
</tbody>
</table>
</section>
<section class="m-block">
<h2 id="tokens">用到的令牌</h2>
<p class="m-sub">构建时从本组件样式表扫描得出。蓝色为移动端自有令牌,绿色为继承的 PC 令牌(改一处两端生效)。</p>
<div class="m-chips">
<span class="m-chip m" title="正文 / 列表项">--kole-m-font-size-body</span>
<span class="m-chip m" title="次级说明">--kole-m-font-size-label</span>
<span class="m-chip m" title="页面左右留白">--kole-m-gutter</span>
<span class="m-chip inherit" title="分割线/边框">--kole-color-border</span>
<span class="m-chip inherit" title="品牌主色:主按钮、选中态、链接">--kole-color-brand</span>
<span class="m-chip inherit" title="卡片背景">--kole-color-card-bg</span>
<span class="m-chip inherit" title="输入框聚焦外发光">--kole-color-focus-ring</span>
<span class="m-chip inherit" title="表头背景">--kole-color-table-header-bg</span>
<span class="m-chip inherit" title="正文文字 · 14.0:1">--kole-color-text-body</span>
<span class="m-chip inherit" title="禁用态文字 · WCAG 1.4.3 对禁用控件豁免(规范定义于组件1/2.txt)">--kole-color-text-disabled</span>
<span class="m-chip inherit" title="占位文字 · 4.54:1(原 #BFBFBF 仅 1.84:1)">--kole-color-text-placeholder</span>
<span class="m-chip inherit" title="次要文字 · 5.10:1(原 #8C8C8C 仅 3.36:1)">--kole-color-text-secondary</span>
<span class="m-chip inherit" title="标题文字 · 15.4:1">--kole-color-text-title</span>
<span class="m-chip inherit" title="">--kole-ease-standard</span>
<span class="m-chip inherit" title="">--kole-font-family</span>
<span class="m-chip inherit" title="卡片、弹窗、抽屉">--kole-radius-large</span>
<span class="m-chip inherit" title="">--kole-space-12</span>
<span class="m-chip inherit" title="">--kole-space-16</span>
<span class="m-chip" title="组件级变量(可在业务侧覆盖)">--kole-m-collapse-duration</span>
<span class="m-chip" title="组件级变量(可在业务侧覆盖)">--kole-m-collapse-header-height</span>
</div>
</section>
<section class="m-block">
<h2 id="sources">6 端源码</h2>
<p class="m-sub">同一组件的六份实现(生产环境的类名与结构一致,差异只在技术栈写法与单位)。点开查看,右侧可复制。</p>
<details class="m-details">
<summary>frameworks-mobile/Collapse.css · 纯样式(CSS) · 105 行</summary>
<div class="m-code">
<div class="m-code-head"><span>frameworks-mobile/Collapse.css</span><button class="m-copy" type="button" data-copy="code-145">复制</button></div>
<pre id="code-145"><code>/* Kole UI Mobile · Collapse 样式 — 对齐移动端规格 §25
折叠面板:标题行整行可点(≥44px),展开态用 is-expanded + aria-expanded 双写;
箭头转 90°(180ms),内容区直接切 hidden(不做高度动画,省电且读屏不读中间态)。 */
.kole-m-collapse {
--kole-m-collapse-header-height: 52px; /* 标题行高度(≥ 44px 触控最小边长) */
--kole-m-collapse-duration: 180ms; /* 箭头旋转时长 */
box-sizing: border-box;
width: 100%;
background: var(--kole-color-card-bg);
font-family: var(--kole-font-family);
color: var(--kole-color-text-body);
font-size: var(--kole-m-font-size-body);
line-height: 1.4;
}
/* 变体 bordered=true:外框 + 面板之间的分隔线 */
.kole-m-collapse--bordered {
border: 1px solid var(--kole-color-border);
border-radius: var(--kole-radius-large);
overflow: hidden;
}
.kole-m-collapse--bordered .kole-m-collapse__item + .kole-m-collapse__item {
border-top: 1px solid var(--kole-color-border);
}
/* 面板:标题行 + 内容区 */
.kole-m-collapse__item { display: block; }
/* 变体 accordion=true:手风琴(同时只展开一个)。
展开逻辑在宿主/框架端实现(组件不阻止其它面板被程序化打开),
这里只把该模式标出来,便于样式与业务侧选择器挂钩。 */
.kole-m-collapse--accordion .kole-m-collapse__item.is-expanded .kole-m-collapse__header {
color: var(--kole-color-brand);
}
/* 标题行:整行都是热区(原生 button,键盘可达) */
.kole-m-collapse__header {
box-sizing: border-box;
display: flex;
align-items: center;
justify-content: space-between;
gap: var(--kole-space-12);
width: 100%;
min-height: var(--kole-m-collapse-header-height);
padding: var(--kole-space-12) var(--kole-m-gutter);
margin: 0;
border: 0;
background: var(--kole-color-card-bg);
color: var(--kole-color-text-title);
font-family: inherit;
font-size: inherit;
line-height: 1.4;
text-align: start;
cursor: pointer;
touch-action: manipulation;
}
.kole-m-collapse__header:active { background: var(--kole-color-table-header-bg); }
.kole-m-collapse__title {
flex: 1 1 auto;
min-width: 0;
overflow: hidden;
white-space: nowrap;
text-overflow: ellipsis;
}
/* 箭头:收起时指向右,展开时转 90° 指向下 */
.kole-m-collapse__arrow {
flex: 0 0 auto;
display: inline-flex;
color: var(--kole-color-text-placeholder);
transition: transform var(--kole-m-collapse-duration) var(--kole-ease-standard);
}
.kole-m-collapse__item.is-expanded .kole-m-collapse__arrow { transform: rotate(90deg); }
/* 内容区:展开时可见;收起用 hidden 属性(读屏也不会读到) */
.kole-m-collapse__panel {
padding: var(--kole-space-12) var(--kole-m-gutter) var(--kole-space-16);
border-top: 1px solid var(--kole-color-border);
color: var(--kole-color-text-secondary);
font-size: var(--kole-m-font-size-label);
line-height: 1.7;
}
.kole-m-collapse__panel[hidden] { display: none; }
.kole-m-collapse__content { margin: 0; }
/* 状态 disabled:标题行置灰且不响应 */
.kole-m-collapse__item.is-disabled .kole-m-collapse__header {
color: var(--kole-color-text-disabled);
cursor: not-allowed;
}
.kole-m-collapse__item.is-disabled .kole-m-collapse__header:active { background: var(--kole-color-card-bg); }
.kole-m-collapse__header:focus-visible {
outline: 2px solid var(--kole-color-focus-ring);
outline-offset: -2px;
}
</code></pre>
</div>
</details>
<details class="m-details">
<summary>frameworks-mobile/Collapse.html · H5 原生(无框架) · 193 行</summary>
<div class="m-code">
<div class="m-code-head"><span>frameworks-mobile/Collapse.html</span><button class="m-copy" type="button" data-copy="code-146">复制</button></div>
<pre id="code-146"><code>&lt;!DOCTYPE html&gt;
&lt;html lang=&quot;zh-CN&quot;&gt;
&lt;head&gt;
&lt;meta charset=&quot;UTF-8&quot;&gt;
&lt;meta name=&quot;viewport&quot; content=&quot;width=device-width, initial-scale=1.0, viewport-fit=cover&quot;&gt;
&lt;title&gt;Kole UI Mobile · Collapse(H5)&lt;/title&gt;
&lt;link rel=&quot;stylesheet&quot; href=&quot;../.design_library/kole-ui-mobile/colors_and_type.css&quot;&gt;
&lt;link rel=&quot;stylesheet&quot; href=&quot;Collapse.css&quot;&gt;
&lt;style&gt;
body { margin: 0; background: var(--kole-color-page-bg); font-family: var(--kole-font-family); color: var(--kole-color-text-body); }
.demo { max-width: 375px; margin: 0 auto; padding: var(--kole-m-gutter) 0; }
.demo-label { margin: 0; padding: var(--kole-space-12) var(--kole-m-gutter) var(--kole-space-8);
font-size: var(--kole-m-font-size-label); color: var(--kole-color-text-secondary); }
.demo-box { background: var(--kole-color-card-bg); border-block: 1px solid var(--kole-color-border); }
.demo-box--inset { border-block: 0; background: none; }
.demo-pad { padding: var(--kole-m-gutter); background: none; }
.demo-block[hidden] { display: none; }
&lt;/style&gt;
&lt;/head&gt;
&lt;body&gt;
&lt;div class=&quot;demo&quot;&gt;
&lt;section class=&quot;demo-block&quot; data-demo=&quot;basic&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;基础用法(点标题行展开:整行热区 ≥52px,箭头转 90°,aria-expanded 同步)&lt;/p&gt;
&lt;div class=&quot;demo-box&quot;&gt;
&lt;div class=&quot;kole-m-collapse&quot; data-assert=&quot;collapse-basic&quot;&gt;
&lt;div class=&quot;kole-m-collapse__item&quot; id=&quot;col-basic&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;false&quot; aria-controls=&quot;col-basic-panel&quot;
data-behavior=&quot;click-sets-attr:#col-basic-header|aria-expanded|true&quot; id=&quot;col-basic-header&quot;&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;配送与运费说明&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;col-basic-panel&quot; hidden&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;单笔满 99 元免运费;偏远地区按实际重量计费,下单页会先给出预估金额。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/section&gt;
&lt;section class=&quot;demo-block&quot; data-demo=&quot;multi&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;多面板同时展开(accordion=false:点标题行各自开合,互不影响)&lt;/p&gt;
&lt;div class=&quot;demo-box&quot;&gt;
&lt;div class=&quot;kole-m-collapse&quot; data-assert=&quot;collapse-multi&quot;&gt;
&lt;div class=&quot;kole-m-collapse__item is-expanded&quot; id=&quot;col-multi-1&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;true&quot; aria-controls=&quot;col-multi-1-panel&quot;
data-behavior=&quot;click-toggles-class:#col-multi-1|is-expanded&quot;&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;已展开的面板&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;col-multi-1-panel&quot;&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;再次点击标题行即可收起;同时打开第二个面板不会影响这一项。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;div class=&quot;kole-m-collapse__item&quot; id=&quot;col-multi-2&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;false&quot; aria-controls=&quot;col-multi-2-panel&quot;
data-behavior=&quot;click-toggles-class:#col-multi-2|is-expanded&quot;&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;收起的面板&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;col-multi-2-panel&quot; hidden&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;移动端屏幕窄,展开后内容会顶走上下文 —— 主题多时优先用手风琴。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/section&gt;
&lt;section class=&quot;demo-block&quot; data-demo=&quot;accordion&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;手风琴(accordion=true:展开新面板会自动收起当前展开项)&lt;/p&gt;
&lt;div class=&quot;demo-box&quot;&gt;
&lt;div class=&quot;kole-m-collapse kole-m-collapse--accordion&quot; data-accordion=&quot;true&quot; data-assert=&quot;collapse-accordion&quot;&gt;
&lt;div class=&quot;kole-m-collapse__item is-expanded&quot; id=&quot;acc-1&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;true&quot; aria-controls=&quot;acc-1-panel&quot;&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;支付方式&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;acc-1-panel&quot;&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;支持微信支付、支付宝与对公转账;对公转账需 1~2 个工作日到账。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;div class=&quot;kole-m-collapse__item&quot; id=&quot;acc-2&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;false&quot; aria-controls=&quot;acc-2-panel&quot; id=&quot;acc-2-header&quot;
data-behavior=&quot;click-sets-attr:#acc-2-header|aria-expanded|true&quot;&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;发票与报销&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;acc-2-panel&quot; hidden&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;电子发票在订单完成后 2 小时内开出,可在订单详情页重新下载。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/section&gt;
&lt;section class=&quot;demo-block&quot; data-demo=&quot;bordered&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;边框两态(bordered=true 有外框与分隔线 / false 靠留白分隔)&lt;/p&gt;
&lt;div class=&quot;demo-pad&quot; data-assert=&quot;collapse-bordered&quot;&gt;
&lt;div class=&quot;kole-m-collapse kole-m-collapse--bordered&quot;&gt;
&lt;div class=&quot;kole-m-collapse__item is-expanded&quot; id=&quot;brd-1&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;true&quot; aria-controls=&quot;brd-1-panel&quot;&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;带边框(bordered=true)&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;brd-1-panel&quot;&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;面板之间有 1px 分隔线,组外有圆角边框,适合独立卡片。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;div class=&quot;kole-m-collapse__item&quot; id=&quot;brd-2&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;false&quot; aria-controls=&quot;brd-2-panel&quot;&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;同组第二个面板&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;brd-2-panel&quot; hidden&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;分隔线只在面板之间出现,首尾不画。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/section&gt;
&lt;section class=&quot;demo-block&quot; data-demo=&quot;disabled&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;禁用面板(标题行置灰、不响应点击,aria-disabled 已置位)&lt;/p&gt;
&lt;div class=&quot;demo-box&quot;&gt;
&lt;div class=&quot;kole-m-collapse&quot; data-assert=&quot;collapse-disabled&quot;&gt;
&lt;div class=&quot;kole-m-collapse__item is-disabled&quot; id=&quot;col-disabled&quot;&gt;
&lt;button class=&quot;kole-m-collapse__header&quot; type=&quot;button&quot; aria-expanded=&quot;false&quot; aria-controls=&quot;col-disabled-panel&quot;
aria-disabled=&quot;true&quot; disabled&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;企业协议条款(需管理员权限)&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div class=&quot;kole-m-collapse__panel&quot; id=&quot;col-disabled-panel&quot; hidden&gt;
&lt;p class=&quot;kole-m-collapse__content&quot;&gt;无权限时内容不可展开。&lt;/p&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/section&gt;
&lt;/div&gt;
&lt;script&gt;
/* 演示页脚本:真实的展开 / 收起。
- 点标题行:切换 is-expanded + aria-expanded,并给内容区切 hidden(收起时读屏也读不到)
- data-accordion=&quot;true&quot; 的组:展开一项时自动收起同组的其它项
真实业务里这份状态由宿主管理(受控 open 值),此处是最小可运行实现。 */
(function () {
function itemsOf(root) { return Array.prototype.slice.call(root.querySelectorAll('.kole-m-collapse__item')); }
function setExpanded(item, on) {
var header = item.querySelector('.kole-m-collapse__header');
var panel = item.querySelector('.kole-m-collapse__panel');
item.classList.toggle('is-expanded', on);
if (header) header.setAttribute('aria-expanded', on ? 'true' : 'false');
if (panel) panel.hidden = !on;
}
Array.prototype.forEach.call(document.querySelectorAll('.kole-m-collapse'), function (root) {
var accordion = root.getAttribute('data-accordion') === 'true';
root.addEventListener('click', function (e) {
var header = e.target.closest ? e.target.closest('.kole-m-collapse__header') : null;
if (!header || !root.contains(header)) return;
var item = header.closest('.kole-m-collapse__item');
if (!item || item.classList.contains('is-disabled') || header.disabled) return;
var next = !item.classList.contains('is-expanded');
if (accordion &amp;&amp; next) {
itemsOf(root).forEach(function (other) { if (other !== item) setExpanded(other, false); });
}
setExpanded(item, next);
});
});
})();
&lt;/script&gt;
&lt;script&gt;
/* ?demo=&lt;id&gt; → 只显示该演示块(文档站按块预览用;无参数时全部显示,测试与回归走无参数路径) */
(function () {
var id = new URLSearchParams(location.search).get('demo');
if (!id) return;
var blocks = Array.prototype.slice.call(document.querySelectorAll('.demo-block'));
var hit = false;
blocks.forEach(function (b) {
var on = b.getAttribute('data-demo') === id;
if (on) hit = true;
b.hidden = !on;
});
if (!hit) { blocks.forEach(function (b) { b.hidden = false; }); return; }
document.body.classList.add('demo-single');
blocks.forEach(function (b) {
var label = b.querySelector('.demo-label');
if (label &amp;&amp; !b.hidden) label.hidden = true;
});
})();
&lt;/script&gt;
&lt;/body&gt;
&lt;/html&gt;
</code></pre>
</div>
</details>
<details class="m-details">
<summary>frameworks-mobile/Collapse.jsx · React · 95 行</summary>
<div class="m-code">
<div class="m-code-head"><span>frameworks-mobile/Collapse.jsx</span><button class="m-copy" type="button" data-copy="code-147">复制</button></div>
<pre id="code-147"><code>import React, { useRef, useState } from 'react';
import './Collapse.css';
/* 折叠面板(移动端)— 规格 §25
标题行是原生 button(整行热区、键盘可达)+ aria-expanded / aria-controls;
内容区收起时用 hidden 属性(而不是只靠 CSS 高度),读屏也不会读到收起的内容。
accordion=true 时展开新面板会收起当前展开项,其余模式互不影响。
本端不发明展开动画(内容区直接切 hidden):面板高度本由浏览器决定,不做高度换算。 */
/* 面板标题 / 内容区的 id:同页多实例不撞号(模块级自增即可) */
let seq = 0;
export default function Collapse({
items = [],
accordion = false,
bordered = true,
value = [],
onChange,
children = null,
}) {
const idRef = useRef(null);
if (idRef.current === null) {
seq += 1;
idRef.current = 'kole-m-collapse-' + seq;
}
const base = idRef.current;
/* null = 跟随 value 属性;点击后本地记账(与 DatePicker 同一约定) */
const [open, setOpen] = useState(null);
const expanded = open || value;
function toggle(key) {
const has = expanded.indexOf(key) &gt;= 0;
const next = accordion
? has
? []
: [key]
: has
? expanded.filter((k) =&gt; k !== key)
: expanded.concat([key]);
setOpen(next);
if (onChange) onChange(key, !has);
}
return (
&lt;div
className={
'kole-m-collapse' +
(accordion ? ' kole-m-collapse--accordion' : '') +
(bordered ? ' kole-m-collapse--bordered' : '')
}
&gt;
{items.map((it, i) =&gt; {
const key = it &amp;&amp; it.key !== undefined ? it.key : i;
const isOpen = expanded.indexOf(key) &gt;= 0;
const headerId = `${base}-header-${key}`;
const panelId = `${base}-panel-${key}`;
return (
&lt;div
className={
'kole-m-collapse__item' +
(isOpen ? ' is-expanded' : '') +
(it &amp;&amp; it.disabled ? ' is-disabled' : '')
}
key={String(key)}
&gt;
&lt;button
className=&quot;kole-m-collapse__header&quot;
type=&quot;button&quot;
id={headerId}
aria-expanded={isOpen ? 'true' : 'false'}
aria-controls={panelId}
aria-disabled={it &amp;&amp; it.disabled ? 'true' : undefined}
disabled={!!(it &amp;&amp; it.disabled)}
onClick={() =&gt; {
if (it &amp;&amp; it.disabled) return;
toggle(key);
}}
&gt;
&lt;span className=&quot;kole-m-collapse__title&quot;&gt;{it &amp;&amp; it.title}&lt;/span&gt;
&lt;span className=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;
›
&lt;/span&gt;
&lt;/button&gt;
&lt;div className=&quot;kole-m-collapse__panel&quot; id={panelId} aria-labelledby={headerId} hidden={!isOpen}&gt;
{it &amp;&amp; it.content}
&lt;/div&gt;
&lt;/div&gt;
);
})}
{children}
&lt;/div&gt;
);
}
</code></pre>
</div>
</details>
<details class="m-details">
<summary>frameworks-mobile/Collapse.vue2.vue · Vue 2 · 90 行</summary>
<div class="m-code">
<div class="m-code-head"><span>frameworks-mobile/Collapse.vue2.vue</span><button class="m-copy" type="button" data-copy="code-148">复制</button></div>
<pre id="code-148"><code>&lt;template&gt;
&lt;div class=&quot;kole-m-collapse&quot; :class=&quot;collapseClass&quot;&gt;
&lt;div
v-for=&quot;(it, i) in items&quot;
:key=&quot;String(keyOf(it, i))&quot;
class=&quot;kole-m-collapse__item&quot;
:class=&quot;{ 'is-expanded': isOpen(it, i), 'is-disabled': it &amp;&amp; it.disabled }&quot;
&gt;
&lt;button
class=&quot;kole-m-collapse__header&quot;
type=&quot;button&quot;
:id=&quot;headerId(it, i)&quot;
:aria-expanded=&quot;isOpen(it, i) ? 'true' : 'false'&quot;
:aria-controls=&quot;panelId(it, i)&quot;
:aria-disabled=&quot;it &amp;&amp; it.disabled ? 'true' : null&quot;
:disabled=&quot;!!(it &amp;&amp; it.disabled)&quot;
@click=&quot;toggle(it, i)&quot;
&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;{{ it &amp;&amp; it.title }}&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div
class=&quot;kole-m-collapse__panel&quot;
:id=&quot;panelId(it, i)&quot;
:aria-labelledby=&quot;headerId(it, i)&quot;
:hidden=&quot;!isOpen(it, i)&quot;
&gt;{{ it &amp;&amp; it.content }}&lt;/div&gt;
&lt;/div&gt;
&lt;slot&gt;&lt;/slot&gt;
&lt;/div&gt;
&lt;/template&gt;
&lt;script&gt;
/* 面板标题 / 内容区的 id:同页多实例不撞号(模块级自增即可) */
var seq = 0;
export default {
name: 'KoleMCollapse',
props: {
items: { type: Array, default: function () { return []; } },
accordion: { type: Boolean, default: false },
bordered: { type: Boolean, default: true },
value: { type: Array, default: function () { return []; } }
},
data: function () {
seq += 1;
return { open: null, base: 'kole-m-collapse-' + seq };
},
computed: {
collapseClass: function () {
return [
this.accordion ? 'kole-m-collapse--accordion' : '',
this.bordered ? 'kole-m-collapse--bordered' : ''
].filter(Boolean);
}
},
methods: {
keyOf: function (it, i) {
return it &amp;&amp; it.key !== undefined ? it.key : i;
},
current: function () {
return this.open || this.value;
},
isOpen: function (it, i) {
return this.current().indexOf(this.keyOf(it, i)) &gt;= 0;
},
headerId: function (it, i) {
return this.base + '-header-' + this.keyOf(it, i);
},
panelId: function (it, i) {
return this.base + '-panel-' + this.keyOf(it, i);
},
toggle: function (it, i) {
if (it &amp;&amp; it.disabled) return;
var key = this.keyOf(it, i);
var cur = this.current();
var has = cur.indexOf(key) &gt;= 0;
if (this.accordion) {
this.open = has ? [] : [key];
} else {
this.open = has ? cur.filter(function (k) { return k !== key; }) : cur.concat([key]);
}
this.$emit('change', key, !has);
}
}
};
&lt;/script&gt;
&lt;style src=&quot;./Collapse.css&quot;&gt;&lt;/style&gt;
</code></pre>
</div>
</details>
<details class="m-details">
<summary>frameworks-mobile/Collapse.vue3.vue · Vue 3 · 80 行</summary>
<div class="m-code">
<div class="m-code-head"><span>frameworks-mobile/Collapse.vue3.vue</span><button class="m-copy" type="button" data-copy="code-149">复制</button></div>
<pre id="code-149"><code>&lt;template&gt;
&lt;div class=&quot;kole-m-collapse&quot; :class=&quot;collapseClass&quot;&gt;
&lt;div
v-for=&quot;(it, i) in items&quot;
:key=&quot;String(keyOf(it, i))&quot;
class=&quot;kole-m-collapse__item&quot;
:class=&quot;{ 'is-expanded': isOpen(it, i), 'is-disabled': it &amp;&amp; it.disabled }&quot;
&gt;
&lt;button
class=&quot;kole-m-collapse__header&quot;
type=&quot;button&quot;
:id=&quot;headerId(it, i)&quot;
:aria-expanded=&quot;isOpen(it, i) ? 'true' : 'false'&quot;
:aria-controls=&quot;panelId(it, i)&quot;
:aria-disabled=&quot;it &amp;&amp; it.disabled ? 'true' : null&quot;
:disabled=&quot;!!(it &amp;&amp; it.disabled)&quot;
@click=&quot;toggle(it, i)&quot;
&gt;
&lt;span class=&quot;kole-m-collapse__title&quot;&gt;{{ it &amp;&amp; it.title }}&lt;/span&gt;
&lt;span class=&quot;kole-m-collapse__arrow&quot; aria-hidden=&quot;true&quot;&gt;›&lt;/span&gt;
&lt;/button&gt;
&lt;div
class=&quot;kole-m-collapse__panel&quot;
:id=&quot;panelId(it, i)&quot;
:aria-labelledby=&quot;headerId(it, i)&quot;
:hidden=&quot;!isOpen(it, i)&quot;
&gt;{{ it &amp;&amp; it.content }}&lt;/div&gt;
&lt;/div&gt;
&lt;slot&gt;&lt;/slot&gt;
&lt;/div&gt;
&lt;/template&gt;
&lt;script setup&gt;
/* 折叠面板(移动端)— 规格 §25:标题行是原生 button + aria-expanded / aria-controls,
内容区收起时用 hidden 属性(只靠 CSS 高度会让读屏继续读到收起的内容)。 */
import { computed, ref } from 'vue';
const props = defineProps({
items: { type: Array, default: () =&gt; [] },
accordion: { type: Boolean, default: false },
bordered: { type: Boolean, default: true },
value: { type: Array, default: () =&gt; [] }
});
const emit = defineEmits(['change']);
/* null = 跟随 value 属性;点击后本地记账(与 DatePicker 同一约定) */
const open = ref(null);
const collapseClass = computed(() =&gt; [
props.accordion ? 'kole-m-collapse--accordion' : '',
props.bordered ? 'kole-m-collapse--bordered' : ''
].filter(Boolean));
function keyOf(it, i) {
return it &amp;&amp; it.key !== undefined ? it.key : i;
}
function current() {
return open.value || props.value;
}
function isOpen(it, i) {
return current().indexOf(keyOf(it, i)) &gt;= 0;
}
function toggle(it, i) {
if (it &amp;&amp; it.disabled) return;
const key = keyOf(it, i);
const cur = current();
const has = cur.indexOf(key) &gt;= 0;
open.value = props.accordion
? has
? []
: [key]
: has
? cur.filter((k) =&gt; k !== key)
: cur.concat([key]);
emit('change', key, !has);
}
&lt;/script&gt;
&lt;style src=&quot;./Collapse.css&quot;&gt;&lt;/style&gt;
</code></pre>
</div>
</details>
<details class="m-details">
<summary>frameworks-mobile/Collapse.uniapp.vue · uni-app(跨端:小程序 / App / H5) · 146 行</summary>
<div class="m-code">
<div class="m-code-head"><span>frameworks-mobile/Collapse.uniapp.vue</span><button class="m-copy" type="button" data-copy="code-150">复制</button></div>
<pre id="code-150"><code>&lt;template&gt;
&lt;view class=&quot;kole-m-collapse&quot; :class=&quot;collapseClass&quot;&gt;
&lt;view
v-for=&quot;(it, i) in items&quot;
:key=&quot;i&quot;
class=&quot;kole-m-collapse__item&quot;
:class=&quot;{ 'is-expanded': isOpen(it, i), 'is-disabled': it &amp;&amp; it.disabled }&quot;
&gt;
&lt;view
class=&quot;kole-m-collapse__header&quot;
:role=&quot;it &amp;&amp; it.disabled ? '' : 'button'&quot;
:aria-expanded=&quot;isOpen(it, i) ? 'true' : 'false'&quot;
:aria-disabled=&quot;it &amp;&amp; it.disabled ? 'true' : 'false'&quot;
@tap=&quot;toggle(it, i)&quot;
&gt;
&lt;text class=&quot;kole-m-collapse__title&quot;&gt;{{ it &amp;&amp; it.title }}&lt;/text&gt;
&lt;text class=&quot;kole-m-collapse__arrow&quot;&gt;›&lt;/text&gt;
&lt;/view&gt;
&lt;view class=&quot;kole-m-collapse__panel&quot; v-show=&quot;isOpen(it, i)&quot;&gt;
&lt;text class=&quot;kole-m-collapse__content&quot;&gt;{{ it &amp;&amp; it.content }}&lt;/text&gt;
&lt;/view&gt;
&lt;/view&gt;
&lt;slot&gt;&lt;/slot&gt;
&lt;/view&gt;
&lt;/template&gt;
&lt;script setup&gt;
/* uni-app 端 · 折叠面板(移动端)— 规格 §25
跨端差异:标题行用 view + role=&quot;button&quot;(小程序没有可聚焦的原生 button 语义),
点击用 @tap,展开态同时写 aria-expanded 与 is-expanded;
内容区用 v-show 切换(小程序里 hidden 属性不可靠,v-show 编译成 display 控制更稳)。
尺寸用 rpx(88rpx = 375pt 下的 44px,故标题行 104rpx)。 */
import { computed, ref } from 'vue';
const props = defineProps({
items: { type: Array, default: () =&gt; [] },
accordion: { type: Boolean, default: false },
bordered: { type: Boolean, default: true },
value: { type: Array, default: () =&gt; [] }
});
const emit = defineEmits(['change']);
/* null = 跟随 value 属性;点击后本地记账(与 DatePicker 同一约定) */
const open = ref(null);
const collapseClass = computed(() =&gt; [
props.accordion ? 'kole-m-collapse--accordion' : '',
props.bordered ? 'kole-m-collapse--bordered' : ''
].filter(Boolean));
function keyOf(it, i) {
return it &amp;&amp; it.key !== undefined ? it.key : i;
}
function current() {
return open.value || props.value;
}
function isOpen(it, i) {
return current().indexOf(keyOf(it, i)) &gt;= 0;
}
function toggle(it, i) {
if (it &amp;&amp; it.disabled) return;
const key = keyOf(it, i);
const cur = current();
const has = cur.indexOf(key) &gt;= 0;
open.value = props.accordion
? has
? []
: [key]
: has
? cur.filter((k) =&gt; k !== key)
: cur.concat([key]);
emit('change', key, !has);
}
&lt;/script&gt;
&lt;style&gt;
.kole-m-collapse {
--kole-m-collapse-header-height: 104rpx; /* 标题行高度(≥ 88rpx 触控最小边长) */
--kole-m-collapse-duration: 180ms;
--kole-m-touch-target: 88rpx;
--kole-m-font-size-body: 32rpx;
--kole-m-font-size-label: 28rpx;
--kole-m-gutter: 32rpx;
box-sizing: border-box;
width: 100%;
background-color: var(--kole-color-card-bg);
color: var(--kole-color-text-body);
font-size: var(--kole-m-font-size-body);
}
.kole-m-collapse--bordered {
border: 1rpx solid var(--kole-color-border);
border-radius: 16rpx;
overflow: hidden;
}
.kole-m-collapse--bordered .kole-m-collapse__item + .kole-m-collapse__item {
border-top: 1rpx solid var(--kole-color-border);
}
.kole-m-collapse__header {
box-sizing: border-box;
display: flex;
align-items: center;
justify-content: space-between;
width: 100%;
min-height: var(--kole-m-collapse-header-height);
padding: 24rpx var(--kole-m-gutter);
background-color: var(--kole-color-card-bg);
color: var(--kole-color-text-title);
font-size: inherit;
}
/* 状态 active:按下反馈 */
.kole-m-collapse__header:active { background-color: var(--kole-color-table-header-bg); }
.kole-m-collapse__title {
flex: 1;
overflow: hidden;
white-space: nowrap;
text-overflow: ellipsis;
}
/* 箭头:收起指右,展开转 90° 指下 */
.kole-m-collapse__arrow {
flex-shrink: 0;
padding-left: 24rpx;
color: var(--kole-color-text-placeholder);
transition: transform var(--kole-m-collapse-duration) ease;
}
.kole-m-collapse__item.is-expanded .kole-m-collapse__arrow { transform: rotate(90deg); }
.kole-m-collapse__panel {
padding: 24rpx var(--kole-m-gutter) 32rpx;
border-top: 1rpx solid var(--kole-color-border);
color: var(--kole-color-text-secondary);
font-size: var(--kole-m-font-size-label);
line-height: 1.7;
}
.kole-m-collapse__item.is-disabled .kole-m-collapse__header {
color: var(--kole-color-text-disabled);
}
&lt;/style&gt;
</code></pre>
</div>
</details>
</section>
<section class="m-block">
<h2 id="tests">测试与回归</h2>
<p class="m-sub">断言在真实的 375×640 设备帧里跑(引擎与 PC 侧共用 <code>tests/_runtime.js</code>,触控行为动词来自移动端 <code>tests/mobile/_behaviors.js</code>)。</p>
<p>
<span class="m-status pass">断言 19 条 · 全部通过</span>
<span class="m-status">报告 2026-09-22 23:01:05</span>
</p>
<div class="m-code">
<div class="m-code-head"><span>复现命令</span><button class="m-copy" type="button" data-copy="code-test">复制</button></div>
<pre id="code-test"><code>node site/dev-server.js &amp;
REG_BASE=http://127.0.0.1:3311 node tools/run-mobile-regression.mjs # 全量 5 个组件
npm run verify:mobile-docs # 本页内容完整性 + API 与源码一致性</code></pre>
</div>
</section>
<section class="m-block">
<h2 id="contract">设计契约</h2>
<details class="m-details">
<summary>components/mobile-collapse.json(点击展开原始 JSON)</summary>
<div class="m-code"><pre><code>{
"schemaVersion": 1,
"sourceKind": "authored-spec",
"provenance": "authored-in-repo",
"specFile": "spec/移动端规格.md",
"specSection": "25 · 折叠面板 Collapse",
"confidence": "high",
"slug": "mobile-collapse",
"name": "折叠面板 Collapse",
"semanticTypeCandidates": [
"collapse",
"accordion",
"disclosure"
],
"variantDimensions": [
{
"name": "accordion",
"values": [
"false",
"true"
]
},
{
"name": "bordered",
"values": [
"true",
"false"
]
}
],
"representativeVariants": [
{
"accordion": "false",
"bordered": "true",
"label": "多面板带边框(默认:各自开合互不影响)"
},
{
"accordion": "true",
"bordered": "true",
"label": "手风琴(同时只展开一个,移动端推荐形态)"
},
{
"accordion": "false",
"bordered": "false",
"label": "无边框面板(靠留白分隔,适合嵌在卡片内)"
}
],
"anatomy": {
"collapse": "根元素,一组面板的容器",
"item": "单个面板,含标题行与内容区",
"header": "标题行,整行可点,高度不小于 44px",
"arrow": "标题行右侧箭头,展开时旋转 90 度",
"panel": "内容区,展开时可见(收起时高度为 0 或 hidden)",
"content": "内容区内的正文节点"
},
"structurePatterns": {
"accordion": "false(多面板可同时展开)/ true(手风琴,同时只展开一个)",
"bordered": "true(面板之间有分隔线与外框)/ false(无边框,靠留白分隔)"
},
"usageHints": [
"把长内容按主题收起来,让用户先看到标题、按需展开某一段",
"移动端屏幕窄,展开后内容会顶走上下文,因此一次只展开一个(手风琴)是默认推荐形态",
"展开态必须明确到不靠颜色也能看出(箭头方向 + aria-expanded)",
"标题行整行都是热区,高度不小于 44px",
"手风琴模式下展开新面板会收起当前展开项;accordion=false 时互不影响"
],
"doNotInvent": [
"展开动画的高度换算公式(内容高度由浏览器决定)",
"嵌套折叠面板的层级样式"
],
"unknowns": [
"默认是否展开第一项",
"标题行右侧是否允许放额外操作"
],
"interaction": [
"标题行整行都是热区,高度不小于 44px",
"视觉箭头转 90 度(180ms 过渡),展开时 aria-expanded 同步为 true",
"手风琴模式下展开新面板会收起当前展开项;accordion=false 时互不影响",
"内容区不做高度动画,直接切换 hidden(省电,读屏也不会读到中间态);减少动态偏好下箭头同样瞬时切换"
],
"accessibility": [
"标题行用原生 button 并带 aria-expanded / aria-controls",
"内容区与标题用 id / aria-controls 建立关联,收起时用 hidden 属性隐藏(而不是只靠 CSS 高度)",
"禁用项置 aria-disabled=\"true\" 且不可聚焦"
],
"api": {
"source": "implementation",
"note": "props / events / slots 为 6 端实现的公共接口(说明文字取自规格对应小节)。字段名与各端源码逐名核对:node tools/verify-mobile-docs.mjs",
"requiredNote": "「必传」按严格定义:实现里**没有默认值**时才为 Y(本门禁逐条核对 props 与各端源码的默认值,防止契约与实现脱节)。",
"props": [
{
"name": "items",
"type": "Array",
"default": "[]",
"desc": "数据驱动的面板数组,每项含 key / title / content / disabled(规格 §25.2)",
"required": false
},
{
"name": "accordion",
"type": "boolean",
"default": "false",
"desc": "变体 accordion:手风琴模式,展开新面板时收起当前展开项(规格 §25.3)",
"required": false
},
{
"name": "bordered",
"type": "boolean",
"default": "true",
"desc": "变体 bordered:面板之间有分隔线与外框(规格 §25.3)",
"required": false
},
{
"name": "value",
"type": "Array",
"default": "[]",
"desc": "受控展开项:面板 key 的数组,点击后由 change 事件回传(规格 §25.5)",
"required": false
}
],
"events": [
{
"name": "change",
"params": "(key, expanded)",
"desc": "面板标题行被点击后触发,回传该面板 key 与展开态布尔值(规格 §25.5)"
}
],
"slots": [
{
"name": "default",
"desc": "追加在数据驱动面板之后的自定义面板(规格 §25.2 item)"
}
]
},
"variantClasses": {
"accordion": {
"false": [],
"true": [
".kole-m-collapse--accordion"
]
},
"bordered": {
"true": [
".kole-m-collapse--bordered"
],
"false": []
}
},
"demos": [
{
"id": "basic",
"group": "01 组件类型",
"title": "基础用法",
"desc": "点标题行展开:整行热区不小于 52px,箭头转 90 度,aria-expanded 同步变化。",
"variant": "accordion=false"
},
{
"id": "multi",
"group": "01 组件类型",
"title": "多面板同时展开",
"desc": "accordion=false 时各面板各自开合,互不影响。",
"variant": "accordion=false"
},
{
"id": "accordion",
"group": "01 组件类型",
"title": "手风琴",
"desc": "accordion=true 时展开新面板会自动收起当前展开项,适合主题多、屏幕窄的场合。",
"variant": "accordion=true"
},
{
"id": "bordered",
"group": "02 组件状态",
"title": "边框两态",
"desc": "bordered=true 有外框与面板间分隔线;false 时靠留白分隔。",
"variant": "bordered=true|false"
},
{
"id": "disabled",
"group": "02 组件状态",
"title": "禁用面板",
"desc": "状态 disabled:标题行置灰、不响应点击,aria-disabled 已置位且不可聚焦。",
"variant": "状态 disabled"
}
],
"related": [
{
"slug": "mobile-list",
"why": "行点击后跳转或选中用列表;就地展开内容用折叠面板"
},
{
"slug": "mobile-popup",
"why": "内容需要遮罩聚焦时用弹出层;内容属于当前上下文的补充说明时用折叠面板"
},
{
"slug": "mobile-dialog",
"why": "需要用户先决策再继续时用对话框;只是看说明用折叠面板"
}
]
}</code></pre></div>
</details>
</section>
<footer class="m-foot">
<p>生成物:本页由 <code>node tools/build-mobile.mjs</code> 从契约 <code>components/mobile-collapse.json</code> 与 6 端源码生成,请勿手改。</p>
<p>规格原文:<code>.design_library/kole-ui-mobile/spec/移动端规格.md</code> · 隔离门禁:<code>node tools/verify-mobile-isolation.mjs</code></p>
</footer>
</main>
</div>
<script>
(function () {
/* 左栏:≤1000px 默认收起(手机上不让导航占满一屏),跨断点时同步一次;不监听 resize,
免得跟用户手动的展开/收起抢状态。桌面不设 open 之外的动作。 */
var side = document.querySelector('details.m-side');
if (side && window.matchMedia) {
var mq = window.matchMedia('(max-width: 1000px)');
var sync = function () { if (mq.matches) side.removeAttribute('open'); else side.setAttribute('open', ''); };
sync();
if (mq.addEventListener) mq.addEventListener('change', sync);
else if (mq.addListener) mq.addListener(sync);
}
/* 单演示预览帧按内容高度自适应(同源可读 contentDocument;上限 360px、下限 140px)。
固定高度会在内容少的演示上留一大片空白(实测 SwipeCell 单个演示只用 ~120px)。 */
function fitDemoFrames() {
var frames = document.querySelectorAll('.m-demo-stage iframe');
Array.prototype.forEach.call(frames, function (f) {
var fit = function () {
try {
var d = f.contentDocument;
if (!d || !d.body) return;
/* 只量 body.scrollHeight:documentElement.scrollHeight 等于**帧视口高度**(html 撑满视口),
拿它做 max 会形成「帧高→视口高→量到的高度」反馈环,永远收敛在初始值(实测锁在 308px)。 */
var h = d.body.scrollHeight;
if (!h) h = d.documentElement ? d.documentElement.scrollHeight : 0;
if (!h) return;
f.style.height = Math.min(360, Math.max(140, h + 8)) + 'px';
} catch (e) { /* 跨源或未就绪:保持 CSS 兜底高度 */ }
};
f.addEventListener('load', function () { fit(); setTimeout(fit, 300); });
fit();
});
}
fitDemoFrames();
window.addEventListener('load', fitDemoFrames);
/* 主题模式(三态):与 PC 完全同一约定 —— localStorage[kole-mode] ∈ light|dark|auto,
auto 跟随系统,反色靠 html.kole-dark(令牌文件里已写好该组,两端共用一份令牌)。
用户在 PC 站选夜间,进移动端站也是夜间。 */
var MODE_KEY = 'kole-mode';
var MODE_LABEL = { light: '日间模式', dark: '夜间模式', auto: '自动模式' };
function readMode() {
try { var v = localStorage.getItem(MODE_KEY); if (v === 'light' || v === 'dark' || v === 'auto') return v; } catch (e) {}
return 'auto';
}
function systemDark() {
return !!(window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches);
}
function applyMode(mode) {
var dark = mode === 'dark' || (mode === 'auto' && systemDark());
document.documentElement.classList.toggle('kole-dark', dark);
document.documentElement.style.colorScheme = dark ? 'dark' : 'light';
var cur = document.getElementById('m-mode-cur');
if (cur) cur.textContent = MODE_LABEL[mode] || MODE_LABEL.auto;
Array.prototype.forEach.call(document.querySelectorAll('.m-menu-opt'), function (o) {
o.setAttribute('aria-selected', o.getAttribute('data-mode') === mode ? 'true' : 'false');
});
/* 三态图标与 PC 同口径:显式选择时按时态给图标(日间=月亮 / 夜间=太阳),
自动模式下恒为「跟随系统」的显示器图标(此时两个显式图标都不显示)。 */
var moon = document.getElementById('m-icon-moon');
var sun = document.getElementById('m-icon-sun');
var auto = document.getElementById('m-icon-auto');
if (moon) moon.style.display = (mode === 'light') ? '' : 'none';
if (sun) sun.style.display = (mode === 'dark') ? '' : 'none';
if (auto) auto.style.display = (mode === 'auto') ? '' : 'none';
}
function bindModeMenu() {
var trigger = document.getElementById('m-mode-trigger');
var menu = document.getElementById('m-mode-menu');
if (!trigger || !menu) return;
var close = function (refocus) {
menu.classList.add('hidden'); trigger.setAttribute('aria-expanded', 'false');
if (refocus) trigger.focus();
};
trigger.addEventListener('click', function () {
var open = menu.classList.toggle('hidden');
trigger.setAttribute('aria-expanded', open ? 'false' : 'true');
});
trigger.addEventListener('keydown', function (e) {
if (e.key === 'Escape') close(true);
});
Array.prototype.forEach.call(menu.querySelectorAll('.m-menu-opt'), function (opt) {
opt.addEventListener('click', function () {
var mode = opt.getAttribute('data-mode');
try { localStorage.setItem(MODE_KEY, mode); } catch (e) {}
applyMode(mode);
close(true);
});
});
document.addEventListener('click', function (e) {
if (!menu.classList.contains('hidden') && !menu.contains(e.target) && !trigger.contains(e.target)) close(false);
});
document.addEventListener('keydown', function (e) {
if (e.key === 'Escape' && !menu.classList.contains('hidden')) close(true);
});
/* 自动模式下跟随系统切换 */
if (window.matchMedia) {
var mq = window.matchMedia('(prefers-color-scheme: dark)');
var onChange = function () { if (readMode() === 'auto') applyMode('auto'); };
if (mq.addEventListener) mq.addEventListener('change', onChange);
else if (mq.addListener) mq.addListener(onChange);
}
applyMode(readMode());
}
bindModeMenu();
/* 版本下拉:与 PC 顶栏同一实现口径 —— 清单从部署根取(<prefix>/versions.json 与
<prefix>/site/versions.json 两份按序尝试,取有可用条目的那份),拿不到就退回不可点的
纯角标(data-single="1"),不留一个点不开的下拉。
清单不许把用户带去外站:path 只允许 ".."(站点根自身)或 x.y.z 快照目录名。 */
var VERSION_KEY_PATH = '..';
function isValidVersionPath(p) {
if (typeof p !== 'string' || !p.length || p.indexOf('\\') >= 0 || p.indexOf('//') >= 0) return false;
if (p === VERSION_KEY_PATH) return true;
return /^\d+\.\d+\.\d+$/.test(p);
}
/* 清单里的 path 相对部署根,".." = /site/、x.y.z = /x.y.z/site/。
当前页可能不在部署根下(快照页),故先还原部署根绝对路径再算回相对当前页。 */
function versionHref(absSite) {
var i = location.pathname.indexOf('/site/');
var prefix = i >= 0 ? location.pathname.slice(0, i) : '';
if (!prefix || absSite.indexOf(prefix + '/') !== 0) return absSite;
var rest = absSite.slice(prefix.length + 1);
var up = '';
var segs = prefix.slice(1).split('/');
for (var k = 0; k < segs.length; k++) up += "../";
return up + rest;
}
function buildVersionList(doc) {
var raw = doc && doc.versions;
if (!raw || !raw.length) return [];
var i = location.pathname.indexOf('/site/');
var prefix = i >= 0 ? location.pathname.slice(0, i) : '';
var list = [];
for (var k = 0; k < raw.length; k++) {
var v = raw[k] || {};
var ver = v.version ? String(v.version) : '';
var path = v.path ? String(v.path) : '';
if (!ver || !isValidVersionPath(path)) continue;
var absSite = (path === VERSION_KEY_PATH ? '' : '/' + path) + '/site/';
list.push({ version: ver, date: v.date ? String(v.date) : '', latest: !!v.latest, href: versionHref(absSite), absSite: absSite, current: false });
}
if (list.length) {
/* 当前版本 = 绝对路径上命中的最长前缀(最具体的那个)——与 PC 的判定一致,
快照页与根站点都能算对。 */
var here = location.pathname;
var best = -1;
for (var j = 0; j < list.length; j++) {
if (here.indexOf(list[j].absSite) === 0 && list[j].absSite.length > best) best = list[j].absSite.length;
}
for (var m = 0; m < list.length; m++) list[m].current = best >= 0 && list[m].absSite.length === best;
if (best < 0 && list[0]) list[0].current = true;
}
return list;
}
function bindVersionMenu() {
var trigger = document.getElementById('m-ver-trigger');
var menu = document.getElementById('m-ver-menu');
var chip = document.getElementById('m-ver');
if (!trigger || !menu) return;
var close = function (refocus) {
menu.classList.add('hidden'); trigger.setAttribute('aria-expanded', 'false');
if (refocus) trigger.focus();
};
var interactive = false;
var render = function (list) {
interactive = !!(list && list.length);
/* 只有清单拿不到才退回纯角标;只要有一版就是下拉(里面至少能看清当前是哪个版本) */
trigger.setAttribute('data-single', interactive ? '0' : '1');
if (!interactive) { menu.classList.add("hidden"); return; }
var cur = null;
for (var k = 0; k < list.length; k++) if (list[k].current) cur = list[k];
if (chip) chip.textContent = 'v' + ((cur && cur.version) || VERSION);
/* 重建选项(幂等:重复调用不会叠加) */
Array.prototype.slice.call(menu.querySelectorAll('.m-ver-opt')).forEach(function (n) { n.remove(); });
list.forEach(function (it) {
var opt = document.createElement('button');
opt.type = 'button'; opt.className = 'm-ver-opt'; opt.setAttribute('role', 'option');
opt.setAttribute('data-version', it.version);
opt.setAttribute('aria-selected', it.current ? 'true' : 'false');
var tag = it.current ? '当前浏览' : (it.latest ? '最新版' : (it.date || ''));
opt.innerHTML = '<span class="m-ver-opt-num">v' + it.version + '</span><span class="m-ver-opt-tag">' + tag + '</span>';
if (it.href) opt.setAttribute('data-href', it.href);
opt.addEventListener("click", function () {
if (!it.current && it.href) location.href = it.href;
else close(true);
});
menu.appendChild(opt);
});
};
trigger.addEventListener('click', function () {
if (!interactive) return;
if (menu.classList.contains('hidden')) { menu.classList.remove('hidden'); trigger.setAttribute('aria-expanded', 'true'); }
else close(false);
});
trigger.addEventListener('keydown', function (e) {
if (!interactive) return;
if (e.key === 'ArrowDown' || e.key === 'ArrowUp') { e.preventDefault(); menu.classList.remove('hidden'); trigger.setAttribute('aria-expanded', 'true'); }
else if (e.key === 'Escape') close(true);
});
document.addEventListener('click', function (e) {
if (!menu.classList.contains('hidden') && !menu.contains(e.target) && !trigger.contains(e.target)) close(false);
});
document.addEventListener('keydown', function (e) {
if (e.key === 'Escape' && !menu.classList.contains('hidden')) close(true);
});
/* 两份清单按序尝试(不并行:快照页那份必然 404,并行会把 404 记进控制台,
而站点门禁的「零控制台错误」是硬断言)。 */
if (!window.fetch || location.protocol === 'file:') return;
var i = location.pathname.indexOf('/site/');
if (i < 0) return;
var prefix = location.pathname.slice(0, i);
var urls = [prefix + '/versions.json', prefix + '/site/versions.json'];
var attempt = function (idx) {
if (idx >= urls.length) return;
fetch(urls[idx], { cache: 'no-store' })
.then(function (r) { if (!r.ok) throw new Error('HTTP ' + r.status); return r.json(); })
.then(function (doc) { var list = buildVersionList(doc); if (list.length) render(list); else attempt(idx + 1); })
.catch(function () { attempt(idx + 1); });
};
attempt(0);
}
bindVersionMenu();
function done(btn) {
var old = btn.textContent; btn.textContent = '已复制'; btn.classList.add('is-done');
setTimeout(function () { btn.textContent = old; btn.classList.remove('is-done'); }, 1200);
}
document.addEventListener('click', function (e) {
var btn = e.target && e.target.closest ? e.target.closest('.m-copy') : null;
if (!btn) return;
var src = document.getElementById(btn.getAttribute('data-copy') || '');
var text = src ? (src.innerText || src.textContent || '') : '';
if (navigator.clipboard && navigator.clipboard.writeText) {
navigator.clipboard.writeText(text).then(function () { done(btn); }, function () { fallback(btn, text); });
} else { fallback(btn, text); }
});
function fallback(btn, text) {
try {
var ta = document.createElement('textarea'); ta.value = text; ta.setAttribute('readonly', '');
ta.style.position = 'fixed'; ta.style.opacity = '0'; document.body.appendChild(ta);
ta.select(); document.execCommand("copy"); document.body.removeChild(ta); done(btn);
} catch (err) { btn.textContent = '复制失败'; }
}
})();
</script>
</body>
</html>