Files
aurora-admin/frameworks-mobile/Checkbox.jsx
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

98 lines
3.5 KiB
React

import React from 'react';
import './Checkbox.css';
/* 多选框(移动端)— 规格 §34
一组里可以同时选中多项;勾选态用「勾号出现/消失」+ aria-checked 双通道表达(不只靠颜色)。
含全选形态:全选行不存储自己的状态,而是由组内各项推导出「全选 / 半选 / 空」三态
(半选写 aria-checked="mixed",这是 checkbox 角色允许的第三个值)。
整行(方框 + 文字)都是 44px 高的热区。本端只回传下一组值,是否采纳由宿主决定。 */
export default function Checkbox({
options = [],
value = [],
orientation = 'vertical',
button = false,
selectAll = false,
disabled = false,
label = '多选项',
onChange,
children = null,
}) {
const picked = Array.isArray(value) ? value : [];
const chosen = options.filter((o) => o && picked.indexOf(o.value) >= 0);
const cls =
'kole-m-checkbox-group' +
(orientation === 'horizontal' ? ' kole-m-checkbox-group--horizontal' : '') +
(disabled ? ' is-disabled' : '');
function toggle(key) {
if (disabled) return;
const has = picked.indexOf(key) >= 0;
const next = has ? picked.filter((k) => k !== key) : picked.concat([key]);
if (onChange) onChange(next);
}
function toggleAll() {
if (disabled) return;
/* 只要还有没选中的就全选,否则全部清空(与演示页同一判据) */
const anyOff = options.some((o) => o && picked.indexOf(o.value) < 0 && !o.disabled);
const next = anyOff ? options.filter((o) => o && !o.disabled).map((o) => o.value) : [];
if (onChange) onChange(next);
}
const allState = chosen.length === 0 ? 'false' : chosen.length === options.length ? 'true' : 'mixed';
return (
<div className={cls} role="group" aria-label={label}>
{selectAll ? (
<button
className={
'kole-m-checkbox kole-m-checkbox--all' +
(allState === 'true' ? ' is-checked' : '') +
(allState === 'mixed' ? ' is-indeterminate' : '')
}
type="button"
role="checkbox"
aria-checked={allState}
disabled={disabled}
onClick={toggleAll}
>
<span className="kole-m-checkbox__icon" aria-hidden="true" />
<span className="kole-m-checkbox__label">全选</span>
</button>
) : null}
{options.map((opt, i) => {
const item = opt || {};
const key = item.value !== undefined ? item.value : String(i);
const checked = picked.indexOf(key) >= 0;
return (
<button
className={
'kole-m-checkbox' + (button ? ' kole-m-checkbox--button' : '') + (checked ? ' is-checked' : '')
}
key={String(key)}
type="button"
role="checkbox"
aria-checked={checked ? 'true' : 'false'}
aria-disabled={item.disabled || disabled ? 'true' : undefined}
disabled={!!(item.disabled || disabled)}
onClick={() => {
if (item.disabled) return;
toggle(key);
}}
>
{/* 方框:装饰性(语义由 role="checkbox" + aria-checked 承担) */}
<span className="kole-m-checkbox__icon" aria-hidden="true" />
<span className="kole-m-checkbox__label">
{item.label}
{item.desc ? <span className="kole-m-checkbox__desc">{item.desc}</span> : null}
</span>
</button>
);
})}
{children}
</div>
);
}