Files

2.6 KiB
Raw Permalink Blame History

白宫官网页面 JSON 契约

顶层必须完整包含 site、navigation、hero、notice、updates、priorities、administration、calendar、participation、footer。弹窗按十个模块分别编辑,应用时重新校验完整文档。

通用规则

  • site.language 固定为 zh-CN。
  • 所有标题、标签、摘要、按钮、日期、活动、机构名和页脚等读者可见文案必须使用简体中文;英文来源先翻译后再写入 JSON。
  • JSON 键名以及 id、href、visual、theme 等技术值按契约保留英文,不要翻译或改名。
  • 所有标题、标签、摘要和日期为字符串;关键展示字段不能为空。
  • 列表有数量上限,同一业务列表中的 id 必须唯一。
  • href 只允许以 # 开头的页面内锚点。
  • JSON 文本不能包含 HTML、脚本、直接 iframe 或可执行代码。hero 以及具有 visual 的内容对象可增加 media 替换视觉:图片 {type:"image", mediaUrl, alt?, pageUrl?};视频 {type:"video", mediaUrl, posterUrl?, alt?, pageUrl?};网页 {type:"webpage", pageUrl, title, description?, mediaUrl?, embed?}。仅这些媒体 URL 字段允许 http(s),图片/视频也允许对应的 data: URL。

模块

  • site:机构名称、办公室名称、页面标题、描述、语言、theme(light/dark/auto)和跳转正文文案。
  • navigation:左右主导航、菜单/搜索/主题按钮文案;全屏菜单含说明、CTA 和 1–4 个链接列;搜索含标题、占位和结果文案。
  • hero:主视觉标签、两行标题、摘要、主要 CTA、直播 CTA、简报卡、滚动提示和直播弹窗;visual 固定为 executive-house。
  • notice:公告标签、标题、日期和锚点。
  • updates.items:1–8 条官方动态,visual 为 hall、mobility、science、statement、action;首条自动采用主卡布局。
  • priorities.items:1–6 个优先事项,每项含标题、摘要和点击后展示的详情。
  • administration:标题、引语、说明、签名、1–6 个链接和 portrait 视觉。
  • calendar.months:1–6 个月份;每月含 1–8 个日期、月份缩写、标题、说明和标签。
  • participation.cards:1–6 个公众参与入口,visual 为 visit、letter、service;另含订阅标题、说明、占位、按钮和成功提示。
  • footer.columns:1–4 个链接列,每列 1–8 个锚点;另有机构说明、版权和法律文案。

JSON 使用双引号,不允许注释、Markdown 围栏或尾逗号。assets/default-data.json 是全中文结构示例和概念内容,不是事实来源。