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

234 lines
7.8 KiB
Vue
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.
<template>
<div>
<slot></slot>
<div
v-if="mode === 'popup'"
class="kole-m-cascader__mask"
:class="{ 'is-open': open }"
aria-hidden="true"
@click="onMaskClick"
></div>
<div
class="kole-m-cascader"
:class="panelClass"
:role="mode === 'popup' ? 'dialog' : 'group'"
:aria-modal="mode === 'popup' ? 'true' : null"
:aria-label="mode === 'popup' ? (title || '选择地区') : label"
:aria-hidden="mode === 'popup' && !open ? 'true' : null"
:data-level="depth"
>
<div v-if="mode === 'popup'" class="kole-m-cascader__header">
<button class="kole-m-cascader__btn" type="button" @click="onCancelClick">取消</button>
<span class="kole-m-cascader__title">{{ title || '选择地区' }}</span>
<button
class="kole-m-cascader__btn kole-m-cascader__btn--confirm"
type="button"
@click="onConfirmClick"
>确定</button>
</div>
<div v-if="showPath" class="kole-m-cascader__path">
<template v-for="(item, i) in items">
<button
:key="'p' + i"
class="kole-m-cascader__path-item"
:class="{ 'is-current': i === items.length - 1 }"
type="button"
:aria-current="i === items.length - 1 ? 'true' : null"
:disabled="i === items.length - 1"
@click="back(i)"
>{{ item.label }}</button>
<span v-if="i !== items.length - 1" :key="'s' + i" class="kole-m-cascader__sep" aria-hidden="true">›</span>
</template>
</div>
<ul v-if="list.length" class="kole-m-cascader__panel" role="listbox" :aria-label="listLabel">
<li
v-for="(node, i) in list"
:key="node.value + '-' + i"
class="kole-m-cascader__option"
:class="{ 'is-selected': isSelected(node), 'is-disabled': isOff(node) }"
role="option"
:aria-selected="isSelected(node) ? 'true' : 'false'"
:aria-disabled="isOff(node) ? 'true' : null"
@click="pick(node)"
>
<span class="kole-m-cascader__label">{{ node.label }}</span>
<span v-if="isLeaf(node)" class="kole-m-cascader__check" aria-hidden="true">✓</span>
<span v-else class="kole-m-cascader__arrow" aria-hidden="true">›</span>
</li>
</ul>
<p v-else class="kole-m-cascader__empty">该级暂无可选项</p>
</div>
</div>
</template>
<script>
/* 级联选择器(移动端)— 规格 §44。
多级联动:点某一级后下一级选项变化;点路径条里的上级可回退(规格 §44.5)。
级数不写死:路径条按已选深度渲染,面板**只渲染当前一层** —— 375px 宽下并排多列会把
每列压到 100px 以内,无法阅读(规格 §44.2)。
变动只回传下一段路径(change),确认由宿主决定是否采纳。 */
var LAYER_LABELS = ['省份', '城市', '区县'];
/* 选项可以是字符串,也可以是 { label, value, disabled, children } 结点(规格 §44.7) */
function nodeOf(option, i) {
if (option === null || option === undefined) {
return { label: '', value: String(i), disabled: false, children: [] };
}
if (typeof option === 'object') {
return {
label: String(option.label === undefined ? '' : option.label),
value: String(option.value === undefined ? i : option.value),
disabled: !!option.disabled,
children: Array.isArray(option.children) ? option.children.map(nodeOf) : []
};
}
return { label: String(option), value: String(option), disabled: false, children: [] };
}
function normTree(options) {
return (Array.isArray(options) ? options : []).map(nodeOf);
}
/* 沿 path 走到第 depth 级的选项数组(depth=0 是根) */
function levelList(tree, path, depth) {
var list = tree;
for (var i = 0; i < depth; i++) {
var hit = null;
for (var k = 0; k < list.length; k++) {
if (list[k].value === String(path[i])) { hit = list[k]; break; }
}
if (!hit || !hit.children.length) return [];
list = hit.children;
}
return list;
}
/* 当前展示层级:末项是叶子时停在它所在层(可改选同级),否则展示下一级 */
function displayDepth(tree, path) {
var depth = path.length;
if (depth > 0) {
var parent = levelList(tree, path, depth - 1);
var last = null;
for (var k = 0; k < parent.length; k++) {
if (parent[k].value === String(path[depth - 1])) { last = parent[k]; break; }
}
if (last && !last.children.length) depth -= 1;
}
return depth;
}
/* 路径条:已选各级的结点(用于渲染可点回的按钮) */
function pathItems(tree, path) {
var out = [];
var list = tree;
for (var i = 0; i < path.length; i++) {
var hit = null;
for (var k = 0; k < list.length; k++) {
if (list[k].value === String(path[i])) { hit = list[k]; break; }
}
if (!hit) break;
out.push(hit);
list = hit.children;
}
return out;
}
export default {
name: 'KoleMCascader',
props: {
mode: { type: String, default: 'panel' },
round: { type: Boolean, default: false },
showPath: { type: Boolean, default: true },
open: { type: Boolean, default: false },
closeOnMask: { type: Boolean, default: true },
value: { type: Array, default: function () { return []; } },
options: { type: Array, default: function () { return []; } },
disabled: { type: Boolean, default: false },
title: { type: String, default: '' },
label: { type: String, default: '级联选项' }
},
data: function () {
return {
LAYER_LABELS: LAYER_LABELS,
/* null = 跟随 value 属性;点选后本地记账,确认前不改宿主的值 */
draft: null
};
},
computed: {
tree: function () {
return normTree(this.options);
},
picked: function () {
return this.draft || (Array.isArray(this.value) ? this.value.map(String) : []);
},
depth: function () {
return displayDepth(this.tree, this.picked);
},
list: function () {
return levelList(this.tree, this.picked, this.depth);
},
pickedValue: function () {
return this.picked[this.depth];
},
items: function () {
return pathItems(this.tree, this.picked);
},
listLabel: function () {
return this.label + ' · ' + (LAYER_LABELS[this.depth] || '第 ' + (this.depth + 1) + ' 级');
},
panelClass: function () {
return [
'kole-m-cascader--' + (this.mode === 'popup' ? 'popup' : 'panel'),
this.showPath ? '' : 'kole-m-cascader--no-path',
this.round ? 'kole-m-cascader--round' : '',
this.open ? 'is-open' : '',
this.disabled ? 'is-disabled' : ''
].filter(Boolean);
}
},
methods: {
isSelected: function (node) {
return String(node.value) === String(this.pickedValue === undefined ? '' : this.pickedValue);
},
isOff: function (node) {
return this.disabled || node.disabled;
},
isLeaf: function (node) {
return !node.children.length;
},
emitPath: function (next) {
this.draft = next;
this.$emit('change', next);
},
/* 点选项:截断更深的层级,写入本级选中值(规格 §44.5) */
pick: function (node) {
if (this.isOff(node)) return;
var next = this.picked.slice(0, this.depth);
next[this.depth] = node.value;
this.emitPath(next);
},
/* 点路径条上的上级:退回该级,重新展示它的下一级 */
back: function (d) {
if (this.disabled) return;
this.emitPath(this.picked.slice(0, d + 1));
},
onMaskClick: function () {
if (!this.closeOnMask) return;
this.$emit('close');
},
onCancelClick: function () {
this.$emit('close');
},
onConfirmClick: function () {
if (this.disabled) return;
this.$emit('confirm', this.picked);
}
}
};
</script>
<style src="./Cascader.css"></style>