Skip to content

v0.5.0

Choose a tag to compare

@Tim0x0 Tim0x0 released this 29 Jul 09:42
· 11 commits to main since this release

本版本聚焦 前台发布与评论体验:发布框升级为富文本,列表页可原地展开完整评论区,评论预览对齐朋友圈样式(含链接与表情图)。

新功能

发布框:Tiptap 富文本

  • 基于 Tiptap 2.11(~2.11.9)裁剪内核,对齐官方编辑器技术路线;无 Vue 依赖,打成 IIFE 供前台调用
  • 工具栏 7 键:加粗 / 斜体 / 删除线 / 行内代码 / 链接 / 撤销 / 重做
  • 可产出的正文 HTML 仅限行内样式:p / br / strong / em / s / code / a(不含标题、列表、正文插图;图片仍走九宫格)
  • 首次打开发布浮层时懒加载 fireside-editor.js;加载或初始化失败则回退 textarea 纯文本
  • 链接须工具栏显式创建(关闭 autolink / 粘贴自动成链);URL 仅放行 http / https
  • 原有能力在编辑器路径下继续可用:# 话题联想、chip 删除、九宫格选图/排序/发表时上传、粘贴截图转投九宫格
  • bundle 由 ui 模块 esbuild 构建,挂入 pnpm build,随 Gradle 产出

列表页:评论按钮原地展开

  • 点击评论按钮,在卡片内展开官方 halo:comment 完整评论区
  • 卡片内用 <template> 惰性存放组件:首屏不渲染、不执行脚本;仅被展开的卡片才克隆挂载
  • 克隆后串行复活 <script>;同一外链 src 跨卡片只加载一次,避免库脚本二次执行(如 customElements 重复注册)
  • 评论组件固定 id(如 #comment)挂载前按瞬间名改写,并同步替换内联脚本中的选择器引用
  • 展开时隐藏评论预览,避免预览与完整评论区叠放;收起后清空并重拉预览,便于免审核评论即时回显
  • 渐进增强:无 JS、不支持 <template>、或修饰键 / 中键点击时,仍走链接跳转详情页

评论预览:富文本与表情图

  • 预览不再纯 textContent:经 DOMPurify 白名单消毒后按 HTML 插入
  • 白名单大致对齐官方评论消毒默认档,并额外放行 img(表情包 / 贴图);属性仅保留 href / src / alt
  • 链接补 target="_blank" 与 rel="noopener noreferrer nofollow ugc";图片补 loading / decoding / referrerpolicy
  • 常见标记可显示:加粗、斜体、删除线、行内代码、链接、列表等;块级标签在预览里压成行内连排
  • 表情图约一行字高行内展示;点击预览内真实链接或图片不会误触发「整块进详情」
  • DOMPurify 不可用时回退纯文本

其它

  • 列表页 / 详情页页脚站点名称改为链回首页

依赖与兼容

  • 运行环境不变:Halo >= 2.25.0;链接插件必需;瞬间插件可选(>= 1.16.0)
  • 原地展开的完整评论区依赖站点已安装的评论组件;未安装时按组件既有行为处理
  • 变更集中在前台静态资源与模板(fireside.js / fireside.css / fireside-editor.js / purify.min.js / 模板);无数据模型迁移
  • 升级后若仍见旧交互,请强刷或清 CDN / 浏览器缓存后再验

升级说明

  1. 安装 / 覆盖升级本次构建产物(插件名 plugin-fireside,版本 0.5.0)并启用
  2. 访问 /fireside 建议核对:
    • 登录后打开发布浮层:工具栏是否出现,富文本发布是否成功;断网或脚本失败时是否仍能纯文本发布
    • 列表页点评论:是否原地展开 / 再点收起;收起后预览是否刷新
    • 含链接、表情图的评论:预览是否正常显示,链接与图片点击是否符合预期
  3. 详情页评论区行为应与升级前一致(本版本未改详情页评论挂载方式)

Full Changelog:v0.4.0...v0.5.0