aurora-admin
5ee5d829a4
Regression / regression (push) Canceled after 0s
本提交含两条并行工作线，因互相咬合（package.json scripts、regression.yml、 npm run build 链）无法按文件干净拆分，故合并为一次自洽提交。 ## 详情页减重（本轮主任务：修复「AI 干太重」） - 导航收敛：宽屏只用右侧目录、≤1200px 只用页内 sticky 导航，纯 CSS 媒体查询 实现（不引入 JS 宽度监听）。此前两套导航同时可见，active 状态互相打架。 - 入口去重：标题区由「查看示例/在线测试/契约 JSON」三个减为「在线测试」一个； 契约 JSON 归入实现资源；删除示例底部重复的「在线测试」。 - 示例工具栏：删除与目录锚点重复的示例下拉选择器；「全部展开代码」只在 示例数 >1 时出现（103 个组件里 49 个仅 1 个示例，此前恒显示）。 - 重复文案：示例区两句同义导语合并为一句。 - 首页 CTA 由 5 个减为 2 个（浏览组件/快速开始），测试总览入口挂到已有的 通过率统计卡上，不再另占 Hero 按钮。 - 统一详情取数：抽出 fetchDetail/loadDetail 作为 details/*.json 的唯一路径， FAQ 不再自行 fetch 一遍，与组件页共用缓存与失败兜底。 ## i18n - 删除 12 组重复键（含整段 FAQ 说明），字典 604 → 585 唯一键。 - 删除本次改动产生的 6 个死键。 - verify-i18n.mjs 新增 `unique dictionary keys` 断言：重复键在对象字面量里 是静默的后值覆盖，此前无从发现；现由门禁拦住。 ## 文档事实修正（实测为准） - TESTING/CONTRIBUTING：79 → 103 组件；旧断言数改为回指 tests/report.json。 - PLATFORMS：移动端 108 文件/18 端 → 282 文件/47 端；契约 5 → 47； 令牌 17 → 15；uni-app SFC 21 → 50。 - AGENTS：断言 1405/18 页 → 1464/103 页（PC）、807/47 页（移动端）。 - package.json：YOUR-ACCOUNT 占位 → gitea 实址与 kole-ui.mymoyu.top。 ## 品牌标识（并行会话成果，一并入库） - brand-mark.json 收归真源，build:brand 生成 favicon 与单色 SVG； PC 与移动端共用资产，verify:brand 24 条断言。 - regression.yml 增加 verify:brand 步骤。 ## 门禁与验收 新增工具：verify-component-page.mjs（86 条真实浏览器断言，随详情页改造同步 更新为「只允许一套导航可见」）、verify-brand-mark.mjs、lib/i18n-dead-keys.mjs （只读诊断）。 回归：PC 100%（1464/1464，103 页，N/A 50）· 移动端 100%（807/807，47 页）。 门禁：component-page 86 · i18n 17 · brand 24 · routes all · smoke all · theme OK · isolation 31 · nav all · examples 9 · api-docs 10 · mobile-docs 12。 已知未做：i18n 另有约 44 条历史死键（非本次产生），已记为 ROADMAP S8-P6； 顶栏与悬浮区的两个主题入口为刻意设计（verify-theme 断言其互斥），未删。
482 lines
32 KiB
HTML
482 lines
32 KiB
HTML
<!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>平台与端 — Kole UI Mobile</title>
|
||
<meta name="description" content="Kole UI 的平台 × 端两轴模型：PC / 移动两个平台，css / h5 / react / vue2 / vue3 / uni-app 六个端，以及两端之间的隔离规则与门禁。">
|
||
<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">组件总览</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 is-active" href="platform.html" aria-current="page">平台与端<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="component/mobile-button.html">按钮<em>Button</em></a>
|
||
<a class="m-side-link" href="component/mobile-divider.html">分割线<em>Divider</em></a>
|
||
<a class="m-side-link" href="component/mobile-icon.html">图标<em>Icon</em></a>
|
||
<a class="m-side-link" href="component/mobile-layout.html">布局<em>Layout</em></a>
|
||
<a class="m-side-link" href="component/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="component/navbar.html">顶部导航栏<em>NavBar</em></a>
|
||
<a class="m-side-link" href="component/tabbar.html">底部标签栏<em>TabBar</em></a>
|
||
<a class="m-side-link" href="component/mobile-grid.html">宫格<em>Grid</em></a>
|
||
<a class="m-side-link" href="component/mobile-steps.html">步骤条<em>Steps</em></a>
|
||
<a class="m-side-link" href="component/mobile-segmented.html">分段器<em>Segmented</em></a>
|
||
<a class="m-side-link" href="component/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="component/mobile-numberkeyboard.html">数字键盘<em>NumberKeyboard</em></a>
|
||
<a class="m-side-link" href="component/mobile-datepicker.html">日期选择器<em>DatePicker</em></a>
|
||
<a class="m-side-link" href="component/mobile-input.html">输入框<em>Input</em></a>
|
||
<a class="m-side-link" href="component/mobile-search.html">搜索框<em>Search</em></a>
|
||
<a class="m-side-link" href="component/mobile-stepper.html">步进器<em>Stepper</em></a>
|
||
<a class="m-side-link" href="component/mobile-switch.html">开关<em>Switch</em></a>
|
||
<a class="m-side-link" href="component/mobile-textarea.html">多行文本框<em>Textarea</em></a>
|
||
<a class="m-side-link" href="component/mobile-checkbox.html">多选框<em>Checkbox</em></a>
|
||
<a class="m-side-link" href="component/mobile-form.html">表单<em>Form</em></a>
|
||
<a class="m-side-link" href="component/mobile-radio.html">单选框<em>Radio</em></a>
|
||
<a class="m-side-link" href="component/mobile-rate.html">评分<em>Rate</em></a>
|
||
<a class="m-side-link" href="component/mobile-slider.html">滑动选择器<em>Slider</em></a>
|
||
<a class="m-side-link" href="component/mobile-cascader.html">级联选择器<em>Cascader</em></a>
|
||
<a class="m-side-link" href="component/mobile-colorpicker.html">颜色选择器<em>ColorPicker</em></a>
|
||
<a class="m-side-link" href="component/mobile-picker.html">选择器<em>Picker</em></a>
|
||
<a class="m-side-link" href="component/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="component/cell.html">单元格<em>Cell</em></a>
|
||
<a class="m-side-link" href="component/mobile-badge.html">徽标<em>Badge</em></a>
|
||
<a class="m-side-link" href="component/mobile-tag.html">标签<em>Tag</em></a>
|
||
<a class="m-side-link" href="component/mobile-avatar.html">头像<em>Avatar</em></a>
|
||
<a class="m-side-link" href="component/mobile-list.html">列表<em>List</em></a>
|
||
<a class="m-side-link" href="component/mobile-collapse.html">折叠面板<em>Collapse</em></a>
|
||
<a class="m-side-link" href="component/mobile-table.html">表格<em>Table</em></a>
|
||
<a class="m-side-link" href="component/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="component/actionsheet.html">动作面板<em>ActionSheet</em></a>
|
||
<a class="m-side-link" href="component/pullrefresh.html">下拉刷新<em>PullRefresh</em></a>
|
||
<a class="m-side-link" href="component/swipecell.html">滑动单元格<em>SwipeCell</em></a>
|
||
<a class="m-side-link" href="component/mobile-popup.html">弹出层<em>Popup</em></a>
|
||
<a class="m-side-link" href="component/mobile-toast.html">轻提示<em>Toast</em></a>
|
||
<a class="m-side-link" href="component/mobile-dialog.html">对话框<em>Dialog</em></a>
|
||
<a class="m-side-link" href="component/mobile-noticebar.html">通知栏<em>NoticeBar</em></a>
|
||
<a class="m-side-link" href="component/mobile-loading.html">加载<em>Loading</em></a>
|
||
<a class="m-side-link" href="component/mobile-progress.html">进度条<em>Progress</em></a>
|
||
<a class="m-side-link" href="component/mobile-message.html">消息通知<em>Message</em></a>
|
||
<a class="m-side-link" href="component/mobile-overlay.html">遮罩层<em>Overlay</em></a>
|
||
<a class="m-side-link" href="component/mobile-popover.html">弹出气泡<em>Popover</em></a>
|
||
</nav>
|
||
</details>
|
||
<main class="m-main">
|
||
<section class="m-hero">
|
||
<h1>平台与端</h1>
|
||
<p>组件库按<b>两个正交轴</b>组织：<b>平台</b>（<code>pc</code> / <code>mobile</code>）决定用哪些组件与命名空间；<b>端</b>（<code>css</code> / <code>h5 原生</code> / <code>react</code> / <code>vue2</code> / <code>vue3</code> / <code>uniapp</code>）决定同一组件在哪个技术栈里怎么实现。完整文档见仓库根 <code>PLATFORMS.md</code>。</p>
|
||
</section>
|
||
|
||
<section class="m-block">
|
||
<h2>覆盖矩阵</h2>
|
||
<table class="m-table">
|
||
<thead><tr><th>平台 ↓ ／ 端 →</th><th>css</th><th>h5 原生</th><th>react</th><th>vue2</th><th>vue3</th><th>uniapp</th></tr></thead>
|
||
<tbody>
|
||
<tr><th>移动端（47）</th><td>✅ 47</td><td>✅ 47</td><td>✅ 47</td><td>✅ 47</td><td>✅ 47</td><td>✅ 47</td></tr>
|
||
<tr><th>PC（103）</th><td>✅ 103</td><td>✅ 103</td><td>✅ 103</td><td>✅ 103</td><td>✅ 103</td><td>3 / 103（试点）</td></tr>
|
||
</tbody>
|
||
</table>
|
||
<p class="m-note">✅ = 该平台组件清单在此端已全覆盖；数字 = 已实现 / 总数。</p>
|
||
</section>
|
||
|
||
<section class="m-block">
|
||
<h2>uni-app 是一个端，不是第三个平台</h2>
|
||
<table class="m-table">
|
||
<thead><tr><th>列</th><th>实现位置</th><th>目标产物</th><th>关键约束</th></tr></thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>移动端 × uni-app</td>
|
||
<td><code>frameworks-mobile/*.uniapp.vue</code>（47 个）</td>
|
||
<td><code>app-plus</code>（App）/ <code>mp-weixin</code>（微信小程序）/ <code>h5</code></td>
|
||
<td>uni 基础组件（<code>view</code>/<code>text</code>）+ <code>rpx</code> + <b>touch 事件</b>（小程序与 App 端没有 DOM，也没有 PointerEvent）</td>
|
||
</tr>
|
||
<tr>
|
||
<td>PC × uni-app</td>
|
||
<td><code>frameworks-uniapp-pc/*.uniapp.vue</code>（3 个试点，见 ROADMAP S7-P26）</td>
|
||
<td>H5（PC 浏览器）/ PC 容器</td>
|
||
<td>类名与 PC 的 <code>frameworks/*.css</code> <b>逐字一致</b>（<code>btn</code> / <code>kole-input</code> / <code>kole-card</code>），令牌取 PC 的 <code>--kole-*</code>，尺寸保持 <code>px</code></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</section>
|
||
|
||
<section class="m-block">
|
||
<h2>目录与命名映射</h2>
|
||
<table class="m-table">
|
||
<thead><tr><th>维度</th><th>PC 端</th><th>移动端</th><th>共享</th></tr></thead>
|
||
<tbody>
|
||
<tr><td>实现目录</td><td><code>frameworks/</code>（515）</td><td><code>frameworks-mobile/</code>（282）</td><td>否</td></tr>
|
||
<tr><td>契约</td><td><code>.design_library/kole-ui/components/</code>（103）</td><td><code>.design_library/kole-ui-mobile/components/</code>（47）</td><td>否</td></tr>
|
||
<tr><td>索引（唯一真源）</td><td><code>components/index.json</code></td><td><code>kole-ui-mobile/components/index.json</code></td><td>否</td></tr>
|
||
<tr><td>类名前缀</td><td><code>kole-</code>（含既有短名 <code>btn</code>）</td><td><code>kole-m-</code>（状态类 <code>is-*</code>）</td><td>否</td></tr>
|
||
<tr><td>令牌前缀</td><td><code>--kole-*</code>（75）</td><td><code>--kole-m-*</code>（15）</td><td>颜色 / 字体 / 圆角 / 阴影同源（@import）</td></tr>
|
||
<tr><td>导出名</td><td><code>KoleButton</code></td><td><code>KoleMNavBar</code></td><td>否</td></tr>
|
||
<tr><td>测试页</td><td><code>tests/<slug>.html</code>（103）</td><td><code>tests/mobile/<slug>.html</code>（47）</td><td>共享断言引擎 <code>tests/_runtime.js</code></td></tr>
|
||
<tr><td>回归报告</td><td><code>tests/report.json</code></td><td><code>tests/mobile-report.json</code></td><td>否</td></tr>
|
||
<tr><td>文档站</td><td><code>site/</code>（SPA 路由）</td><td><code>site/m/</code>（静态页，不进 PC 路由表）</td><td>否</td></tr>
|
||
<tr><td>自包含数据</td><td><code>site/data.json</code></td><td><code>site/m/data.mobile.json</code></td><td>否</td></tr>
|
||
<tr><td>分发产物</td><td><code>dist/components|react|vue3|vue2</code></td><td><code>dist/mobile/*</code></td><td>否</td></tr>
|
||
<tr><td>构建脚本</td><td><code>build-site.ps1</code> + <code>build-dist.mjs</code></td><td><code>build-mobile.mjs</code> + <code>build-uniapp.mjs</code></td><td>否</td></tr>
|
||
</tbody>
|
||
</table>
|
||
</section>
|
||
|
||
<section class="m-block">
|
||
<h2>隔离规则（硬约束）</h2>
|
||
<ol class="m-steps">
|
||
<li>移动端实现只能在 <code>frameworks-mobile/</code>；PC 实现只能在 <code>frameworks/</code>。两端的文件数都有断言（395 / 282）。</li>
|
||
<li>移动端类名只能是 <code>kole-m-<name></code> 或状态类 <code>is-<state></code>；移动端样式不得出现硬编码十六进制颜色。</li>
|
||
<li>移动端样式只能引用 <code>--kole-*</code> 或 <code>--kole-m-*</code> 令牌，且令牌必须真实存在。</li>
|
||
<li><b>PC 侧的目录、数据、测试、分发里不得出现任何移动端痕迹</b>（零 <code>kole-m-</code> 命中、零 <code>frameworks-mobile/</code> 引用）。</li>
|
||
<li>移动端构建脚本自带写入守卫：<code>build-mobile.mjs</code> 只允许写 <code>site/m/</code>、<code>tests/mobile/</code>、<code>dist/mobile/</code>；<code>build-uniapp.mjs</code> 只允许写 <code>dist/uniapp-pc/</code>。越界直接抛错退出。</li>
|
||
<li>PC 的 <code>site/data.json</code>（一次请求拿到全部 PC 组件）保持不变；移动端另起 <code>site/m/data.mobile.json</code>，两端互不引用。</li>
|
||
</ol>
|
||
</section>
|
||
|
||
<section class="m-block">
|
||
<h2>门禁命令</h2>
|
||
<table class="m-table">
|
||
<thead><tr><th>命令</th><th>检查什么</th></tr></thead>
|
||
<tbody>
|
||
<tr><td><code>npm run verify:isolation</code></td><td>PC 零污染 / 移动端自洽（6 端文件齐全、契约字段完整、类名与令牌前缀合规）/ 分发隔离（PC 聚合样式无移动端类、manifest 与索引一致、exports 两套并存）</td></tr>
|
||
<tr><td><code>npm run verify:uniapp</code></td><td>8 个 uni-app SFC：三段结构 / <code>node --check</code> 语法 / 标签配平 / 禁 DOM API / 手势必须 touch / 只用 uni 基础组件 / 前缀隔离 / 单位策略</td></tr>
|
||
<tr><td><code>npm run verify:mobile-docs</code></td><td>本站的完整性：每个组件页的必备小节、侧栏是否列全、契约 API 是否与 6 端源码逐名一致、每个声明的端是否有代码块</td></tr>
|
||
<tr><td><code>npm run verify:mobile-site</code></td><td>浏览器实测：HTTP 200 / 控制台 0 错误 / 演示帧真实渲染 / 令牌生效 / 未引 PC 站样式 / 320–768px 无横向溢出</td></tr>
|
||
<tr><td><code>npm run regression:mobile</code></td><td>移动端断言回归（含触控行为断言），报告落 <code>tests/mobile-report.json</code></td></tr>
|
||
<tr><td><code>npm run regression</code></td><td>PC 侧断言回归（103 页）—— 改移动端后也必须保持 100%</td></tr>
|
||
</tbody>
|
||
</table>
|
||
</section>
|
||
|
||
<section class="m-block">
|
||
<h2>新增一个移动端组件（六步）</h2>
|
||
<ol class="m-steps">
|
||
<li>在 <code>.design_library/kole-ui-mobile/spec/移动端规格.md</code> 补一节：用途 / 结构 / 变体维度 / 状态 / 交互与触控 / 无障碍 / doNotInvent / unknowns —— <b>规格是契约的授权来源，先写规格再写代码</b>。</li>
|
||
<li>在 <code>.design_library/kole-ui-mobile/components/index.json</code> 登记：slug（不得与 PC 的 103 个撞名）、frameworksPrefix、category、specSection、contract、files（<b>6 个端的文件名必须全部声明</b>）。</li>
|
||
<li>写 6 个端实现到 <code>frameworks-mobile/</code>：<code><Prefix>.{css,html,jsx,vue2.vue,vue3.vue,uniapp.vue}</code>。html 是演示页，需含 <code>.demo</code> 容器与 <code>data-assert</code> / <code>data-behavior</code>。</li>
|
||
<li>写契约 <code>components/<slug>.json</code>：<code>sourceKind: authored-spec</code>、<code>provenance: authored-in-repo</code>，usageHints / anatomy / interaction / accessibility 逐字取自规格，<code>api</code> 与各端源码逐名一致。</li>
|
||
<li><code>npm run build:mobile</code> 重建数据、文档站、测试页与分发包。</li>
|
||
<li><code>npm run verify:isolation && npm run verify:uniapp && npm run verify:mobile-docs && npm run regression:mobile</code> 全绿才算完成。</li>
|
||
</ol>
|
||
</section>
|
||
|
||
<footer class="m-foot">
|
||
<p>生成物：本页由 <code>node tools/build-mobile.mjs</code> 生成，请勿手改。</p>
|
||
<p>权威文档：仓库根 <code>PLATFORMS.md</code> · 移动端规格：<code>.design_library/kole-ui-mobile/spec/移动端规格.md</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>
|