2.6 KiB
2.6 KiB
白宫官网页面 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 是全中文结构示例和概念内容,不是事实来源。