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

319 lines
15 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover">
<title>Kole UI Mobile · Cascader(H5)</title>
<link rel="stylesheet" href="../.design_library/kole-ui-mobile/colors_and_type.css">
<link rel="stylesheet" href="Cascader.css">
<style>
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); }
/* 展示框:transform 建立包含块,遮罩与浮层限定在框内(生产环境落在视口上) */
.demo-frame { position: relative; max-width: 375px; margin: 0 auto; overflow: hidden;
transform: translateZ(0); background: var(--kole-color-page-bg);
border-block: 1px solid var(--kole-color-border); }
.demo-frame--tall { height: 320px; }
.demo-block[hidden] { display: none; }
</style>
</head>
<body>
<div class="demo">
<section class="demo-block" data-demo="levels">
<p class="demo-label">逐级下钻(点省份 → 下一级换成城市;每级只渲染当前一层,避免 375px 下横向挤压)</p>
<div class="kole-m-cascader kole-m-cascader--panel" id="cas-levels" data-assert="cascader-levels"
data-path="" data-level="0" data-value="">
<div class="kole-m-cascader__path" hidden></div>
<ul class="kole-m-cascader__panel" role="listbox" aria-label="省份">
<li class="kole-m-cascader__option" role="option" aria-selected="false" data-value="zj"
data-behavior="click-sets-attr:#cas-levels|data-level|1">
<span class="kole-m-cascader__label">浙江省</span><span class="kole-m-cascader__arrow" aria-hidden="true">›</span>
</li>
<li class="kole-m-cascader__option" role="option" aria-selected="false" data-value="gd">
<span class="kole-m-cascader__label">广东省</span><span class="kole-m-cascader__arrow" aria-hidden="true">›</span>
</li>
</ul>
</div>
</section>
<section class="demo-block" data-demo="popup">
<p class="demo-label">底部浮层(mode=popup:默认收起,遮罩点击关闭;标题读屏可读)</p>
<div class="demo-frame demo-frame--tall" data-assert="cascader-popup">
<div class="kole-m-cascader__mask is-open" aria-hidden="true"></div>
<div class="kole-m-cascader kole-m-cascader--popup kole-m-cascader--round is-open" id="cas-popup"
role="dialog" aria-modal="true" aria-labelledby="cas-popup-title" data-level="2" data-value="zj/hz">
<div class="kole-m-cascader__header">
<button class="kole-m-cascader__btn" type="button" id="cas-popup-cancel"
data-behavior="click-sets-attr:#cas-popup|data-cancelled|true">取消</button>
<span class="kole-m-cascader__title" id="cas-popup-title">选择地区</span>
<button class="kole-m-cascader__btn kole-m-cascader__btn--confirm" type="button" id="cas-popup-confirm"
data-behavior="click-sets-attr:#cas-popup|data-confirmed|true">确定</button>
</div>
<div class="kole-m-cascader__path">
<button class="kole-m-cascader__path-item" type="button" data-depth="0">浙江省</button>
<span class="kole-m-cascader__sep" aria-hidden="true">›</span>
<button class="kole-m-cascader__path-item is-current" type="button" aria-current="true" data-depth="1">杭州市</button>
</div>
<ul class="kole-m-cascader__panel" role="listbox" aria-label="区县">
<li class="kole-m-cascader__option is-selected" role="option" aria-selected="true" data-value="xh">
<span class="kole-m-cascader__label">西湖区</span><span class="kole-m-cascader__check" aria-hidden="true">✓</span>
</li>
<li class="kole-m-cascader__option" role="option" aria-selected="false" data-value="bj">
<span class="kole-m-cascader__label">滨江区</span><span class="kole-m-cascader__check" aria-hidden="true">✓</span>
</li>
<li class="kole-m-cascader__option" role="option" aria-selected="false" data-value="yh">
<span class="kole-m-cascader__label">余杭区</span><span class="kole-m-cascader__check" aria-hidden="true">✓</span>
</li>
</ul>
</div>
</div>
</section>
<section class="demo-block" data-demo="back">
<p class="demo-label">回退上一级(点路径条里的上级即退回该级;末位是「你在这里」的锚点,不可点)</p>
<div class="kole-m-cascader kole-m-cascader--panel kole-m-cascader--round" id="cas-back" data-assert="cascader-back"
data-path="zj,hz" data-level="2" data-value="zj/hz">
<div class="kole-m-cascader__path">
<button class="kole-m-cascader__path-item" type="button" data-depth="0"
data-behavior="click-sets-attr:#cas-back|data-level|1">浙江省</button>
<span class="kole-m-cascader__sep" aria-hidden="true">›</span>
<button class="kole-m-cascader__path-item is-current" type="button" aria-current="true" data-depth="1">杭州市</button>
</div>
<ul class="kole-m-cascader__panel" role="listbox" aria-label="区县">
<li class="kole-m-cascader__option" role="option" aria-selected="false" data-value="xh">
<span class="kole-m-cascader__label">西湖区</span><span class="kole-m-cascader__check" aria-hidden="true">✓</span>
</li>
<li class="kole-m-cascader__option" role="option" aria-selected="false" data-value="bj">
<span class="kole-m-cascader__label">滨江区</span><span class="kole-m-cascader__check" aria-hidden="true">✓</span>
</li>
</ul>
</div>
</section>
<section class="demo-block" data-demo="states">
<p class="demo-label">禁用项与空态(禁用行置灰并写 aria-disabled,点击不响应;该级无子项时显示占位)</p>
<div class="kole-m-cascader kole-m-cascader--panel" id="cas-states" data-assert="cascader-states"
data-path="gd" data-level="1" data-value="gd">
<div class="kole-m-cascader__path">
<button class="kole-m-cascader__path-item is-current" type="button" aria-current="true" data-depth="0">广东省</button>
</div>
<ul class="kole-m-cascader__panel" role="listbox" aria-label="城市">
<li class="kole-m-cascader__option" role="option" aria-selected="false" data-value="gz">
<span class="kole-m-cascader__label">广州市</span><span class="kole-m-cascader__arrow" aria-hidden="true">›</span>
</li>
<li class="kole-m-cascader__option is-disabled" role="option" aria-selected="false" aria-disabled="true" data-value="sz">
<span class="kole-m-cascader__label">深圳市(暂未开放)</span><span class="kole-m-cascader__arrow" aria-hidden="true">›</span>
</li>
</ul>
</div>
<div class="kole-m-cascader kole-m-cascader--panel" data-assert="cascader-empty"
data-path="gd,sz" data-level="2" data-value="gd/sz">
<div class="kole-m-cascader__path">
<button class="kole-m-cascader__path-item" type="button" data-depth="0">广东省</button>
<span class="kole-m-cascader__sep" aria-hidden="true">›</span>
<button class="kole-m-cascader__path-item is-current" type="button" aria-current="true" data-depth="1">深圳市</button>
</div>
<ul class="kole-m-cascader__panel" role="listbox" aria-label="区县"></ul>
<p class="kole-m-cascader__empty">该市暂无开通区县</p>
</div>
</section>
</div>
<script>
/* 演示页交互:真实的「逐级下钻 + 回退」。
级数不写死:路径条按已选深度渲染,面板只渲染**当前一层**。
每块各自独立:初始路径读自本块的 data-path,状态只落在本块 DOM 上。 */
(function () {
/* 省市区示例树(演示数据,不是组件契约的一部分) */
var TREE = [
{ label: '浙江省', value: 'zj', children: [
{ label: '杭州市', value: 'hz', children: [
{ label: '西湖区', value: 'xh' }, { label: '滨江区', value: 'bj' }, { label: '余杭区', value: 'yh' }
] },
{ label: '宁波市', value: 'nb', children: [
{ label: '海曙区', value: 'hs' }, { label: '鄞州区', value: 'yz' }
] }
] },
{ label: '广东省', value: 'gd', children: [
{ label: '广州市', value: 'gz', children: [
{ label: '天河区', value: 'th' }, { label: '海珠区', value: 'hz2' }
] },
{ label: '深圳市', value: 'sz', children: [] }
] }
];
var LAYER_LABELS = ['省份', '城市', '区县'];
function find(list, val) {
for (var i = 0; i < list.length; i++) {
if (list[i] && String(list[i].value) === String(val)) return list[i];
}
return null;
}
/* 沿路径走到第 depth 级的选项数组(depth=0 是根) */
function levelList(path, depth) {
var list = TREE;
for (var i = 0; i < depth; i++) {
var hit = find(list, path[i]);
if (!hit || !hit.children || !hit.children.length) return [];
list = hit.children;
}
return list;
}
/* 当前展示层级:末项是叶子时停在它所在层(可改选同级),否则展示下一级 */
function displayDepth(path) {
var depth = path.length;
if (depth > 0) {
var last = find(levelList(path, depth - 1), path[depth - 1]);
if (last && (!last.children || !last.children.length)) depth = depth - 1;
}
return depth;
}
function pathItems(path) {
var out = [];
var list = TREE;
for (var i = 0; i < path.length; i++) {
var hit = find(list, path[i]);
if (!hit) break;
out.push(hit);
list = hit.children || [];
}
return out;
}
function stateOf(root) {
if (!root.__koleCasPath) {
var raw = (root.getAttribute('data-path') || '').trim();
root.__koleCasPath = raw ? raw.split(',') : [];
}
return root.__koleCasPath;
}
function render(root) {
var path = stateOf(root);
var depth = displayDepth(path);
var list = levelList(path, depth);
var pickedValue = path[depth];
var ul = root.querySelector('.kole-m-cascader__panel');
var bar = root.querySelector('.kole-m-cascader__path');
if (!ul) return;
/* 面板:只渲染当前一层 */
ul.setAttribute('aria-label', LAYER_LABELS[depth] || '选项');
var html = '';
list.forEach(function (node) {
var isLeaf = !node.children || !node.children.length;
var on = String(node.value) === String(pickedValue === undefined ? '' : pickedValue);
html += '<li class="kole-m-cascader__option' + (on ? ' is-selected' : '') + '"' +
' role="option" aria-selected="' + (on ? 'true' : 'false') + '"' +
' data-value="' + node.value + '">' +
'<span class="kole-m-cascader__label">' + node.label + '</span>' +
(isLeaf
? '<span class="kole-m-cascader__check" aria-hidden="true">✓</span>'
: '<span class="kole-m-cascader__arrow" aria-hidden="true">›</span>') +
'</li>';
});
ul.innerHTML = html;
/* 路径条:非末位可点(回退到该级),末位是「你在这里」 */
if (bar) {
var items = pathItems(path);
if (!items.length) {
bar.hidden = true;
bar.innerHTML = '';
} else {
bar.hidden = false;
var parts = [];
items.forEach(function (node, i) {
var isLast = i === items.length - 1;
parts.push('<button class="kole-m-cascader__path-item' + (isLast ? ' is-current' : '') + '"' +
' type="button" data-depth="' + i + '"' + (isLast ? ' aria-current="true"' : '') + '>' +
node.label + '</button>');
if (!isLast) parts.push('<span class="kole-m-cascader__sep" aria-hidden="true">›</span>');
});
bar.innerHTML = parts.join('');
}
}
root.setAttribute('data-level', String(depth));
root.setAttribute('data-value', path.join('/'));
}
/* 点选项:截断更深的层级,写入本级选中值 */
function pick(root, depth, value) {
if (root.classList.contains('is-disabled')) return;
var path = stateOf(root).slice(0, depth);
path[depth] = String(value);
root.__koleCasPath = path;
render(root);
}
/* 点路径条上的上级:退回该级(该级自身保留,重新展示它的下一级) */
function back(root, depth) {
root.__koleCasPath = stateOf(root).slice(0, depth + 1);
render(root);
}
Array.prototype.forEach.call(document.querySelectorAll('.kole-m-cascader'), function (root) {
root.addEventListener('click', function (e) {
var hit = e.target.closest ? e.target.closest('.kole-m-cascader__path-item') : null;
if (hit && root.contains(hit)) {
if (hit.classList.contains('is-current')) return; /* 末位不响应 */
back(root, Number(hit.getAttribute('data-depth')) || 0);
return;
}
var option = e.target.closest ? e.target.closest('.kole-m-cascader__option') : null;
if (!option || !root.contains(option) || option.classList.contains('is-disabled')) return;
if (option.getAttribute('aria-disabled') === 'true') return;
var ul = option.parentNode;
var depth = Number(root.getAttribute('data-level')) || 0;
var idx = Array.prototype.indexOf.call(ul.children, option);
pick(root, depth, option.getAttribute('data-value') || String(idx));
});
});
/* 浮层的取消 / 确定只打标记(真实业务里由宿主关闭浮层并决定是否采纳) */
var cancel = document.getElementById('cas-popup-cancel');
var confirm = document.getElementById('cas-popup-confirm');
var popup = document.getElementById('cas-popup');
if (cancel && popup) {
cancel.addEventListener('click', function () { popup.setAttribute('data-cancelled', 'true'); });
}
if (confirm && popup) {
confirm.addEventListener('click', function () { popup.setAttribute('data-confirmed', 'true'); });
}
/* 初始渲染只对齐 data-level / data-value,不改写服务端已渲染好的静态列表 */
Array.prototype.forEach.call(document.querySelectorAll('.kole-m-cascader'), function (root) {
var path = stateOf(root);
root.setAttribute('data-value', path.join('/'));
root.setAttribute('data-level', String(displayDepth(path)));
});
})();
</script>
<script>
/* ?demo=<id> → 只显示该演示块(文档站按块预览用;无参数时全部显示,测试与回归走无参数路径) */
(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 && !b.hidden) label.hidden = true;
});
})();
</script>
</body>
</html>