Files

2.2 KiB
Raw Permalink Blame History

CNN 页面 JSON 契约

顶层必须完整包含 site、navigation、breaking、lead、latest、video、world、markets、newsletter、footer。弹窗按十个模块分别编辑,但应用时重新校验完整文档。

通用规则

  • 所有标题、标签、摘要和时间都是非空字符串;列表有数量上限。
  • id 在所属列表内必须唯一。
  • href 只允许以 # 开头的页面内锚点。
  • JSON 文本不能包含 HTML、脚本或直接 iframe。具有 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)、日期、工具栏链接、市场摘要、天气和头版标签。市场方向为 up/down/flat。
  • navigation:1–10 个 {label, href} 导航项,以及搜索、直播和移动抽屉文案。
  • breaking:label、text、time。
  • lead.primary:kicker/title/summary/byline/updated/readingTime/visual/visualLabel/tag/credit;visual 必须为 summit。
  • lead.sideStories:0–4 条,visual 可为 train 或 null;updates 为 0–12 条 {time,text}。
  • latest.items:1–12 条,视觉类型为 coast、city、deep-sea。
  • video.items:1–8 条,视觉类型为 night-city、space、music,并包含 duration。
  • world.items:1–16 条,视觉类型为 trade、market、payments、energy;analysis 包含评论标题、正文和作者信息。
  • markets.items:1–8 条 {name,value,change,direction},方向为 up、down 或 flat。
  • newsletter:标题、说明、邮箱占位、按钮和成功提示前缀。
  • footer.columns:0–6 栏,每栏 0–8 个 {label,href};另有 tagline/copyright/legal。

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