2.3 KiB
2.3 KiB
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 围栏或尾逗号。