Files
aurora-admin/site/m/component/mobile-radio.html
T
aurora-admin f1fbfc2ddb
Regression / regression (push) Canceled after 0s
feat(品牌标识): 几何 K 图标(favicon/顶栏标记/theme-color) + 并行会话成果入库
## 品牌标识(本次会话)

起因:品牌此前没有任何图形标识 —— 唯一 favicon 是内联 data-URI 里的字母「A」,
那是 v2.0.0「Aurora Admin → Kole UI」改名漏掉的一处(PC 顶栏也是「A」,
移动端站已是「K」;移动端文档站则完全没有 favicon)。

- 几何:24 网格三个互不接触的笔画(竖 + 两斜),圆头描边;
  描边 2.25 → 16px 标签页尺寸下正好 1.5px = 规范原文「描边1.5px」
- 取色分两套(刻意):favicon 硬编码品牌蓝/白(渲染在浏览器标签栏,不继承 kole-dark);
  顶栏标记走 currentColor(实测暗色下自动转 rgb(20,22,28))
- 新增 theme-color 双条(light #FFFFFF / dark #1C1F26,取 --kole-color-card-bg)
- 修 site/app.js hero 标语 KOLE ADMIN → KOLE UI(改名变形残留)
- 移动端 7 个模板补 favicon(此前计数 0)

验收:门禁 9 条全 OK(site-routing/site-routes/mobile-docs/mobile-site/isolation/
theme/nav/i18n/icons);PC 回归 1464/1464 · 移动端 807/807,各连跑 8 次一致;
两端 favicon 405 字节逐字节一致;PC 站控制台错误 1→0。

## 并行会话成果(本次一并入库)

- 图标系统:2576 图标(TDesign/Element Plus,MIT)+ 11 端注入 + 5 个构建门禁工具
  + IconPreview 预览页 + ICON-SPEC.md 冻结规格
- 移动端平台:47 组件 × 6 端 + 文档站 53 页 + 隔离门禁
- PC 组件:103 个大后台组件 / 组件11 批次
- uni-app:PC 端试点 + 移动端端实现 + 真实编译验证

## 工程

- .gitignore 补 .scratch/ 与 .zcode-preexisting-*.txt(会话中间产物,实测 9.1MB,不入库)
- CHANGELOG 补品牌标识条目
- ROADMAP 登 S8-P4(品牌标识任务包 + og:image/apple-touch-icon 未做部分)
2026-09-21 10:05:48 +08:00

1659 lines
87 KiB
HTML
Raw 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="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%2024%2024'%3E%3Crect%20width='24'%20height='24'%20rx='6'%20fill='%232F54EB'/%3E%3Cg%20fill='none'%20stroke='%23FFFFFF'%20stroke-width='2.25'%20stroke-linecap='round'%20stroke-linejoin='round'%3E%3Cpath%20d='M7%205.5V18.5'/%3E%3Cpath%20d='M17%205.5l-6.25%204.06'/%3E%3Cpath%20d='M10.75%2014.44L17%2018.5'/%3E%3C/g%3E%3C/svg%3E">
<meta name="theme-color" content="#FFFFFF" media="(prefers-color-scheme: light)">
<meta name="theme-color" content="#1C1F26" media="(prefers-color-scheme: dark)">
<title>单选框 Radio — Kole UI Mobile</title>
<meta name="description" content="单选框 Radio:移动端组件(6 端实现:CSS / H5 原生 / React / Vue 2 / Vue 3 / uni-app)。与 PC 端物理隔离:类名 kole-m-、令牌 --kole-m-。规格来源:移动端规格 33 · 单选框 Radio。">
<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" aria-hidden="true"><svg width="17" height="17" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.25" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M7 5.5V18.5"/><path d="M17 5.5l-6.25 4.06"/><path d="M10.75 14.44L17 18.5"/></svg></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 is-active" href="mobile-radio.html" aria-current="page">单选框<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" href="mobile-collapse.html">折叠面板<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;">Radio</span></h1>
<p>在一组互斥选项里选且只选一项(支付方式、配送时效、发票类型)</p>
<p style="margin-top: 8px;" class="m-chips">
<span class="m-chip m">数据录入</span>
<span class="m-chip">规格 33 · 单选框 Radio</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-radio.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/Radio.html?demo=&lt;id&gt;</code>(只显示该演示块),代码是该演示块在演示页里的原文,可复制。全部演示同屏可看 <a href="../../../frameworks-mobile/Radio.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">orientation=vertical</span></div>
<p class="m-demo-desc">互斥:选中一项会自动清掉同组其它项;整行热区不小于 44px。</p>
<div class="m-demo-stage"><iframe src="../../../frameworks-mobile/Radio.html?demo=basic" title="单选框 Radio · 单选组" loading="lazy"></iframe></div>
<details class="m-details"><summary>查看代码(演示页原文 · 18 行)</summary>
<div class="m-code"><div class="m-code-head"><span>frameworks-mobile/Radio.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;单选组(互斥:选中一项会自动清掉同组其它项;整行热区 ≥44px)&lt;/p&gt;
&lt;div class=&quot;kole-m-radio-group&quot; id=&quot;rg-basic&quot; role=&quot;radiogroup&quot; aria-label=&quot;支付方式&quot; data-value=&quot;wechat&quot; data-assert=&quot;radio-basic&quot;&gt;
&lt;button class=&quot;kole-m-radio is-checked&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;true&quot; data-radio=&quot;wechat&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;微信支付&lt;/span&gt;
&lt;/button&gt;
&lt;button class=&quot;kole-m-radio&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;false&quot; data-radio=&quot;alipay&quot;
data-behavior=&quot;click-sets-attr:#rg-basic|data-value|alipay&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;支付宝&lt;/span&gt;
&lt;/button&gt;
&lt;button class=&quot;kole-m-radio&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;false&quot; data-radio=&quot;card&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;对公转账&lt;/span&gt;
&lt;/button&gt;
&lt;/div&gt;
&lt;/section&gt;</code></pre></div>
</details>
</div>
<div class="m-demo" id="demo-horizontal">
<div class="m-demo-head"><span class="m-demo-title">横向排列</span><span class="m-chip">orientation=horizontal</span></div>
<p class="m-demo-desc">orientation=horizontal:值少、文案短时用,不再画分隔线。</p>
<div class="m-demo-stage"><iframe src="../../../frameworks-mobile/Radio.html?demo=horizontal" title="单选框 Radio · 横向排列" loading="lazy"></iframe></div>
<details class="m-details"><summary>查看代码(演示页原文 · 17 行)</summary>
<div class="m-code"><div class="m-code-head"><span>frameworks-mobile/Radio.html · horizontal</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;horizontal&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;横向排列(orientation=horizontal:值少、文案短时用,不再画分隔线)&lt;/p&gt;
&lt;div class=&quot;demo-pad&quot; style=&quot;display: flex; justify-content: flex-start;&quot;&gt;
&lt;div class=&quot;kole-m-radio-group kole-m-radio-group--horizontal&quot; id=&quot;rg-horizontal&quot; role=&quot;radiogroup&quot;
aria-label=&quot;配送方式&quot; data-value=&quot;standard&quot; data-assert=&quot;radio-horizontal&quot;&gt;
&lt;button class=&quot;kole-m-radio is-checked&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;true&quot; data-radio=&quot;standard&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;标准&lt;/span&gt;
&lt;/button&gt;
&lt;button class=&quot;kole-m-radio&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;false&quot; data-radio=&quot;express&quot;
data-behavior=&quot;click-sets-attr:#rg-horizontal|data-value|express&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;加急&lt;/span&gt;
&lt;/button&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/section&gt;</code></pre></div>
</details>
</div>
<div class="m-demo" id="demo-button">
<div class="m-demo-head"><span class="m-demo-title">胶囊按钮式</span><span class="m-chip">button=true</span></div>
<p class="m-demo-desc">button=true:无圆点,选中态用品牌色边框 + 浅底。</p>
<div class="m-demo-stage"><iframe src="../../../frameworks-mobile/Radio.html?demo=button" title="单选框 Radio · 胶囊按钮式" loading="lazy"></iframe></div>
<details class="m-details"><summary>查看代码(演示页原文 · 9 行)</summary>
<div class="m-code"><div class="m-code-head"><span>frameworks-mobile/Radio.html · button</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;button&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;胶囊按钮式(button=true:无圆点,选中态用品牌色边框 + 浅底)&lt;/p&gt;
&lt;div class=&quot;demo-pad&quot; style=&quot;display: flex; gap: var(--kole-space-8);&quot; data-assert=&quot;radio-button&quot;&gt;
&lt;button class=&quot;kole-m-radio kole-m-radio--button&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;false&quot; id=&quot;rd-pill-a&quot;
data-behavior=&quot;click-toggles-class:#rd-pill-a|is-checked&quot;&gt;全部&lt;/button&gt;
&lt;button class=&quot;kole-m-radio kole-m-radio--button is-checked&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;true&quot;&gt;已发货&lt;/button&gt;
&lt;button class=&quot;kole-m-radio kole-m-radio--button&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;false&quot;&gt;待付款&lt;/button&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-checked">
<div class="m-demo-head"><span class="m-demo-title">选中与未选中</span><span class="m-chip">状态 checked</span></div>
<p class="m-demo-desc">两者不能只靠颜色区分:内圈实心点 + aria-checked 双通道。</p>
<div class="m-demo-stage"><iframe src="../../../frameworks-mobile/Radio.html?demo=checked" title="单选框 Radio · 选中与未选中" loading="lazy"></iframe></div>
<details class="m-details"><summary>查看代码(演示页原文 · 16 行)</summary>
<div class="m-code"><div class="m-code-head"><span>frameworks-mobile/Radio.html · checked</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;checked&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;选中与未选中(两者不能只靠颜色区分:内圈实心点 + aria-checked 双通道)&lt;/p&gt;
&lt;div class=&quot;demo-pad&quot; data-assert=&quot;radio-checked&quot;&gt;
&lt;div class=&quot;kole-m-radio-group&quot;&gt;
&lt;button class=&quot;kole-m-radio&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;false&quot; id=&quot;rd-plain&quot;
data-behavior=&quot;click-toggles-class:#rd-plain|is-checked&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;未选中:空心环(点它即选中,同时清掉上一项)&lt;/span&gt;
&lt;/button&gt;
&lt;button class=&quot;kole-m-radio is-checked&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;true&quot; id=&quot;rd-single&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;选中:实心内圈&lt;/span&gt;
&lt;/button&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=true</span></div>
<p class="m-demo-desc">置灰且不响应:原生 disabled 让读屏播报不可用、键盘跳过。</p>
<div class="m-demo-stage"><iframe src="../../../frameworks-mobile/Radio.html?demo=disabled" title="单选框 Radio · 禁用项" loading="lazy"></iframe></div>
<details class="m-details"><summary>查看代码(演示页原文 · 16 行)</summary>
<div class="m-code"><div class="m-code-head"><span>frameworks-mobile/Radio.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;禁用项(置灰且不响应:原生 disabled 让读屏播报不可用、键盘跳过)&lt;/p&gt;
&lt;div class=&quot;kole-m-radio-group&quot; role=&quot;radiogroup&quot; aria-label=&quot;发票类型&quot; data-assert=&quot;radio-disabled&quot;&gt;
&lt;button class=&quot;kole-m-radio is-checked&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;true&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;电子普通发票&lt;/span&gt;
&lt;/button&gt;
&lt;button class=&quot;kole-m-radio&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;false&quot; aria-disabled=&quot;true&quot; disabled&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;
增值税专用发票
&lt;span class=&quot;kole-m-radio__desc&quot;&gt;需先完成企业认证&lt;/span&gt;
&lt;/span&gt;
&lt;/button&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>options</code></td><td><code>Array</code></td><td><code>[]</code></td><td>选项数组,每项 { value, label, desc, disabled }(规格 §33.2)</td><td>N</td></tr>
<tr><td><code>value</code></td><td><code>string</code></td><td><code>''</code></td><td>受控选中值,与 aria-checked 同步写(规格 §33.5)</td><td>N</td></tr>
<tr><td><code>orientation</code></td><td><code>'vertical' | 'horizontal'</code></td><td><code>'vertical'</code></td><td>变体 orientation:纵向(画分隔线)还是横向排列(规格 §33.3)</td><td>N</td></tr>
<tr><td><code>button</code></td><td><code>boolean</code></td><td><code>false</code></td><td>变体 button:胶囊标签式(无圆点),用于筛选条(规格 §33.3)</td><td>N</td></tr>
<tr><td><code>disabled</code></td><td><code>boolean</code></td><td><code>false</code></td><td>状态 disabled:整组置灰且不可聚焦(规格 §33.4)</td><td>N</td></tr>
<tr><td><code>label</code></td><td><code>string</code></td><td><code>'单选项'</code></td><td>分组名称,落到 radiogroup 的 aria-label(规格 §33.6)</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>(value)</code></td><td>选中某项时触发,回传该项的值(规格 §33.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>额外选项内容(宿主自己渲染的项,追在 options 之后,规格 §33.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-radio-size</code></td><td><code>20px</code></td><td>圆点直径(视觉尺寸)</td></tr>
<tr><td><code>--kole-m-radio-gap</code></td><td><code>var(--kole-space-12)</code></td><td>圆点与文字的间距</td></tr>
</tbody>
</table>
</section>
<section class="m-block">
<h2 id="usage">何时使用</h2>
<ul>
<li>在一组互斥选项里选且只选一项(支付方式、配送时效、发票类型)</li>
<li>触屏没有鼠标悬停可以预告状态,选中必须同时有形状差异(圆点内圈实心)与 aria-checked,不能只靠颜色</li>
<li>整行(圆点 + 文字)都是热区,行高不小于 44px</li>
<li>一次触摸即选中,不需要二次确认;选中后不能再点回空值</li>
<li>互斥由组件负责:选中一项会立即清掉同组其它项的选中态,不留下两个选中</li>
</ul>
</section>
<section class="m-block">
<h2 id="interaction">交互与触控</h2>
<ul>
<li>整行(圆点 + 文字)都是热区,行高不小于 44px;横向组里每项自身也保持这个边长</li>
<li>一次触摸即选中,不需要二次确认;选中后**不能**再点回空值(需要清空由宿主提供额外的「清除」动作)</li>
<li>互斥由组件负责:选中一项会立即清掉同组其它项的选中态,不留下两个选中</li>
<li>切换动效是圆点内圈 150ms 缩放;减少动态偏好下瞬时切换</li>
<li>选中后立即触发 change 事件,回传该项的值</li>
</ul>
</section>
<section class="m-block">
<h2 id="a11y">无障碍</h2>
<ul>
<li>组用 role=&quot;radiogroup&quot; + aria-label 说明分组名称</li>
<li>每项是原生 button + role=&quot;radio&quot; + aria-checked(读屏会播报「单选按钮,已选中/未选中」)</li>
<li>圆点与内圈是纯装饰,对读屏隐藏(aria-hidden),语义全靠 role=&quot;radio&quot;</li>
<li>禁用项用原生 disabled 并补 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-checkbox.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;">Checkbox</em></td><td>选项之间可以同时成立(多选、含全选)时用 Checkbox;只有一项能成立时才用 Radio</td></tr>
<tr><td><a href="mobile-switch.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;">Switch</em></td><td>「开 / 关」这类即时生效的二值状态用 Switch(即时切换);需要随表单一起提交的互斥选择用 Radio</td></tr>
<tr><td><a href="mobile-form.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;">Form</em></td><td>单选组作为表单里的一个字段时,标签、必填星号与错误提示由 Form 的 item 提供</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>横向组自动换行的列数策略(由宿主按文案长度决定,组件只负责 flex-wrap)</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>
<tr><td><span class="m-chip">规格未定</span></td><td>圆点尺寸是否随字号一起放大(当前固定 20px)</td></tr>
<tr><td><span class="m-chip">规格未定</span></td><td>desc 说明行是否允许两行以上(当前单行省略)</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>group</code></td><td>根元素,role=&quot;radiogroup&quot; + aria-label 说明这组在选什么</td></tr>
<tr><td><code>item</code></td><td>单个选项,整行都是热区(原生 button + role=&quot;radio&quot;)</td></tr>
<tr><td><code>icon</code></td><td>圆点,未选中是空心环、选中是实心圆 + 内圈反色点</td></tr>
<tr><td><code>label</code></td><td>选项文字,占满剩余宽度</td></tr>
<tr><td><code>desc</code></td><td>可选说明行,跟在文字下方(如「需先完成企业认证」)</td></tr>
<tr><td><code>state</code></td><td>选中态 is-checked 与 aria-checked 双写</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>orientation</code></td><td>vertical / horizontal</td><td><div><b>vertical</b> <span class="m-none">(由数据驱动,无专属类)</span></div><div><b>horizontal</b> <span class="m-cls">.kole-m-radio-group--horizontal</span></div></td></tr>
<tr><td><code>button</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-radio--button</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>orientation=vertical · button=false</code></td><td>默认(圆点 + 文字,纵向排列并画分隔线)</td></tr>
<tr><td><code>orientation=horizontal · button=false</code></td><td>横向排列(值少、文案短时用)</td></tr>
<tr><td><code>orientation=vertical · button=true</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 m" title="可点区域最小边长">--kole-m-touch-target</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-brand-bg</span>
<span class="m-chip inherit" title="卡片背景">--kole-color-card-bg</span>
<span class="m-chip inherit" title="禁用背景(按钮禁用态)">--kole-color-disabled-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="反色文字(品牌色背景上的白字)">--kole-color-text-inverse</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-space-12</span>
<span class="m-chip inherit" title="">--kole-space-16</span>
<span class="m-chip inherit" title="">--kole-space-8</span>
<span class="m-chip" title="组件级变量(可在业务侧覆盖)">--kole-m-radio-gap</span>
<span class="m-chip" title="组件级变量(可在业务侧覆盖)">--kole-m-radio-size</span>
</div>
</section>
<section class="m-block">
<h2 id="sources">6 端源码</h2>
<p class="m-sub">同一组件的六份实现(生产环境的类名与结构一致,差异只在技术栈写法与单位)。点开查看,右侧可复制。</p>
<details class="m-details">
<summary>frameworks-mobile/Radio.css · 纯样式(CSS) · 152 行</summary>
<div class="m-code">
<div class="m-code-head"><span>frameworks-mobile/Radio.css</span><button class="m-copy" type="button" data-copy="code-199">复制</button></div>
<pre id="code-199"><code>/* Kole UI Mobile · Radio 样式 — 对齐移动端规格 §33
单选框:一组里只能选一项。触屏上没有鼠标悬停,所以选中态必须同时有
形状差异(内圈实心点)与 aria-checked,不能只靠颜色。
整行(圆点 + 文字)都是热区,行高不小于 44px;横向组里每项自身仍要够 44px。 */
.kole-m-radio-group {
/* 组件级变量:业务侧可在容器上覆盖 */
--kole-m-radio-size: 20px; /* 圆点直径(视觉尺寸) */
--kole-m-radio-gap: var(--kole-space-12); /* 圆点与文字的间距 */
box-sizing: border-box;
display: flex;
flex-direction: column;
width: 100%;
background: var(--kole-color-card-bg);
color: var(--kole-color-text-body);
font-family: inherit;
font-size: var(--kole-m-font-size-body);
line-height: 1.4;
}
/* 变体 orientation=horizontal:横向排列(值少、文案短时用) */
.kole-m-radio-group--horizontal {
flex-direction: row;
flex-wrap: wrap;
align-items: center;
}
/* 组内相邻项的分隔线:只在纵向排列时画(横向排列靠间距分组) */
.kole-m-radio-group:not(.kole-m-radio-group--horizontal) .kole-m-radio + .kole-m-radio {
border-top: 1px solid var(--kole-color-border);
}
.kole-m-radio {
box-sizing: border-box;
display: flex;
align-items: center;
gap: var(--kole-m-radio-gap);
width: 100%;
min-height: var(--kole-m-touch-target);
padding: var(--kole-space-12) var(--kole-m-gutter);
margin: 0;
border: 0;
background: var(--kole-color-card-bg);
color: var(--kole-color-text-body);
font-family: inherit;
font-size: inherit;
line-height: 1.4;
text-align: start;
cursor: pointer;
touch-action: manipulation;
}
/* 横向组里的项:宽自适应,左右留白收窄(组自身负责外边距) */
.kole-m-radio-group--horizontal .kole-m-radio {
width: auto;
padding-inline: var(--kole-space-12);
}
.kole-m-radio:active:not(:disabled) { background: var(--kole-color-table-header-bg); }
/* 圆点:未选中是空心环,选中是实心圆 + 内圈反色点(形状差异,不只靠颜色) */
.kole-m-radio__icon {
position: relative;
flex: 0 0 auto;
box-sizing: border-box;
width: var(--kole-m-radio-size);
height: var(--kole-m-radio-size);
border: 1px solid var(--kole-color-text-placeholder);
border-radius: 50%;
background: var(--kole-color-card-bg);
transition: border-color 150ms var(--kole-ease-standard), background-color 150ms var(--kole-ease-standard);
}
.kole-m-radio__icon::after {
content: '';
position: absolute;
inset: 3px;
border-radius: 50%;
background: var(--kole-color-text-inverse);
transform: scale(0);
transition: transform 150ms var(--kole-ease-standard);
}
/* 状态 checked:圆环填品牌色,内圈出现反色实心点 */
.kole-m-radio.is-checked { color: var(--kole-color-text-title); }
.kole-m-radio.is-checked .kole-m-radio__icon {
border-color: var(--kole-color-brand);
background: var(--kole-color-brand);
}
.kole-m-radio.is-checked .kole-m-radio__icon::after { transform: scale(1); }
.kole-m-radio__label {
flex: 1 1 auto;
min-width: 0;
display: flex;
flex-direction: column;
}
/* 说明行:标签下的一行小字(单行省略,不把行撑成两行以上) */
.kole-m-radio__desc {
overflow: hidden;
white-space: nowrap;
text-overflow: ellipsis;
font-size: var(--kole-m-font-size-label);
color: var(--kole-color-text-secondary);
}
/* 变体 button=true:胶囊标签式(筛选条一类的轻量场合,无圆点) */
.kole-m-radio--button {
width: auto;
min-height: var(--kole-m-touch-target);
padding: var(--kole-space-8) var(--kole-space-16);
border: 1px solid var(--kole-color-border);
border-radius: 999px;
background: var(--kole-color-card-bg);
color: var(--kole-color-text-secondary);
font-size: var(--kole-m-font-size-label);
}
.kole-m-radio--button .kole-m-radio__icon { display: none; }
.kole-m-radio--button.is-checked {
border-color: var(--kole-color-brand);
background: var(--kole-color-brand-bg);
color: var(--kole-color-brand);
}
/* 状态 disabled:置灰且不可聚焦(原生 disabled) */
.kole-m-radio:disabled {
color: var(--kole-color-text-disabled);
background: var(--kole-color-card-bg);
cursor: not-allowed;
}
.kole-m-radio:disabled .kole-m-radio__icon {
border-color: var(--kole-color-text-disabled);
background: var(--kole-color-disabled-bg);
}
.kole-m-radio--button:disabled {
border-color: var(--kole-color-border);
background: var(--kole-color-disabled-bg);
color: var(--kole-color-text-disabled);
}
.kole-m-radio:focus-visible {
outline: 2px solid var(--kole-color-focus-ring);
outline-offset: -2px;
}
</code></pre>
</div>
</details>
<details class="m-details">
<summary>frameworks-mobile/Radio.html · H5 原生(无框架) · 160 行</summary>
<div class="m-code">
<div class="m-code-head"><span>frameworks-mobile/Radio.html</span><button class="m-copy" type="button" data-copy="code-200">复制</button></div>
<pre id="code-200"><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 · Radio(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;Radio.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-pad { padding: var(--kole-m-gutter); background: var(--kole-color-card-bg); border-block: 1px solid var(--kole-color-border); }
.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;单选组(互斥:选中一项会自动清掉同组其它项;整行热区 ≥44px)&lt;/p&gt;
&lt;div class=&quot;kole-m-radio-group&quot; id=&quot;rg-basic&quot; role=&quot;radiogroup&quot; aria-label=&quot;支付方式&quot; data-value=&quot;wechat&quot; data-assert=&quot;radio-basic&quot;&gt;
&lt;button class=&quot;kole-m-radio is-checked&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;true&quot; data-radio=&quot;wechat&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;微信支付&lt;/span&gt;
&lt;/button&gt;
&lt;button class=&quot;kole-m-radio&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;false&quot; data-radio=&quot;alipay&quot;
data-behavior=&quot;click-sets-attr:#rg-basic|data-value|alipay&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;支付宝&lt;/span&gt;
&lt;/button&gt;
&lt;button class=&quot;kole-m-radio&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;false&quot; data-radio=&quot;card&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;对公转账&lt;/span&gt;
&lt;/button&gt;
&lt;/div&gt;
&lt;/section&gt;
&lt;section class=&quot;demo-block&quot; data-demo=&quot;checked&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;选中与未选中(两者不能只靠颜色区分:内圈实心点 + aria-checked 双通道)&lt;/p&gt;
&lt;div class=&quot;demo-pad&quot; data-assert=&quot;radio-checked&quot;&gt;
&lt;div class=&quot;kole-m-radio-group&quot;&gt;
&lt;button class=&quot;kole-m-radio&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;false&quot; id=&quot;rd-plain&quot;
data-behavior=&quot;click-toggles-class:#rd-plain|is-checked&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;未选中:空心环(点它即选中,同时清掉上一项)&lt;/span&gt;
&lt;/button&gt;
&lt;button class=&quot;kole-m-radio is-checked&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;true&quot; id=&quot;rd-single&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;选中:实心内圈&lt;/span&gt;
&lt;/button&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/section&gt;
&lt;section class=&quot;demo-block&quot; data-demo=&quot;horizontal&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;横向排列(orientation=horizontal:值少、文案短时用,不再画分隔线)&lt;/p&gt;
&lt;div class=&quot;demo-pad&quot; style=&quot;display: flex; justify-content: flex-start;&quot;&gt;
&lt;div class=&quot;kole-m-radio-group kole-m-radio-group--horizontal&quot; id=&quot;rg-horizontal&quot; role=&quot;radiogroup&quot;
aria-label=&quot;配送方式&quot; data-value=&quot;standard&quot; data-assert=&quot;radio-horizontal&quot;&gt;
&lt;button class=&quot;kole-m-radio is-checked&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;true&quot; data-radio=&quot;standard&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;标准&lt;/span&gt;
&lt;/button&gt;
&lt;button class=&quot;kole-m-radio&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;false&quot; data-radio=&quot;express&quot;
data-behavior=&quot;click-sets-attr:#rg-horizontal|data-value|express&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;加急&lt;/span&gt;
&lt;/button&gt;
&lt;/div&gt;
&lt;/div&gt;
&lt;/section&gt;
&lt;section class=&quot;demo-block&quot; data-demo=&quot;button&quot;&gt;
&lt;p class=&quot;demo-label&quot;&gt;胶囊按钮式(button=true:无圆点,选中态用品牌色边框 + 浅底)&lt;/p&gt;
&lt;div class=&quot;demo-pad&quot; style=&quot;display: flex; gap: var(--kole-space-8);&quot; data-assert=&quot;radio-button&quot;&gt;
&lt;button class=&quot;kole-m-radio kole-m-radio--button&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;false&quot; id=&quot;rd-pill-a&quot;
data-behavior=&quot;click-toggles-class:#rd-pill-a|is-checked&quot;&gt;全部&lt;/button&gt;
&lt;button class=&quot;kole-m-radio kole-m-radio--button is-checked&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;true&quot;&gt;已发货&lt;/button&gt;
&lt;button class=&quot;kole-m-radio kole-m-radio--button&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;false&quot;&gt;待付款&lt;/button&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;禁用项(置灰且不响应:原生 disabled 让读屏播报不可用、键盘跳过)&lt;/p&gt;
&lt;div class=&quot;kole-m-radio-group&quot; role=&quot;radiogroup&quot; aria-label=&quot;发票类型&quot; data-assert=&quot;radio-disabled&quot;&gt;
&lt;button class=&quot;kole-m-radio is-checked&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;true&quot;&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;电子普通发票&lt;/span&gt;
&lt;/button&gt;
&lt;button class=&quot;kole-m-radio&quot; type=&quot;button&quot; role=&quot;radio&quot; aria-checked=&quot;false&quot; aria-disabled=&quot;true&quot; disabled&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;
增值税专用发票
&lt;span class=&quot;kole-m-radio__desc&quot;&gt;需先完成企业认证&lt;/span&gt;
&lt;/span&gt;
&lt;/button&gt;
&lt;/div&gt;
&lt;/section&gt;
&lt;/div&gt;
&lt;script&gt;
/* 演示页脚本:真实互斥。
- 点一项:该项 is-checked + aria-checked=&quot;true&quot;,同组其它项一律清掉
- 组根同时写 data-value(当前值),供宿主持久化
真实业务里这份状态由宿主管理(受控 value + change 事件),此处是最小可运行实现。 */
(function () {
Array.prototype.forEach.call(document.querySelectorAll('.kole-m-radio-group'), function (group) {
var items = Array.prototype.slice.call(group.querySelectorAll('.kole-m-radio'));
if (!items.length) return;
function select(target) {
items.forEach(function (it) {
var on = it === target;
it.classList.toggle('is-checked', on);
it.setAttribute('aria-checked', on ? 'true' : 'false');
});
group.setAttribute('data-value', target.getAttribute('data-radio') || '');
}
group.addEventListener('click', function (e) {
var btn = e.target.closest ? e.target.closest('.kole-m-radio') : null;
if (!btn || !group.contains(btn)) return;
if (btn.disabled || btn.getAttribute('aria-disabled') === 'true') return;
select(btn);
});
});
/* 独立胶囊按钮(不组成 radiogroup):点一下切自己的选中态 */
Array.prototype.forEach.call(document.querySelectorAll('.kole-m-radio--button'), function (btn) {
if (btn.closest('.kole-m-radio-group') || btn.disabled) return;
btn.addEventListener('click', function () {
btn.classList.toggle('is-checked');
btn.setAttribute('aria-checked', btn.classList.contains('is-checked') ? 'true' : 'false');
});
});
})();
&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/Radio.jsx · React · 65 行</summary>
<div class="m-code">
<div class="m-code-head"><span>frameworks-mobile/Radio.jsx</span><button class="m-copy" type="button" data-copy="code-201">复制</button></div>
<pre id="code-201"><code>import React from 'react';
import './Radio.css';
/* 单选框(移动端)— 规格 §33
一组里只能选一项(互斥由本组件负责:选中一项会清掉同组其它项)。
触屏上没有鼠标悬停,选中态必须同时有形状差异(内圈实心点)与 aria-checked,不能只靠颜色。
整行(圆点 + 文字)都是 44px 高的热区;横向组里每项自身也保持 44px 最小边长。
本端不发明「取消选中」(单选一旦选中不可回到空值,规格 §33.5)。 */
export default function Radio({
options = [],
value = '',
orientation = 'vertical',
button = false,
disabled = false,
label = '单选项',
onChange,
children = null,
}) {
const cls =
'kole-m-radio-group' +
(orientation === 'horizontal' ? ' kole-m-radio-group--horizontal' : '') +
(disabled ? ' is-disabled' : '');
function pick(key) {
if (disabled) return;
if (onChange) onChange(key);
}
return (
&lt;div className={cls} role=&quot;radiogroup&quot; aria-label={label}&gt;
{options.map((opt, i) =&gt; {
const item = opt || {};
const key = item.value !== undefined ? item.value : String(i);
const checked = key === value;
return (
&lt;button
className={
'kole-m-radio' + (button ? ' kole-m-radio--button' : '') + (checked ? ' is-checked' : '')
}
key={String(key)}
type=&quot;button&quot;
role=&quot;radio&quot;
aria-checked={checked ? 'true' : 'false'}
aria-disabled={item.disabled || disabled ? 'true' : undefined}
disabled={!!(item.disabled || disabled)}
onClick={() =&gt; {
if (item.disabled) return;
pick(key);
}}
&gt;
{/* 圆点:装饰性(语义由 role=&quot;radio&quot; + aria-checked 承担) */}
&lt;span className=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot; /&gt;
&lt;span className=&quot;kole-m-radio__label&quot;&gt;
{item.label}
{item.desc ? &lt;span className=&quot;kole-m-radio__desc&quot;&gt;{item.desc}&lt;/span&gt; : null}
&lt;/span&gt;
&lt;/button&gt;
);
})}
{children}
&lt;/div&gt;
);
}
</code></pre>
</div>
</details>
<details class="m-details">
<summary>frameworks-mobile/Radio.vue2.vue · Vue 2 · 63 行</summary>
<div class="m-code">
<div class="m-code-head"><span>frameworks-mobile/Radio.vue2.vue</span><button class="m-copy" type="button" data-copy="code-202">复制</button></div>
<pre id="code-202"><code>&lt;template&gt;
&lt;div class=&quot;kole-m-radio-group&quot; :class=&quot;groupClass&quot; role=&quot;radiogroup&quot; :aria-label=&quot;label&quot;&gt;
&lt;button
v-for=&quot;(item, i) in options&quot;
:key=&quot;String(keyOf(item, i))&quot;
class=&quot;kole-m-radio&quot;
:class=&quot;{ 'kole-m-radio--button': button, 'is-checked': keyOf(item, i) === value }&quot;
type=&quot;button&quot;
role=&quot;radio&quot;
:aria-checked=&quot;keyOf(item, i) === value ? 'true' : 'false'&quot;
:aria-disabled=&quot;item &amp;&amp; (item.disabled || disabled) ? 'true' : null&quot;
:disabled=&quot;!!(item &amp;&amp; (item.disabled || disabled))&quot;
@click=&quot;pick(item, i)&quot;
&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;
{{ item &amp;&amp; item.label }}
&lt;span v-if=&quot;item &amp;&amp; item.desc&quot; class=&quot;kole-m-radio__desc&quot;&gt;{{ item.desc }}&lt;/span&gt;
&lt;/span&gt;
&lt;/button&gt;
&lt;slot&gt;&lt;/slot&gt;
&lt;/div&gt;
&lt;/template&gt;
&lt;script&gt;
/* 单选框(移动端)— 规格 §33
一组里只能选一项(互斥由本组件负责:选中一项会清掉同组其它项)。
触屏上没有鼠标悬停,选中态必须同时有形状差异(内圈实心点)与 aria-checked,不能只靠颜色。
整行(圆点 + 文字)都是 44px 高的热区;横向组里每项自身也保持 44px 最小边长。
本端不发明「取消选中」(单选一旦选中不可回到空值,规格 §33.5)。 */
export default {
name: 'KoleMRadio',
props: {
options: { type: Array, default: function () { return []; } },
value: { type: String, default: '' },
orientation: { type: String, default: 'vertical' },
button: { type: Boolean, default: false },
disabled: { type: Boolean, default: false },
label: { type: String, default: '单选项' }
},
computed: {
groupClass: function () {
return [
this.orientation === 'horizontal' ? 'kole-m-radio-group--horizontal' : '',
this.disabled ? 'is-disabled' : ''
].filter(Boolean);
}
},
methods: {
keyOf: function (item, i) {
return item &amp;&amp; item.value !== undefined ? item.value : String(i);
},
pick: function (item, i) {
if (this.disabled || (item &amp;&amp; item.disabled)) return;
this.$emit('change', this.keyOf(item, i));
}
}
};
&lt;/script&gt;
&lt;style src=&quot;./Radio.css&quot;&gt;&lt;/style&gt;
</code></pre>
</div>
</details>
<details class="m-details">
<summary>frameworks-mobile/Radio.vue3.vue · Vue 3 · 59 行</summary>
<div class="m-code">
<div class="m-code-head"><span>frameworks-mobile/Radio.vue3.vue</span><button class="m-copy" type="button" data-copy="code-203">复制</button></div>
<pre id="code-203"><code>&lt;template&gt;
&lt;div class=&quot;kole-m-radio-group&quot; :class=&quot;groupClass&quot; role=&quot;radiogroup&quot; :aria-label=&quot;label&quot;&gt;
&lt;button
v-for=&quot;(item, i) in options&quot;
:key=&quot;String(keyOf(item, i))&quot;
class=&quot;kole-m-radio&quot;
:class=&quot;{ 'kole-m-radio--button': button, 'is-checked': keyOf(item, i) === value }&quot;
type=&quot;button&quot;
role=&quot;radio&quot;
:aria-checked=&quot;keyOf(item, i) === value ? 'true' : 'false'&quot;
:aria-disabled=&quot;item &amp;&amp; (item.disabled || disabled) ? 'true' : null&quot;
:disabled=&quot;!!(item &amp;&amp; (item.disabled || disabled))&quot;
@click=&quot;pick(item, i)&quot;
&gt;
&lt;span class=&quot;kole-m-radio__icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;kole-m-radio__label&quot;&gt;
{{ item &amp;&amp; item.label }}
&lt;span v-if=&quot;item &amp;&amp; item.desc&quot; class=&quot;kole-m-radio__desc&quot;&gt;{{ item.desc }}&lt;/span&gt;
&lt;/span&gt;
&lt;/button&gt;
&lt;slot&gt;&lt;/slot&gt;
&lt;/div&gt;
&lt;/template&gt;
&lt;script setup&gt;
/* 单选框(移动端)— 规格 §33
一组里只能选一项(互斥由本组件负责:选中一项会清掉同组其它项)。
触屏上没有鼠标悬停,选中态必须同时有形状差异(内圈实心点)与 aria-checked,不能只靠颜色。
整行(圆点 + 文字)都是 44px 高的热区;横向组里每项自身也保持 44px 最小边长。
本端不发明「取消选中」(单选一旦选中不可回到空值,规格 §33.5)。 */
import { computed } from 'vue';
const props = defineProps({
options: { type: Array, default: () =&gt; [] },
value: { type: String, default: '' },
orientation: { type: String, default: 'vertical' },
button: { type: Boolean, default: false },
disabled: { type: Boolean, default: false },
label: { type: String, default: '单选项' }
});
const emit = defineEmits(['change']);
const groupClass = computed(() =&gt; [
props.orientation === 'horizontal' ? 'kole-m-radio-group--horizontal' : '',
props.disabled ? 'is-disabled' : ''
].filter(Boolean));
function keyOf(item, i) {
return item &amp;&amp; item.value !== undefined ? item.value : String(i);
}
function pick(item, i) {
if (props.disabled || (item &amp;&amp; item.disabled)) return;
emit('change', keyOf(item, i));
}
&lt;/script&gt;
&lt;style src=&quot;./Radio.css&quot;&gt;&lt;/style&gt;
</code></pre>
</div>
</details>
<details class="m-details">
<summary>frameworks-mobile/Radio.uniapp.vue · uni-app(跨端:小程序 / App / H5) · 180 行</summary>
<div class="m-code">
<div class="m-code-head"><span>frameworks-mobile/Radio.uniapp.vue</span><button class="m-copy" type="button" data-copy="code-204">复制</button></div>
<pre id="code-204"><code>&lt;template&gt;
&lt;view class=&quot;kole-m-radio-group&quot; :class=&quot;groupClass&quot; role=&quot;radiogroup&quot; :aria-label=&quot;label&quot;&gt;
&lt;view
v-for=&quot;(item, i) in options&quot;
:key=&quot;String(keyOf(item, i))&quot;
class=&quot;kole-m-radio&quot;
:class=&quot;{ 'kole-m-radio--button': button, 'is-checked': keyOf(item, i) === value }&quot;
:role=&quot;item &amp;&amp; (item.disabled || disabled) ? '' : 'radio'&quot;
:aria-checked=&quot;keyOf(item, i) === value ? 'true' : 'false'&quot;
:aria-disabled=&quot;item &amp;&amp; (item.disabled || disabled) ? 'true' : 'false'&quot;
@tap=&quot;pick(item, i)&quot;
&gt;
&lt;view class=&quot;kole-m-radio__icon&quot; /&gt;
&lt;view class=&quot;kole-m-radio__label&quot;&gt;
&lt;text&gt;{{ item &amp;&amp; item.label }}&lt;/text&gt;
&lt;text v-if=&quot;item &amp;&amp; item.desc&quot; class=&quot;kole-m-radio__desc&quot;&gt;{{ item.desc }}&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 端 · 单选框(移动端)— 规格 §33
跨端差异:
① 项用 view + role=&quot;radio&quot;(小程序没有可聚焦的原生 button 语义差异),点击用 @tap;
② 选中态靠 is-checked 类 + aria-checked 双写;圆点用 view + ::after 内圈(与 H5 同一视觉规则);
③ 禁用不用原生 disabled(view 没有),改为 aria-disabled + is-disabled 类,代码里自己拦点击。
尺寸用 rpx:88rpx = 375pt 下的 44px 触控最小边长,圆点 40rpx = 20px。 */
import { computed } from 'vue';
const props = defineProps({
options: { type: Array, default: () =&gt; [] },
value: { type: String, default: '' },
orientation: { type: String, default: 'vertical' },
button: { type: Boolean, default: false },
disabled: { type: Boolean, default: false },
label: { type: String, default: '单选项' }
});
const emit = defineEmits(['change']);
const groupClass = computed(() =&gt; [
props.orientation === 'horizontal' ? 'kole-m-radio-group--horizontal' : '',
props.disabled ? 'is-disabled' : ''
].filter(Boolean));
function keyOf(item, i) {
return item &amp;&amp; item.value !== undefined ? item.value : String(i);
}
function pick(item, i) {
if (props.disabled || (item &amp;&amp; item.disabled)) return;
emit('change', keyOf(item, i));
}
&lt;/script&gt;
&lt;style&gt;
.kole-m-radio-group {
--kole-m-radio-size: 40rpx; /* 圆点直径(20px @375pt) */
--kole-m-radio-gap: 24rpx; /* 圆点与文字的间距 */
--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;
display: flex;
flex-direction: column;
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-radio-group--horizontal {
flex-direction: row;
flex-wrap: wrap;
align-items: center;
}
.kole-m-radio-group:not(.kole-m-radio-group--horizontal) .kole-m-radio + .kole-m-radio {
border-top: 1rpx solid var(--kole-color-border);
}
.kole-m-radio {
box-sizing: border-box;
display: flex;
align-items: center;
width: 100%;
min-height: var(--kole-m-touch-target);
padding: 24rpx var(--kole-m-gutter);
background-color: var(--kole-color-card-bg);
color: var(--kole-color-text-body);
font-size: inherit;
}
.kole-m-radio-group--horizontal .kole-m-radio {
width: auto;
padding-left: 24rpx;
padding-right: 24rpx;
}
/* 状态 active:按下反馈 */
.kole-m-radio:active { background-color: var(--kole-color-table-header-bg); }
/* 圆点:未选中空心环,选中实心 + 内圈反色点(形状差异,不只靠颜色) */
.kole-m-radio__icon {
position: relative;
flex-shrink: 0;
box-sizing: border-box;
width: var(--kole-m-radio-size);
height: var(--kole-m-radio-size);
margin-right: var(--kole-m-radio-gap);
border: 1rpx solid var(--kole-color-text-placeholder);
border-radius: 50%;
background-color: var(--kole-color-card-bg);
}
.kole-m-radio__icon::after {
content: '';
position: absolute;
top: 6rpx;
left: 6rpx;
width: 28rpx;
height: 28rpx;
border-radius: 50%;
background-color: var(--kole-color-text-inverse);
transform: scale(0);
}
/* 状态 checked */
.kole-m-radio.is-checked .kole-m-radio__icon {
border-color: var(--kole-color-brand);
background-color: var(--kole-color-brand);
}
.kole-m-radio.is-checked .kole-m-radio__icon::after { transform: scale(1); }
.kole-m-radio__label { flex: 1; display: flex; flex-direction: column; }
.kole-m-radio__desc {
overflow: hidden;
white-space: nowrap;
text-overflow: ellipsis;
font-size: var(--kole-m-font-size-label);
color: var(--kole-color-text-secondary);
}
/* 变体 button=true:胶囊标签式(无圆点) */
.kole-m-radio--button {
width: auto;
padding: 16rpx 32rpx;
border: 1rpx solid var(--kole-color-border);
border-radius: 999rpx;
color: var(--kole-color-text-secondary);
font-size: var(--kole-m-font-size-label);
}
.kole-m-radio--button .kole-m-radio__icon { display: none; }
.kole-m-radio--button.is-checked {
border-color: var(--kole-color-brand);
background-color: var(--kole-color-brand-bg);
color: var(--kole-color-brand);
}
/* 状态 disabled:置灰且不响应 */
.kole-m-radio[aria-disabled='true'] { color: var(--kole-color-text-disabled); }
.kole-m-radio[aria-disabled='true'] .kole-m-radio__icon {
border-color: var(--kole-color-text-disabled);
background-color: var(--kole-color-disabled-bg);
}
.kole-m-radio--button[aria-disabled='true'] {
border-color: var(--kole-color-border);
background-color: var(--kole-color-disabled-bg);
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-20 16:50:33</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-radio.json(点击展开原始 JSON)</summary>
<div class="m-code"><pre><code>{
"schemaVersion": 1,
"sourceKind": "authored-spec",
"provenance": "authored-in-repo",
"specFile": "spec/移动端规格.md",
"specSection": "33 · 单选框 Radio",
"confidence": "high",
"slug": "mobile-radio",
"name": "单选框 Radio",
"semanticTypeCandidates": [
"radio",
"radio-group",
"single-choice"
],
"variantDimensions": [
{
"name": "orientation",
"values": [
"vertical",
"horizontal"
]
},
{
"name": "button",
"values": [
"false",
"true"
]
}
],
"representativeVariants": [
{
"orientation": "vertical",
"button": "false",
"label": "默认(圆点 + 文字,纵向排列并画分隔线)"
},
{
"orientation": "horizontal",
"button": "false",
"label": "横向排列(值少、文案短时用)"
},
{
"orientation": "vertical",
"button": "true",
"label": "胶囊标签式(无圆点,筛选条用)"
}
],
"anatomy": {
"group": "根元素,role=\"radiogroup\" + aria-label 说明这组在选什么",
"item": "单个选项,整行都是热区(原生 button + role=\"radio\")",
"icon": "圆点,未选中是空心环、选中是实心圆 + 内圈反色点",
"label": "选项文字,占满剩余宽度",
"desc": "可选说明行,跟在文字下方(如「需先完成企业认证」)",
"state": "选中态 is-checked 与 aria-checked 双写"
},
"structurePatterns": {
"orientation": "vertical(纵向排列,组内画分隔线)/ horizontal(横向排列,靠间距分组)",
"button": "false(圆点 + 文字)/ true(胶囊标签式,无圆点)"
},
"usageHints": [
"在一组互斥选项里选且只选一项(支付方式、配送时效、发票类型)",
"触屏没有鼠标悬停可以预告状态,选中必须同时有形状差异(圆点内圈实心)与 aria-checked,不能只靠颜色",
"整行(圆点 + 文字)都是热区,行高不小于 44px",
"一次触摸即选中,不需要二次确认;选中后不能再点回空值",
"互斥由组件负责:选中一项会立即清掉同组其它项的选中态,不留下两个选中"
],
"doNotInvent": [
"「取消选中」的回到空值交互(单选的语义就是必有一项)",
"横向组自动换行的列数策略(由宿主按文案长度决定,组件只负责 flex-wrap)",
"与表单一起提交时的隐藏字段(由宿主添加)",
"选项内容的异步加载与搜索过滤"
],
"unknowns": [
"横向组超过一行时是否改成纵向(当前包裹后当行处理)",
"圆点尺寸是否随字号一起放大(当前固定 20px)",
"desc 说明行是否允许两行以上(当前单行省略)"
],
"interaction": [
"整行(圆点 + 文字)都是热区,行高不小于 44px;横向组里每项自身也保持这个边长",
"一次触摸即选中,不需要二次确认;选中后**不能**再点回空值(需要清空由宿主提供额外的「清除」动作)",
"互斥由组件负责:选中一项会立即清掉同组其它项的选中态,不留下两个选中",
"切换动效是圆点内圈 150ms 缩放;减少动态偏好下瞬时切换",
"选中后立即触发 change 事件,回传该项的值"
],
"accessibility": [
"组用 role=\"radiogroup\" + aria-label 说明分组名称",
"每项是原生 button + role=\"radio\" + aria-checked(读屏会播报「单选按钮,已选中/未选中」)",
"圆点与内圈是纯装饰,对读屏隐藏(aria-hidden),语义全靠 role=\"radio\"",
"禁用项用原生 disabled 并补 aria-disabled=\"true\""
],
"api": {
"source": "implementation",
"note": "props / events / slots 为 6 端实现的公共接口(说明文字取自规格对应小节)。字段名与各端源码逐名核对:node tools/verify-mobile-docs.mjs",
"requiredNote": "「必传」按严格定义:实现里**没有默认值**时才为 Y(本门禁逐条核对 props 与各端源码的默认值,防止契约与实现脱节)。",
"props": [
{
"name": "options",
"type": "Array",
"default": "[]",
"desc": "选项数组,每项 { value, label, desc, disabled }(规格 §33.2)",
"required": false
},
{
"name": "value",
"type": "string",
"default": "''",
"desc": "受控选中值,与 aria-checked 同步写(规格 §33.5)",
"required": false
},
{
"name": "orientation",
"type": "'vertical' | 'horizontal'",
"default": "'vertical'",
"desc": "变体 orientation:纵向(画分隔线)还是横向排列(规格 §33.3)",
"required": false
},
{
"name": "button",
"type": "boolean",
"default": "false",
"desc": "变体 button:胶囊标签式(无圆点),用于筛选条(规格 §33.3)",
"required": false
},
{
"name": "disabled",
"type": "boolean",
"default": "false",
"desc": "状态 disabled:整组置灰且不可聚焦(规格 §33.4)",
"required": false
},
{
"name": "label",
"type": "string",
"default": "'单选项'",
"desc": "分组名称,落到 radiogroup 的 aria-label(规格 §33.6)",
"required": false
}
],
"events": [
{
"name": "change",
"params": "(value)",
"desc": "选中某项时触发,回传该项的值(规格 §33.5)"
}
],
"slots": [
{
"name": "default",
"desc": "额外选项内容(宿主自己渲染的项,追在 options 之后,规格 §33.2 item)"
}
]
},
"variantClasses": {
"orientation": {
"vertical": [],
"horizontal": [
".kole-m-radio-group--horizontal"
]
},
"button": {
"false": [],
"true": [
".kole-m-radio--button"
]
}
},
"demos": [
{
"id": "basic",
"group": "01 组件类型",
"title": "单选组",
"desc": "互斥:选中一项会自动清掉同组其它项;整行热区不小于 44px。",
"variant": "orientation=vertical"
},
{
"id": "horizontal",
"group": "01 组件类型",
"title": "横向排列",
"desc": "orientation=horizontal:值少、文案短时用,不再画分隔线。",
"variant": "orientation=horizontal"
},
{
"id": "button",
"group": "01 组件类型",
"title": "胶囊按钮式",
"desc": "button=true:无圆点,选中态用品牌色边框 + 浅底。",
"variant": "button=true"
},
{
"id": "checked",
"group": "02 组件状态",
"title": "选中与未选中",
"desc": "两者不能只靠颜色区分:内圈实心点 + aria-checked 双通道。",
"variant": "状态 checked"
},
{
"id": "disabled",
"group": "02 组件状态",
"title": "禁用项",
"desc": "置灰且不响应:原生 disabled 让读屏播报不可用、键盘跳过。",
"variant": "disabled=true"
}
],
"related": [
{
"slug": "mobile-checkbox",
"why": "选项之间可以同时成立(多选、含全选)时用 Checkbox;只有一项能成立时才用 Radio"
},
{
"slug": "mobile-switch",
"why": "「开 / 关」这类即时生效的二值状态用 Switch(即时切换);需要随表单一起提交的互斥选择用 Radio"
},
{
"slug": "mobile-form",
"why": "单选组作为表单里的一个字段时,标签、必填星号与错误提示由 Form 的 item 提供"
}
]
}</code></pre></div>
</details>
</section>
<footer class="m-foot">
<p>生成物:本页由 <code>node tools/build-mobile.mjs</code> 从契约 <code>components/mobile-radio.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>