4.2 KiB
4.2 KiB
X 页面 JSON 契约
源文件必须是 JSON 对象,并包含以下六个顶层模块。字段可增加,但不能删除顶层模块。
site
brand、pageTitle、description、timelineTitle、searchPlaceholder:字符串。tabs:1–4 个时间线标签字符串。currentUser:当前账号,包含name、handle、initial、colors(两个#RRGGBB)。
navigation
primary:左侧导航,项目为{label, icon, href},可选非负badge。postLabel:发布按钮文案。mobile:移动端导航{label, icon},最多 8 项。footerLinks:页脚链接{label, href};copyright为版权文字。href只使用页面内锚点,例如#mainFeed、#explore。
可用图标:i-home、i-search、i-bell、i-message、i-users、i-bookmark、i-user、i-more。
composer
audience、placeholder、replyPermission、draftsLabel:字符串。maxLength:1–1000 的整数;模板同时用于桌面发布框和弹窗发布框。
posts
items:1–30 条,id必须唯一。- 可选
replyUI控制预置回复区:defaultSort:hot(按点赞数、子回复数降序)或latest(保持 JSON 顺序,约定最新在前)。initialVisible、pageSize:1–100 的整数;建议均为10。hotLabel、latestLabel、showMoreLabel、showAllLabel:界面中文文案。
- 核心字段:
id、author、handle、initial、colors、verified、time、text、tags。 metrics:{replies, reposts, likes, views},均为非负数字。- 可选
repliesExpanded:布尔值;需要直接展示热评详情时设为true。 - 可选
replies:0–100 条预置回复。每项至少包含author、text,建议完整填写:id(同一动态内唯一)、author、handle、initial、colors、verified、time、text。likes、replyCount:非负数字,用于热门排序与互动摘要。- 当预置 50 条热评时,数组必须实际包含 50 个对象,且
metrics.replies >= 50;不能用一条摘要冒充 50 条评论。
- 可选
sourceUrl:已核验原帖的http(s)链接。不再生成或展示disclosure;旧 JSON 中的该字段会被兼容忽略。 - 可选
media:{ "type": "skyline", "caption": "...", "alt": "..." }{ "type": "map", "caption": "...", "alt": "..." }{ "type": "quote", "author": "...", "handle": "...", "initial": "...", "colors": ["#...", "#..."], "time": "...", "text": "..." }- 图片:
{ "type": "image", "mediaUrl": "https://.../image.jpg", "alt": "图片说明", "pageUrl": "https://..." }。 - 视频:
{ "type": "video", "mediaUrl": "https://.../video.mp4", "posterUrl": "https://.../cover.jpg", "alt": "视频说明", "pageUrl": "https://..." }。 - 网页:
{ "type": "webpage", "pageUrl": "https://...", "title": "网页标题", "description": "网页摘要", "mediaUrl": "https://.../cover.jpg", "embed": false }。目标站点不允许 iframe 时用embed: false,页面仍提供新窗口链接。
媒体地址只接受 http(s);图片和视频的 mediaUrl 也可使用对应的 data: URL。运行时会过滤其他协议。
单帖 + 热评模式
用户要求“某账号发布一条动态,配图,下方 N 条热评”时,posts.items 只放这一条动态;将图片写入该动态的 media,将 N 条评论逐条写入 replies,并设置 repliesExpanded: true。页面默认先显示 replyUI.initialVisible 条,可切换热门/最新、分批查看更多或查看全部。
trends
title、showMoreLabel:字符串。items:0–20 项,每项{category, title, count, href}。
recommendations
title、showMoreLabel:字符串。items:0–20 项,每项{name, handle, initial, colors}。
示例边界
assets/default-data.json只提供结构,不是事实来源。- 合成热评不得写成真实用户原话,也不在帖文内添加情景模拟说明条。
- 所有颜色使用完整六位十六进制;无效颜色由模板回退。
- JSON 使用双引号,不允许注释、Markdown 围栏或尾逗号。