Files
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

145 lines
5.0 KiB
React
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import React, { useRef, useState } from 'react';
import './Picker.css';
/* 选择器(移动端)— 规格 §43。
底部浮层 = 装饰性遮罩(aria-hidden)+ 面板;遮罩点击关闭,closeOnMask=false 时不关(规格 §43.5)。
面板 role="dialog" + aria-modal="true",标题元素 id 由 aria-labelledby 指向(规格 §43.6)。
每列 role="listbox"、选项 role="option" + aria-selected;选中项的 is-selected 与 aria-selected 同步。
mode=single 一列、mode=multiple 多列(各列独立选中,联动与否由宿主给定的选项决定)。
本端不发明选择事件(契约只有 confirm / close):点选只改本地高亮,确认时由宿主读 confirm 后的语义。 */
/* 面板标题元素 id:同页多实例不撞号(不依赖 React 版本特性,模块级自增即可) */
let seq = 0;
/* 选项可能是字符串,也可能是 { label, value, disabled } 对象(规格 §43.7 只允许宿主提供) */
function labelOf(option) {
if (option === null || option === undefined) return '';
return typeof option === 'object' ? String(option.label === undefined ? '' : option.label) : String(option);
}
function disabledOf(option) {
return !!(option && typeof option === 'object' && option.disabled);
}
/* 选中判据:选项是对象时比 value,否则比文本(与演示页同一口径) */
function sameValue(option, picked) {
if (picked === undefined || picked === null || picked === '') return false;
var value = option && typeof option === 'object' ? option.value : option;
return String(value) === String(picked);
}
/* mode=single → 取 columns 第一列;mode=multiple → 全部列(规格 §43.3) */
function columnsOf(mode, columns) {
var list = Array.isArray(columns) ? columns : [];
return mode === 'single' ? list.slice(0, 1) : list;
}
export default function Picker({
mode = 'single',
round = false,
open = false,
closeOnMask = true,
value = [],
columns = [],
disabled = false,
title = '',
onConfirm,
onClose,
children = null,
}) {
const idRef = useRef(null);
if (idRef.current === null) {
seq += 1;
idRef.current = 'kole-m-picker-title-' + seq;
}
const titleId = idRef.current;
/* null = 跟随 value 属性;点选后本地记账,确认前不改宿主的值 */
const [draft, setDraft] = useState(null);
const picked = draft || (Array.isArray(value) ? value : []);
const cols = columnsOf(mode, columns);
const panelLabel = title || '选择';
const label = panelLabel + (picked.length ? ':' + picked.join(' ') : '');
function select(colIndex, option) {
if (disabled || disabledOf(option)) return;
const next = picked.slice();
next[colIndex] = String(option && typeof option === 'object' ? option.value : option);
setDraft(next);
}
return (
<>
{children}
<div
className={'kole-m-picker__mask' + (open ? ' is-open' : '')}
aria-hidden="true"
onClick={() => {
if (closeOnMask && onClose) onClose();
}}
/>
<div
className={
'kole-m-picker kole-m-picker--' + (mode === 'multiple' ? 'multiple' : 'single') +
(round ? ' kole-m-picker--round' : '') +
(open ? ' is-open' : '') +
(disabled ? ' is-disabled' : '')
}
role="dialog"
aria-modal="true"
aria-labelledby={titleId}
aria-hidden={open ? undefined : 'true'}
>
<div className="kole-m-picker__header">
<button
className="kole-m-picker__btn"
type="button"
onClick={() => {
if (onClose) onClose();
}}
>
取消
</button>
<span className="kole-m-picker__title" id={titleId}>
{label}
</span>
<button
className="kole-m-picker__btn kole-m-picker__btn--confirm"
type="button"
onClick={() => {
if (!disabled && onConfirm) onConfirm(picked);
}}
>
确定
</button>
</div>
<div className="kole-m-picker__columns">
{cols.map((col, ci) => (
<ul className="kole-m-picker__column" role="listbox" aria-label={col.label} key={col.key || ci}>
{(col.options || []).map((option, i) => {
const selected = sameValue(option, picked[ci]);
const off = disabled || disabledOf(option);
return (
<li
className={
'kole-m-picker__option' + (selected ? ' is-selected' : '') + (off ? ' is-disabled' : '')
}
role="option"
aria-selected={selected ? 'true' : 'false'}
aria-disabled={off ? 'true' : undefined}
key={labelOf(option) + i}
onClick={() => select(ci, option)}
>
{labelOf(option)}
</li>
);
})}
</ul>
))}
</div>
</div>
</>
);
}