Files
cms-SiteForge/docs/V8_34_1_EDITOR_IMPLEMENTATION.md
浅念 df2a183dbf upgrade: adopt V8.34.1 (multi-image banner carousel + spec-table source modes)
Plain overlay (33 items, same-source lineage, zero patch replay).
Theme suites 35/35; full run 453 passed + 10 known Windows env fails
(suspect-module rerun confirms identical failure set).
Live: container 8.34.1-dev.1; hesupipe home leftover industrial-preset
blocks cleared via studio draft+publish flow — home now renders pure
trade-pro template (sf-section/Chinese blocks = 0).

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-26 18:03:07 +08:00

2.0 KiB

V8.34.1 实施与验收技术说明

变更模型

hero

  • 新增可选 slides: [{title, subtitle, description, image, button, href}];最多六条,字段仅允许字符串,单值最长 2000 字符。
  • slides=[] 或字段不存在时,原单图渲染逻辑保持不变。
  • 含幻灯片时每张使用完整的按钮与链接,图片地址仅允许原项目 safe_media 规则;使用 safe_href 过滤目标 URL;所有文字在 HTML 边界做转义。
  • 首页首张图 loading=eager、fetchpriority=high,后续图片 lazy;从第二张开始使用 H2,但保留同一视觉字号。
  • 使用 scroll-snap 和原生水平滚动,JS 仅绑定手动上一张/下一张与当前页数;不添加计时器/轮播依赖;键盘能聚焦滚动区,支持 reduced motion。

attributes

  • 增加 source_mode: page(默认)、custom 或 merge;新增 items:[{label,value}],最多 30 项,字符串最长 300 字。
  • page: 现有页面绑定产品参数;custom: 仅展示手动参数;merge: 保留页面参数并追加手动内容。
  • 所有字段均经服务端白名单校验;手动值通过 resolve_text 后 HTML 转义,不允许直接注入 HTML。
  • 编辑器在自动数据模式隐藏手动项,降低冗余操作;切换回手动模式时未删除的手动项仍在草稿里。

已知边界

  • 多图编辑重点面向 页面顶层 hero 区块。嵌套布局里的 hero 虽可渲染,其独立 slides 编辑入口仍待下一阶段完善。
  • 当前展示仅为手动轮播,没有自动轮播、媒体压缩和自动热点裁切功能。用户上传的原图大小仍会影响真实速度。
  • 未对五套主题的全部真实页和所有终端做正式视觉基线对比。本轮实测的是原 CSS/JS 生成的独立页面与现有构建测试。
  • 手动参数在页面布局中保存,不回写 CMS,避免影响其他内容与 SEO。
  • 当前未进行生产数据库、完整 Art Design Pro 源工程及正式远程发布验收。