feat(S6-P21): 组件族参数化(13族/44成员/导航族15文件同源/79→48概念组件)
【本次核心 · S6-P21】 - 族层数据：families.json + 44 份契约注入 family/familyRole/familyParams； data.json / data.js / site/details 同步。13 族 / 44 成员 / 35 独立 → 概念组件 79→48。 - 79 个 slug 全保留、集合逐一不变（铁律 5 对外承诺未破）；frameworks 仍 395 文件、薄壳仍 79。 - 归族判据为契约中可核对字段（semanticTypeCandidates 重叠 / anatomy 为同一骨架子集 / 变体维度同构 / doNotInvent 显式从属声明），每族 mergeBasis 写明依据，不按名字猜。 - 实现层合并（导航族端到端切片）：tools/gen-family-impl.mjs 从 5 端模板生成 TopMenu / SideMenu / MixedNavigation 共 15 文件，参数 direction=top|side|mixed； 三份 CSS md5 完全相同 = 一份样式表服务三个组件。 - 新增 tools/gen-families.mjs、tools/gen-family-impl.mjs、tools/verify-families.mjs、 tools/lib/family-model.mjs、tools/lib/family-impl/nav-menu/*.tpl。 【同时清掉此前已完成但未提交的批次】 生成物（data.json / data.js / site/sources / site/components 薄壳 / sitemap.xml / tests 报告） 跨阶段交织，无法拆成互相自洽的多个提交，故按既有批量风格合并提交： - Package：三端可 import（S5-P18）+ 发布到私有 npm 源 - Docs site：导航语言改下拉（S5-P19）、详情页代码块默认展开、中英切换完整性 - Security：生产部署链审计修复（2026-09-19）+ 线上部署 - Theme modes 日间/夜间/自动；S1-P4 data.js 瘦身；S2-P5 暗色；S2-P6 跨端一致性； S2-P7 行为断言；S2-P9 FAQ；S3-P8 RTL；S3-P9 契约缺口解释层；S4-P12 发布流程 - 补入 tools/pack-deploy.mjs、run-site-smoke.mjs、verify-*.mjs，.dockerignore、 安全审计修复与待决策项.md 【验收】 - node tools/verify-families.mjs → OK: 族层端到端一致（13 族 / 44 成员 / 79 组件不变 / 395 文件不变） - node tools/verify-cross-platform.mjs → 79/79 identical（HEAD 基线 high 44） - node tools/run-regression.mjs → 100%（79/79 页，1017/1017 断言，N/A 34），连跑 8 次一致，0 超时 - 逐页实测：topmenu / sidemenu / mixednavigation 各 13/13，帧内 direction 参数正确，0 JS 错误 - 零运行时依赖 OK；build-site.ps1 ASCII-only OK 【未纳入】site/components/<slug>/ 平台薄壳 316 个 —— 历史从未跟踪且属构建产物，保持现状。
This commit is contained in:
aurora-admin
+142
-44
@@ -3,61 +3,159 @@
|
||||
<head>
|
||||
<meta charset="UTF-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
<title>Aurora Admin · MixedNavigation</title>
|
||||
<title>Aurora Admin · MixedNavigation（混合导航，普通 H5）</title>
|
||||
<link rel="stylesheet" href="../.design_library/aurora-admin/colors_and_type.css" />
|
||||
<link rel="stylesheet" href="./MixedNavigation.css" />
|
||||
<link rel="stylesheet" href="MixedNavigation.css" />
|
||||
<style>
|
||||
body { margin: 0; padding: 16px; background: var(--au-color-page-bg); }
|
||||
p { font-size: 13px; color: var(--au-color-text-secondary); margin: 0 0 8px; }
|
||||
.demo-block { margin-bottom: 20px; }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div class="aa-page">
|
||||
<h2 class="aa-h2">MixedNavigation 混合导航</h2>
|
||||
<p class="aa-desc">顶部一级菜单 + 侧边栏二级菜单，切换顶部项时侧边栏内容联动变化。</p>
|
||||
<!--
|
||||
Aurora Admin Menu 族 · MixedNavigation
|
||||
@generated by tools/gen-family-impl.mjs
|
||||
生成物 — 由 tools/gen-family-impl.mjs 从族模板生成，请勿手改。
|
||||
族 nav-menu：本页是同一份 Menu 实现，参数 direction=mixed。
|
||||
族参数取值：direction=mixed, level=2, collapsed=false
|
||||
重跑生成：node tools/gen-family-impl.mjs nav-menu
|
||||
-->
|
||||
<p>默认态（选中：全部订单）</p>
|
||||
<div class="demo-block">
|
||||
<nav class="aa-menu" id="menu-default" role="navigation" aria-label="主菜单"></nav>
|
||||
</div>
|
||||
|
||||
<div class="aa-demo">
|
||||
<div class="aa-mixed" id="mixed">
|
||||
<div class="aa-mixed-top" id="top"></div>
|
||||
<div class="aa-mixed-body">
|
||||
<div class="aa-mixed-side" id="side"></div>
|
||||
<div class="aa-mixed-content" id="content"></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<p>含徽章与禁用项</p>
|
||||
<div class="demo-block">
|
||||
<nav class="aa-menu" id="menu-badge" role="navigation" aria-label="带徽章的主菜单"></nav>
|
||||
</div>
|
||||
|
||||
<p>二级联动（一级切到「商品」）</p>
|
||||
<div class="demo-block">
|
||||
<nav class="aa-menu" id="menu-alt" role="navigation" aria-label="主菜单替代形态"></nav>
|
||||
</div>
|
||||
|
||||
<script>
|
||||
var menu = [
|
||||
{ name: '工作台', items: [{ name: '概览', desc: '数据看板总览' }, { name: '待办', desc: '我的待处理任务' }, { name: '报表', desc: '统计报表入口' }] },
|
||||
{ name: '系统管理', items: [{ name: '用户管理', desc: '用户增删改查' }, { name: '角色管理', desc: '角色与权限分配' }, { name: '菜单管理', desc: '导航菜单配置' }] },
|
||||
{ name: '业务中心', items: [{ name: '订单', desc: '订单列表与详情' }, { name: '商品', desc: '商品上下架' }, { name: '库存', desc: '库存预警' }] }
|
||||
(function () {
|
||||
/* 族参数：本组件在 nav-menu 族中的取值（由生成器写入，勿手改） */
|
||||
var FAMILY_DIRECTION = 'mixed';
|
||||
var PARAMS = { direction: FAMILY_DIRECTION, collapsed: false };
|
||||
|
||||
var ITEMS = [
|
||||
{ key: 'home', label: '工作台', icon: '⊞' },
|
||||
{ key: 'order', label: '订单', icon: '≡', badge: '3', children: [
|
||||
{ key: 'order-all', label: '全部订单' },
|
||||
{ key: 'order-ship', label: '待发货' },
|
||||
{ key: 'order-refund', label: '退款' }
|
||||
] },
|
||||
{ key: 'goods', label: '商品', icon: '◇', children: [
|
||||
{ key: 'goods-list', label: '商品列表' },
|
||||
{ key: 'goods-cat', label: '分类管理' }
|
||||
] },
|
||||
{ key: 'data', label: '数据', icon: '▤' },
|
||||
{ key: 'setting', label: '设置', icon: '⚙', disabled: true }
|
||||
];
|
||||
var topIdx = 0, sideIdx = 0;
|
||||
var topEl = document.getElementById('top');
|
||||
var sideEl = document.getElementById('side');
|
||||
var contentEl = document.getElementById('content');
|
||||
|
||||
menu.forEach(function (m, i) {
|
||||
var b = document.createElement('div');
|
||||
b.className = 'aa-mixed-topitem' + (i === 0 ? ' is-active' : ''); b.setAttribute('role','menuitem'); b.setAttribute('tabindex','0');
|
||||
b.textContent = m.name;
|
||||
b.onclick = function () { topIdx = i; sideIdx = 0; render(); };
|
||||
topEl.appendChild(b);
|
||||
});
|
||||
/* 单一实现对三种 direction 通用：
|
||||
top -> 一级水平排布，children 走下拉面板
|
||||
side -> 一级纵向排布，children 内联展开（collapsed 时走悬浮浮层）
|
||||
mixed -> 一级在顶部，二级为当前一级的 children，纵向排在侧栏 */
|
||||
function createMenu(root, params, initial) {
|
||||
var state = {
|
||||
active: (initial && initial.active) || '',
|
||||
open: (initial && initial.open) || '',
|
||||
collapsed: params.collapsed === true || params.collapsed === 'true',
|
||||
hoverKey: ''
|
||||
};
|
||||
|
||||
function isTopActive(it) {
|
||||
if (it.key === state.active) return true;
|
||||
return (it.children || []).some(function (c) { return c.key === state.active; });
|
||||
}
|
||||
|
||||
function itemHtml(it, level) {
|
||||
var active = it.key === state.active ? ' is-active' : '';
|
||||
var disabled = it.disabled ? ' is-disabled' : '';
|
||||
var hasKids = !!(it.children && it.children.length);
|
||||
var open = hasKids && it.key === state.open ? ' is-open' : '';
|
||||
var kids = hasKids && params.direction !== 'mixed'
|
||||
? '<div class="aa-menu-children">' + it.children.map(function (c) { return itemHtml(c, level + 1); }).join('') + '</div>'
|
||||
: '';
|
||||
var icon = it.icon ? '<span class="aa-menu-icon">' + it.icon + '</span>' : '';
|
||||
var badge = it.badge ? '<span class="aa-menu-badge">' + it.badge + '</span>' : '';
|
||||
var arrow = hasKids && params.direction !== 'top'
|
||||
? '<span class="aa-menu-arrow">›</span>'
|
||||
: '';
|
||||
return '<div class="aa-menu-item' + active + disabled + open + '"' +
|
||||
' role="menuitem" tabindex="0" data-key="' + it.key + '"' +
|
||||
(hasKids ? ' aria-expanded="' + (it.key === state.open ? 'true' : 'false') + '"' : '') +
|
||||
'>' + icon + '<span class="aa-menu-label">' + it.label + '</span>' + badge + arrow + kids + '</div>';
|
||||
}
|
||||
|
||||
function popHtml() {
|
||||
if (params.direction !== 'side' || !state.collapsed || !state.hoverKey) return '';
|
||||
var it = ITEMS.filter(function (x) { return x.key === state.hoverKey; })[0];
|
||||
if (!it || !it.children) return '';
|
||||
return '<div class="aa-menu-pop">' +
|
||||
'<div class="aa-menu-pop-title">' + it.label + '</div>' +
|
||||
it.children.map(function (c) { return itemHtml(c, 1); }).join('') +
|
||||
'</div>';
|
||||
}
|
||||
|
||||
function bodyHtml() {
|
||||
if (params.direction !== 'mixed') {
|
||||
return ITEMS.map(function (it) { return itemHtml(it, 0); }).join('');
|
||||
}
|
||||
var current = ITEMS.filter(function (x) { return isTopActive(x); })[0] || ITEMS[0];
|
||||
var side = (current.children || []).map(function (c) { return itemHtml(c, 1); }).join('');
|
||||
return '<div class="aa-menu-top">' +
|
||||
ITEMS.map(function (it) { return itemHtml(it, 0); }).join('') +
|
||||
'</div>' +
|
||||
'<div class="aa-menu-side">' + side + '</div>';
|
||||
}
|
||||
|
||||
function render() {
|
||||
root.setAttribute('data-direction', params.direction);
|
||||
if (params.direction === 'side') {
|
||||
root.setAttribute('data-collapsed', state.collapsed ? 'true' : 'false');
|
||||
}
|
||||
root.innerHTML = bodyHtml() + popHtml();
|
||||
Array.prototype.forEach.call(root.querySelectorAll('[data-key]'), function (el) {
|
||||
el.addEventListener('click', function (e) {
|
||||
e.stopPropagation();
|
||||
var key = el.getAttribute('data-key');
|
||||
var isParent = ITEMS.some(function (it) { return it.key === key && it.children; });
|
||||
if (isParent) {
|
||||
state.open = state.open === key ? '' : key;
|
||||
if (params.direction === 'mixed') state.active = key;
|
||||
} else {
|
||||
state.active = key;
|
||||
}
|
||||
render();
|
||||
});
|
||||
el.addEventListener('mouseenter', function () {
|
||||
state.hoverKey = el.getAttribute('data-key');
|
||||
if (params.direction === 'side' && state.collapsed) render();
|
||||
});
|
||||
el.addEventListener('mouseleave', function () {
|
||||
if (params.direction === 'side' && state.collapsed) { state.hoverKey = ''; render(); }
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
function render() {
|
||||
Array.prototype.forEach.call(topEl.children, function (c, i) { c.classList.toggle('is-active', i === topIdx); });
|
||||
var cur = menu[topIdx];
|
||||
sideEl.innerHTML = cur.items.map(function (it, i) {
|
||||
return '<div class="aa-mixed-sideitem' + (i === sideIdx ? ' is-active' : '') + '" role="menuitem" tabindex="0" data-i="' + i + '">' + it.name + '</div>';
|
||||
}).join('');
|
||||
var item = cur.items[sideIdx];
|
||||
contentEl.innerHTML = '<h4>' + cur.name + ' / ' + item.name + '</h4><div>' + item.desc + '</div>';
|
||||
}
|
||||
sideEl.addEventListener('click', function (e) {
|
||||
var t = e.target.closest('.aa-mixed-sideitem');
|
||||
if (!t) return;
|
||||
sideIdx = parseInt(t.dataset.i, 10);
|
||||
render();
|
||||
});
|
||||
render();
|
||||
return { render: render, state: state };
|
||||
}
|
||||
|
||||
var defaults = PARAMS;
|
||||
createMenu(document.getElementById('menu-default'), defaults, { active: 'order-all', open: '' });
|
||||
createMenu(document.getElementById('menu-badge'), defaults, { active: 'goods-list', open: 'goods' });
|
||||
|
||||
/* 第三个用例展示本 direction 的差异能力 */
|
||||
var altParams = Object.assign({}, PARAMS, { });
|
||||
createMenu(document.getElementById('menu-alt'), altParams, { active: 'goods-list', open: '' });
|
||||
})();
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
Reference in New Issue
Block a user