商品列表组件

商品列表组件用于在微页面中展示可售商品。添加前应确认商品已经完成铺货、上架并处于可展示状态。

添加组件

1. 在页面编辑器中拖入【商品列表】组件；
2. 选择单列、双列、大图或横向滑动；
3. 配置商品来源、数量和排序；
4. 选择是否显示价格、划线价、销量和标签；
5. 在支持的布局中设置按钮类型和文字；
6. 调整间距、圆角、字号和配色；
7. 保存后使用实际商品数据预览。

商品来源

来源	适用场景
热销商品	自动展示销量优先或最新上架的商品
新品商品	自动展示最新商品
指定商品	手动选择固定商品
基础分类商品	展示一个或多个平台基础分类下的商品
店铺分类商品	展示当前店铺分类下的商品
营销场景商品	展示营销方案中指定场景关联的商品

商品列表只负责普通商品展示。秒杀价、拼团价和活动进度应使用对应的限时秒杀或拼团活动组件。

主要配置

配置项	说明
展示方式	支持单列、双列、大图和横向滑动
商品来源	设置组件获取商品的范围、数量和排序
数据加载	固定展示时设置总数量；触底加载时设置每次加载数量
显示内容	控制价格、划线价、销量和标签
按钮类型	在单列和大图中选择智能、文字、购物车、加号或隐藏
卡片样式	调整间距、卡片圆角、图片圆角和字号
色调设置	调整标题、辅助文字、价格、卡片和按钮配色

数据加载

• 固定展示：适合首页楼层，可以在同一页面添加多个商品列表；
• 触底加载：适合页面主列表，一个页面只能有一个组件使用；
• 横向滑动用于有限商品推荐，不建议配合大量数据；
• 固定展示数量只是限制当前组件返回数量，不属于分页加载。

发布前检查

• 商品处于上架状态且当前店铺有可售库存；
• 商品来源能够返回预期数据；
• 价格、划线价、标签和销量显示符合业务要求；
• 商品主图比例一致，标题没有异常截断；
• 购买按钮和商品详情跳转可用；
• 数据为空时页面布局仍然合理。

商品状态排查请参见商品生命周期与上架。

常见问题

商品来源已配置但没有数据

依次检查商品是否完成铺货、上架、库存是否可售，以及所选分类、店铺分类或营销场景是否确实关联商品。

为什么不能选择触底加载？

当前页面已有其他组件占用触底加载。将另一个组件改为【固定展示】，再返回当前组件配置。

调整排序后仍没有商品

排序只改变已有结果的顺序，不能让不符合来源条件的商品出现。应先检查商品来源和商品状态。