页面模块 · 指南
评价展示模块：汇总、列表与筛选
评价展示模块如何在商品页把自有评价、评分汇总与分布、评论列表、筛选、媒体评价和商家回复组织成可核对的整体，并处理零评价与少量评价、结构化数据、无障碍和第三方评价的分开展示。
评价展示模块帮助顾客回答“买过的人整体怎么说，其中和我情况相似的人怎么说”。它不是一排星星加几条好评，而是把评分汇总、分布、评论列表、筛选、媒体评价和商家回复连成一条可核对的路径。
评价展示 = 自有评价数据 × 汇总与列表展现 × 筛选交互 × 商品页语境
先确定模块在完成什么任务
- 顾客问题：整体口碑如何；差评集中在什么问题；与我相同变体、相同使用场景的人怎么评价。
- 对象层级：评价属于哪件商品，必要时到哪个变体；汇总只能由该对象的评价计算，不同商品的评价不混用。
- 进入前已知：顾客已在商品页，通常已看过标题与价格，来这里验证判断，而不是重新认识商品。
本模块只展示品牌或其评价系统运营的自有评价。第三方评价平台的分数由独立平台产生，规则不同，在页面上必须分开呈现，不平均、不合并、不写成“顾客评分”；顾客拍摄的图片与视频见用户生成内容，品牌挑选的个案见顾客证言。
信息来源与输入
| 输入 | 来源 | 最低要求 |
|---|---|---|
| 平均分与评价总数 | 运行时数据，由评价系统按已发布评价计算 | 不手写；量表范围（如 1 至 5）明确；分数与总数取自同一时点 |
| 评分分布 | 运行时数据，按星级统计 | 各档数量之和等于总数；与列表口径一致 |
| 单条评价 | 自有评价：评分、日期、显示名、正文 | 保留原文；被撤回或未通过审核的从列表和汇总中同时移除 |
| 变体、验证状态 | 评价记录中的变体字段与验证标准 | 展示“已验证”前必须能说明判定条件 |
| 商家回复 | 评价记录中的回复与时间 | 标明是商家回复及日期 |
| 媒体评价 | 顾客上传的图片或视频 | 有授权与审核记录；替代文字准确 |
| 写评价资格 | 交易状态（订单、送达时间）与评价系统规则 | 说明谁可以写；不以未说明的条件拒绝差评 |
汇总数据是运行时数据，不得改写成静态文案，也不得从旧页面缓存复制。第三方评价的数字若需在同页出现，须带平台名、评价总数、取数日期和主页链接，与本模块的汇总分区展示。
状态与退化
| 状态 | 处理 |
|---|---|
| 零评价 | 如实写“暂无评价”，保留写评价入口（符合资格时）；不借用其他商品、变体、渠道或平台的评价 |
| 少量评价 | 显示实际数量与逐条评论，不绘制看似有统计意义的分布图；不写“热门口碑”。具体阈值缺少实证依据，本文不给数字 |
| 多评价 | 显示汇总、分布与筛选；默认排序口径可见，不只置顶高分 |
| 加载中 | 用与最终布局同尺寸的占位，避免评论列表加载后推动购买区跳动 |
| 加载失败 | 隐藏评分与列表，不保留旧的缓存分数；购买区不受影响 |
| 筛选无结果 | 说明当前条件下没有评价，给出清除条件的入口，汇总仍显示全部评价 |
| 旧评价 | 显示日期；商品改版后旧评价可能不再适用，按版本区分或标注 |
| 评价语言 | 非当前界面语言时保留原文并标注语言；翻译须标明是翻译 |
| 跨市场 | 评价是否随市场、语言变化未核验；不同市场展示不同集合时，汇总与列表必须取同一集合 |
可选展现与交互
| 部件 | 首选形式 | 选择判据与禁用条件 |
|---|---|---|
| 评分汇总与分布 | List：一行“平均分 / 量表、共 N 条”，每档一行 | 分布每档为带文字的可操作控件；不要仅用颜色条表达数量 |
| 评论列表 | 单列 List，分页或“加载更多” | 评论需要逐条阅读，不放进自动轮播 |
| 精选少量评价 | Carousel | 仅用于摘要位置的少数评价，且必须能链接到完整列表；不得代替列表，也不得只轮播高分 |
| 评价区入口 | Tabs 或页内锚点 | 评价区不应因折叠而无法从商品标题旁的评分摘要到达 |
| 小屏完整列表与写评价 | Drawer | 内容长、需要返回商品上下文时；无 JavaScript 时应有独立评价页 |
筛选维度以数据实际有的字段为限：星级、变体（评价记录含变体字段时）、时间与排序、是否含媒体、验证状态。不为凑维度提供没有数据支撑的筛选。排序会影响顾客看到什么，默认排序口径必须写明；美国 FTC 的评价规则问答写明，按有用程度等方式整理评价不等于压制评价，但以虚假指控、威胁等手段让差评消失属于禁止行为。该问答不构成对其他地区的规定，需要法务或合规确认。
页面组合中的位置
- 常见位置：商品页，在规格、配送与保证之后、相关商品之前（对应页面组合中的“提供证据”阶段）；集合页卡片只放评分摘要并链接到商品页评价区。
- 前后模块：前接商品说明与规格，后接 FAQ 或相关商品；评价不能用来证明未经核实的商品能力。
- 不应出现的语境：首页上单独展示某一商品评分而不指明商品；把评价摘要放在没有对应商品的位置；与证据条混合成一个无来源的“口碑分数”。
无障碍与性能
- 星级的文字等价：星星图形属于非文本内容，须有文字等价（WCAG 2.2 SC 1.1.1 Non-text Content）。同时给出可见文字，如“4.5 / 5，共 128 条评价”（虚构示例），星星图形本身可对辅助技术隐藏，避免重复播报。
- 不只靠颜色：分布条的档位与数量必须有文字，不能仅靠颜色或填充长度表达（SC 1.4.1 Use of Color）。
- 半星与取整：按实际分数显示，不把 4.4 显示成 4.5；分数与文字值一致。
- 筛选反馈：筛选或排序后，结果数量以状态消息告知，不抢走焦点（SC 4.1.3 Status Messages）；焦点留在用户正在操作的控件上。
- 性能：评论分页或按需加载；媒体评价延迟加载并保留尺寸；连续切换筛选时取消过期请求，较早结果不得覆盖较新的条件。
评分结构化数据
Google Search Central 的 Review snippet 与 Product snippet 页面（页面标注更新于 2026-09-08）要点如下，核验于 2026-09-29：
- Product 需要
name，并至少包含review、aggregateRating或offers之一；aggregateRating需要ratingValue，以及ratingCount或reviewCount之一；文档说明默认量表为 5 分制，推荐写明bestRating与worstRating。 - 标记的评价内容须能在被标记的页面上被用户看到；通用政策写明不要标记用户不可见的内容，且结构化数据须如实反映页面内容。
- 评价须针对具体商品；文档写明不要汇总来自其他网站的评价或评分，也不要包含虚假或未披露激励的评价，评分应来自真实用户。
- 因此第三方平台的星级不进入自有商品的
aggregateRating；评价总数与页面展示数一致。 - Review snippet 页面为本地商家与组织另写了“被评价主体自己控制评价则不符合星级展示条件”的限制。本文读到的 Product 页面没有写同样的限制，是否适用于商品页需要以官方页面为准。
结构化数据只影响搜索结果如何展示的资格，不保证展示；Google 富媒体结果的实际展示条件未核验。
映射到 Shopify
以下核验于 2026-09-29，详细字段与来源见顾客评价「平台落点」，本文不重复展开：
- shopify.dev 的标准商品评价 metaobject 面向经批准的评价应用；必填含
rating、submitted_at、source、product、app_verification_status，可选含标题、正文、作者、订单、变体、商家回复及时间、语言与媒体链接。本文的“变体筛选”“商家回复”“语言标注”只在评价数据实际含这些字段时成立。 - 商品上的标准 metafield
reviews.rating与reviews.rating_count由评价应用维护，不在后台显示，只能通过 GraphQL Admin API 访问；Liquid 的 rating 对象提供rating、scale_min、scale_max（文档示例的量表最小值为 0.0，不要假定为 1）。 - 未核验：主题评价区块的默认实现、评价应用如何生成结构化数据、评价在 Markets 与多语言下的显示。固定版本主题的评价相关实现见Dawn 订阅表单与徽章（只有星级汇总，未内置评价列表）与Horizon 徽章、评价与订阅（只读取
reviews.rating与reviews.rating_count，评价列表需应用）。
验证一次评价展示
- 选一件评价很多的商品：汇总总数、分布各档之和与列表条数一致；筛选任一星级后列表数量与该档数量一致。
- 选零评价商品与一到两条评价的商品：没有分布图、没有借用其他商品的评价。
- 切换变体、语言或地区：汇总、列表与结构化数据取同一集合。
- 在评价系统撤回一条评价：列表、总数、分布与结构化数据同步更新。
- 键盘与读屏：星级有文字等价；筛选结果数量被播报；无 JavaScript 时仍能读到评论。
- 用 Google 的富媒体结果测试工具检查标记与页面可见内容一致（工具页面本文未读，需自行确认）。
待继续完善
- 缺少“少量评价”阈值与展示方式的实证；
- 缺少虚构示例的评价区线框与逐状态样稿；
- 未在真实店铺实测评价 metafield 的读取与刷新延迟；
- 各地区评价、激励披露与差评处理的法规未核对，需要法务或合规确认。