Files

2.3 KiB
Raw Permalink Blame History

TikTok 页面 JSON 契约

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

site

  • brand、pageTitle、description、feedTitle、searchPlaceholder、uploadLabel:非空字符串。
  • currentUser:当前登录账号,包含 name、handle、initial、colors(两个 #RRGGBB)和非负 notifications。

navigation

  • primary:桌面侧栏导航,最多 10 项;每项 {label, icon, href}。
  • channels:1–5 个频道标签字符串,推荐顺序为关注、推荐、同城。
  • mobile:移动端导航,最多 7 项;每项 {label, icon},创作按钮可使用 icon: "i-plus"。
  • footer:侧栏页脚文字。
  • href 只使用页面内锚点,例如 #videoFeed、#discover。

可用图标:i-home、i-compass、i-users、i-live、i-user、i-message、i-plus。

videos

  • items:1–20 条,id 必须唯一。
  • 核心字段:id、author、handle、initial、colors、text、tags、music、visual、ariaLabel。
  • visual 仅为 neon-city、coffee、mountain。
  • 可选 media 会替换内置 visual:图片 {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, saves},均为非负数字。

sidebar

  • loginPrompt、loginLabel、title:非空字符串。
  • recommendations:0–20 项,每项 {name, handle, initial, colors}。

comments

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

share

  • title:非空字符串。
  • options:1–8 项,每项 {label, icon, toast, action}。
  • action 只使用 copy-link 或 notice。
  • 可用图标:i-link、i-message、i-code、i-flag。

示例边界

  • assets/default-data.json 只提供结构和演示内容,不是事实来源。
  • 所有颜色使用完整六位十六进制;无效颜色由模板回退。
  • JSON 使用双引号,不允许注释、Markdown 围栏或尾逗号。