文件
fenleixinxi/uniapp/common/utils/icon.js
MiAn 111054d984 feat: 新增会员浏览/拨打额度并优化无图展示逻辑
新增会员每日浏览完整信息和拨打电话的额度配置,调整付费查看接口描述为解锁完整信息,优化帖子无图时的兜底展示逻辑,修复图片加载路径问题,删除废弃工具脚本。
2026-10-28 11:06:39 +08:00

123 行
3.7 KiB
JavaScript

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

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