Files

2.4 KiB
Raw Permalink Blame History

YouTube 页面 JSON 契约

源文件必须是 JSON 对象,并包含以下七个顶层模块。字段可增加,但不能删除顶层模块。

site

  • brand、pageTitle、description、searchPlaceholder、createLabel:非空字符串。
  • currentUser:当前账号,包含 name、handle、initial、colors 和非负 notifications。

navigation

  • primary、library:桌面导航数组,每项 {label, icon, href},各最多 12 项。
  • mobile:移动端导航数组,每项 {label, icon},最多 6 项。
  • footer:侧栏页脚文字。
  • 可用图标:i-home、i-shorts、i-subscriptions、i-history、i-playlist、i-clock、i-like、i-user。

categories

  • items:1–20 个非空字符串;第一项默认激活。

videos

  • sectionTitle:视频区标题。
  • items:1–30 条,id 唯一。
  • 每项包含 title、channel、channelInitial、channelColors、category、views、time、visual、verified、description。
  • 不填写 duration;页面不展示 JSON 预设时长,旧 JSON 中的该字段会被兼容忽略。
  • visual 仅使用 city、studio、food、mountain、code、science、music、travel。
  • 可选 media 会替换缩略图和观看区:图片 {type:"image", mediaUrl, alt?, pageUrl?};视频 {type:"video", mediaUrl, posterUrl?, alt?, pageUrl?};网页 {type:"webpage", pageUrl, title, description?, mediaUrl?, embed?}。URL 只接受 http(s);图片和视频也允许对应的 data: URL。横屏和竖屏视频在观看区内均按原比例居中完整显示。
  • metrics 为 {likes, comments},均为非负数字。

shorts

  • sectionTitle:Shorts 区标题。
  • items:0–20 条,每项包含唯一 id、title、views、visual。
  • visual 使用与视频相同的预制视觉类型。
  • Shorts 同样可设置上述可选 media。

subscriptions

  • title:侧栏标题。
  • items:0–20 项,每项 {name, handle, initial, colors}。

comments

  • titleSuffix、inputPlaceholder:非空字符串。
  • items:0–40 项,每项包含唯一 id、name、initial、colors、text、time、非负 likes。

示例边界

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