123 行
3.7 KiB
JavaScript
123 行
3.7 KiB
JavaScript
/**
|
||
* 图标地址解析(纯函数,便于 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,
|
||
}
|