/** * 图标地址解析(纯函数,便于 Node 单测) * ------------------------------------------------------------ * 优先级:后端下发的覆盖地址 > static/icons/ 下的内置默认图 * 后端可通过 /admin/setting/ui 按 key 覆盖任意图标与 LOGO。 */ import { ICON_BASE, ICON_DEFAULTS, CATEGORY_ICON_KEY, DEFAULT_LOGO } from '../assets/icons.js' import { assetUrl } from './format.js' let remote = { logo: '', icons: {} } /** * 注入后端下发的 UI 配置 * @param {Object} cfg 后台 UI 配置字典 */ export function setRemoteUi(cfg = {}) { remote = { logo: cfg.logo || '', icons: { ...(cfg.icons || {}) }, } } /** * 读取当前生效的后端配置 * @returns {Object} 包含 logo 与 icons 的配置对象 */ export function getRemoteUi() { return { logo: remote.logo, icons: { ...remote.icons } } } /** * 恢复默认图标配置(后端未配置或重置时调用) */ export function resetRemoteUi() { remote = { logo: '', icons: {} } } /** * 取图标地址:key -> url * 支持:网络图片链接(http/https)、站点静态/上传路径(/uploads,/static)、Base64图片、内置图标key * @param {string} key 图标键名或图片链接 * @returns {string} 图标真实地址 */ export function iconUrl(key) { if (!key) return '' // 若传入本身就是图片网络链接或相对路径,直接返回 if (/^https?:\/\/|^\/uploads\/|^\/static\/|^data:image\//i.test(key)) { return key } const override = remote.icons[key] if (override) return override const file = ICON_DEFAULTS[key] return file ? ICON_BASE + file : '' } /** * 取 LOGO 地址 * @returns {string} LOGO 图标完整地址 */ export function logoUrl() { return remote.logo || DEFAULT_LOGO } /** * 分类 ID -> 分类图标地址(兼容历史调用) * @param {number|string} categoryId 分类ID * @returns {string} 分类图标地址 */ export function categoryIconUrl(categoryId) { return iconUrl(CATEGORY_ICON_KEY[categoryId] || 'cat-job') } /** * 全功能分类图标解析器 * 优先顺序:分类对象图片(image/icon) > 配置的iconKey > 历史分类ID字典 > cat-job默认兜底 * 从而天然支持后台继续无上限新增分类(包括自定义图片或自定义iconKey) * @param {Object|number|string} cat 分类对象或分类ID * @returns {string} 图标地址 */ export function resolveCategoryIcon(cat) { if (!cat) return iconUrl('cat-job') if (typeof cat === 'number' || typeof cat === 'string') { return categoryIconUrl(cat) } // 1. 若分类自带图片地址(如未来支持后台分类直接上传图片) if (cat.image && /^https?:\/\/|^\/uploads\/|^\/static\//i.test(cat.image)) { // 包内自带图标(categories/icons 插画)直接用包内路径; // 其余(后台上传图、/static/posts/ 实拍图等)不在小程序包内,必须拼后端域名,否则裂图 return /^\/static\/(categories|icons)\//i.test(cat.image) ? cat.image : assetUrl(cat.image) } // 2. 若配置了自定义 iconKey if (cat.iconKey) { const fromKey = iconUrl(cat.iconKey) if (fromKey) return fromKey } // 3. 若下发了非内置静态路径的 icon if (cat.icon && /^https?:\/\/|^\/uploads\//i.test(cat.icon)) { return cat.icon } // 4. 回退按分类 ID 查找或 cat-job 兜底 return categoryIconUrl(cat.id) } /** * 判断某图标是否已被后台自定义 * @param {string} key 图标键名 * @returns {boolean} 是否被后台覆盖 */ export function isIconOverridden(key) { return !!remote.icons[key] } export default { setRemoteUi, getRemoteUi, resetRemoteUi, iconUrl, logoUrl, categoryIconUrl, resolveCategoryIcon, isIconOverridden, }