朋友圈动态页应采用「列表+发布入口+顶部导航」三段式结构,禁用全量scroll-view;分享卡片需严格配置onShareTimeline的title、query、imageUrl三字段,且pages.json、manifest.json及微信后台三处开关必须全部开启。

朋友圈动态页面结构怎么组织
朋友圈动态页本质是「列表 + 发布入口 + 顶部导航」三块组合,不能用单个 scroll-view 包全量内容——真机下滚动卡顿、下拉刷新失效、图片懒加载失灵是高频问题。
正确做法是:用 pages.json 配置原生导航栏(避免自定义 navbar 占用滚动区域),列表用 uni-list 或原生 view + v-for,发布按钮固定在底部或右下角悬浮。
- 每条动态必须有唯一
key,建议用后端返回的id,别用index - 头像、昵称、时间、正文、图片/视频、点赞评论区要分层包裹,避免样式污染(比如
text组件里嵌套image会触发微信渲染异常) - 图文混排时,多图用
flex+wrap,单图直接width: 100%;视频用video标签而非第三方组件(uni-app 原生video支持封面、静音、自动播放)
onShareTimeline 怎么配才让朋友圈卡片不白屏
朋友圈卡片白屏 = path 错了或 imageUrl 加载失败,不是代码没写对,而是配置链断了一环。
onShareTimeline 返回对象只认三个字段:title、query、imageUrl。其他任何字段(desc、success、from)都会被忽略,且不会报错。
-
imageUrl必须是 HTTPS 直链,尺寸 ≥ 300×300px,CDN 域名需加到微信后台「业务域名」白名单 -
path字段在朋友圈分享中完全无效,别写;想传参只能靠query: 'id=123&uid=456',且值要encodeURIComponent处理 - 卡片标题超 48 字符会被截断,不换行,建议控制在 30 字以内
pages.json 和 manifest.json 哪些开关必须开
朋友圈入口是“静默消失”的——漏掉任意一个,右上角菜单里就只剩「转发给朋友」,开发者工具和真机都无提示。
三处开关缺一不可:
-
manifest.json→ 「App模块配置」→「Share(分享)」→ 勾选「微信分享」,并填对mp-weixin.appid -
pages.json→ 对应页面配置项里加"enableShareTimeline": true(注意不是enableShareAppMessage) - 微信公众平台后台 → 小程序「设置」→「功能设置」→ 手动开启「分享到朋友圈」开关(2026 年仍需人工开通)
从朋友圈打开的小程序怎么适配单页模式
朋友圈打开的小程序是「单页沙盒环境」:不能跳转其他页面、顶部有固定导航栏、底部有「前往小程序」按钮、登录态可能丢失。
你得在页面 onLoad 里判断来源:
onLoad(options) {
if (options.from === 'timeline') {
this.isFromTimeline = true
// 此时禁用所有 navigateTo、reLaunch,改用 redirectTo 或 showTabBar
// 登录态检查要加兜底(如 localStorage 缓存 token)
}
}
常见坑:
- 用户从朋友圈进来点「点赞」,结果跳转失败白屏——因为
navigateTo被禁用 - 页面顶部自己写的
u-navbar和微信原生导航栏重叠——必须用pages.json配置原生导航,并设"navigationStyle": "default" - 分享卡片里的
query参数,在朋友圈场景下不会触发onLoad的options,而是走onShow的getCurrentPages()[0].options











