Files

4.6 KiB
Raw Permalink Blame History

Facebook 页面 JSON 契约

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

site

  • brand、pageTitle、description、searchPlaceholder、feedTitle、feedSort:字符串。
  • currentUser:当前页面账号,包含 name、handle、initial、colors(两个 #RRGGBB)、composerPrompt、composerPlaceholder。
  • currentUser.stats:数组,每项 { "value": "286", "label": "好友" }。

navigation

  • top:顶部导航项 {label, icon}。
  • primary:左侧主导航项 {label, icon, href};个人主页项可设置 profile: true。
  • shortcutsTitle、footer:字符串。
  • shortcuts:快捷入口 {label, badge, href, colors}。
  • mobile:移动端导航 {label, icon},可选 action: "composer" 或 drawer: "messages|notifications"。
  • href 只使用页面内锚点,例如 #feed、#friends。

可用图标:i-home、i-users、i-video、i-grid、i-message、i-bell、i-bookmark、i-calendar、i-store、i-clock、i-globe、i-circle。

stories

  • createLabel:创建动态按钮文字。
  • items:0–20 项,每项 {name, initial, colors, background}。
  • background 只能是 story-1 至 story-5。

posts

  • items:1–30 条动态;id 必须唯一。
  • 可选 commentUI 控制预置评论区:
    • defaultSort:hot(按点赞数、子回复数降序)或 latest(保持 JSON 顺序,约定最新在前)。
    • initialVisible、pageSize:1–100 的整数;建议均为 10。
    • hotLabel、latestLabel、showMoreLabel、showAllLabel:界面中文文案。
  • 每项核心字段:id、author、initial、colors、verified、time、privacyIcon、text、tags。
  • metrics:{likes, comments, shares},均为非负数字。
  • comments:0–100 条预置评论。每项至少包含 {author, text},建议完整填写 id(同一动态内唯一)、author、handle、initial、colors、verified、time、text、likes、replyCount。likes 和 replyCount 为非负数字。
  • 当预置 50 条热评时,数组必须实际包含 50 个对象,且 metrics.comments >= 50;不能用一条摘要冒充 50 条评论。
  • 可选 commentsExpanded:布尔值;需要页面打开后直接展示热评时设为 true。
  • 可选 sourceUrl:已核验原帖的 http(s) 链接。不再生成或展示 disclosure;旧 JSON 中的该字段会被兼容忽略。
  • 可选 media:
    • { "type": "river", "label": "...", "alt": "..." }
    • { "type": "market", "label": "...", "alt": "..." }
    • { "type": "quote", "quote": "...", "attribution": "..." }
    • 图片:{ "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 }。embed: true 会尝试在卡片内嵌网页;目标网站拒绝 iframe 时仍可点击链接在新窗口打开。

远程媒体 URL 只接受 http:// 或 https://;图片和视频的 mediaUrl 也可使用对应的 data:image/...、data:video/...。页面会过滤其他协议,所有外链使用 noopener noreferrer。

单帖 + 热评模式

用户要求“某账号发布一条动态,配图,下方 N 条热评”时,posts.items 只放这一条动态;将图片写入该动态的 media,将 N 条评论逐条写入 comments,并设置 commentsExpanded: true。页面默认先显示 commentUI.initialVisible 条,可切换热门/最新、分批查看更多或查看全部。

sidebar

  • birthday:{title, text}。
  • sponsor:{heading, title, domain, href}。模板只接受安全的页面内锚点;没有赞助内容时写成演示推荐卡,不伪造真实广告。

contacts

  • title:区块标题。
  • items:0–30 项,每项 {name, initial, colors, online}。

inbox

  • notifications、messages:各 0–30 项。
  • 每项包含 {name, initial, colors, text, time, unread}。

示例边界

  • assets/default-data.json 是结构起点,不是事实来源。
  • 合成热评不得写成真实用户原话,也不在帖子内添加情景模拟说明条。
  • 颜色必须是完整六位十六进制;无效颜色会被模板回退。
  • 所有 JSON 使用双引号,不允许注释、Markdown 围栏或尾逗号。