sync update from LAN repo (source dhk-1 @ 3b1ec5b4)
This commit is contained in:
1 parent
da6521b6cb
commit
264e2200d6
995 files changed
+148105
-13399
No files matched your search
+51
@@ -0,0 +1,51 @@
|
||||
# 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 围栏或尾逗号。
|
||||
Reference in new issue
Block a user