57 lines
2.4 KiB
JavaScript
57 lines
2.4 KiB
JavaScript
|
/**
|
|||
|
|
* 小程序工作台功能入口下发数据的通用组装工具
|
|||
|
|
* 后端 /xxx-dashboard/entries 返回扁平数组：[{ code, name, description, icon, theme, path, group_name }]
|
|||
|
|
* 这里统一转换成四个工作台首页渲染用的 sections 结构：[{ key, title, items: [{ key, label, desc, icon, theme, path }] }]
|
|||
|
|
* 行为字段（角标/表单预填/弹窗等）由各首页按 code 通过 decorate 回调注入，DB 只管展示与有无
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
/** 未配置主题时的兜底配色（与各端硬编码菜单的占位灰一致） */
|
|||
|
|
const FALLBACK_THEME = { bg: 'linear-gradient(135deg, #F3F4F6, #E5E7EB)', color: '#6B7280' };
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 单条下发入口 → 渲染项归一化（首页 sections 与功能页常用/历史共用同一映射，保证字段一致）
|
|||
|
|
* @param {Object} entry 后端下发的入口对象
|
|||
|
|
* @returns {Object|null} { key, label, desc, icon, theme, path, group }；非法入口返回 null
|
|||
|
|
*/
|
|||
|
|
export function normalizeEntry(entry) {
|
|||
|
|
if (!entry || !entry.code) return null;
|
|||
|
|
return {
|
|||
|
|
key: entry.code,
|
|||
|
|
label: entry.name || '',
|
|||
|
|
desc: entry.description || '',
|
|||
|
|
icon: entry.icon || 'grid-fill',
|
|||
|
|
theme: entry.theme && entry.theme.bg ? entry.theme : FALLBACK_THEME,
|
|||
|
|
path: entry.path || '',
|
|||
|
|
group: entry.group_name || '',
|
|||
|
|
};
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 下发入口 → sections 结构
|
|||
|
|
* @param {Array} entries 后端下发的入口数组（已按后台配置排序）
|
|||
|
|
* @param {Function} [decorate] 可选行为装饰回调 (item, entry) => item|null，返回 null 表示丢弃该项
|
|||
|
|
* @returns {Array} sections；entries 为空/非法时返回空数组（调用方据此回落硬编码菜单）
|
|||
|
|
*/
|
|||
|
|
export function groupEntriesToSections(entries, decorate) {
|
|||
|
|
if (!Array.isArray(entries) || entries.length === 0) return [];
|
|||
|
|
const sections = [];
|
|||
|
|
entries.forEach((entry) => {
|
|||
|
|
let item = normalizeEntry(entry);
|
|||
|
|
if (!item) return;
|
|||
|
|
if (typeof decorate === 'function') {
|
|||
|
|
item = decorate(item, entry);
|
|||
|
|
if (!item) return;
|
|||
|
|
}
|
|||
|
|
const title = entry.group_name || '快捷服务';
|
|||
|
|
let section = sections.find((s) => s.title === title);
|
|||
|
|
if (!section) {
|
|||
|
|
// key 用分组标题即可（仅作 v-for key，首个出现顺序即分组展示顺序）
|
|||
|
|
section = { key: title, title, items: [] };
|
|||
|
|
sections.push(section);
|
|||
|
|
}
|
|||
|
|
section.items.push(item);
|
|||
|
|
});
|
|||
|
|
// 丢弃被 decorate 全部过滤掉的空分组
|
|||
|
|
return sections.filter((s) => s.items.length > 0);
|
|||
|
|
}
|