深浅模式
信息展示组件
左侧组件库 「信息展示」 分类下的 3 个组件,用于静态信息条、公告提示和列表底部状态。在 UI管理 → 页面配置 中打开页面设计,从左侧点击即可添加到画布。
通用说明
- 属性在右侧 属性 Tab 配置;外边距、背景、圆角等在 样式 Tab 配置(详见 样式与点击动作)。
- 单位 rpx 为响应式像素,750rpx 约等于屏幕全宽。
列表(xiaoyi-list)
说明
通用 设置式列表:每一行可带左侧图标或图片、标题、副标题、右侧文字,并配置点击跳转。适合「功能入口」「关于我们」「联系客服」等 内容由您手动填写 的场景,不会自动拉取笔记或圈子数据。
适用页面
| 页面类型 | 是否常用 |
|---|---|
| 应用首页、发现页 | 较少,多用于快捷入口 |
| 自定义页面 | 常用 |
| 个人中心、设置等面板页 | 常用(菜单行列表) |
| 服务表单页 | 一般不用 |
属性配置
列表项(可添加多条)
| 字段 | 说明 |
|---|---|
| 标题 | 主文案,必填 |
| 副标题 | 可选,显示在标题下方 |
| 右侧文字 | 可选,如「已开通」「99+」 |
| 左侧图标 | 三选一:字体图标 / 图片 / 无 |
| 图标名 / 图片 URL | 左侧为图标或图片时填写;图标可点「选择」从图标库挑选 |
| 图标颜色 | 仅字体图标;可覆盖全局默认色 |
| 点击动作 | 点击该行时跳转的页面或动作 |
全局样式类属性
| 字段 | 说明 |
|---|---|
| 图标大小 / 圆角 | 左侧图标或图片的尺寸与圆角(rpx) |
| 标题字号 / 颜色 / 字重 | 主标题样式 |
| 副标题字号 / 颜色 | 副标题样式 |
| 右侧文字字号 / 颜色 | 右侧辅助文字 |
| 分割线 | 是否显示行与行之间的分割线 |
| 分割线颜色 | 开启分割线时可改颜色 |
| 箭头 | 是否显示右侧「›」箭头 |
| 箭头颜色 / 大小 | 开启箭头时可改样式 |
| 行内边距 | 如 28rpx 30rpx,控制单行上下左右留白 |
样式说明
在 样式 Tab 配置整块列表的外边距、背景色、圆角等。单行内部的间距主要由 行内边距 控制;若需卡片式列表,可给组件加背景色和圆角。
注意事项
- 每一行需单独配置 点击动作,否则点击无反应。
- 左侧 图片 与 字体图标 在同一行里二选一,不要同时填两项 expecting 叠加。
- 列表内容不会随用户或业务数据自动更新,改文案后需 保存并启用 页面配置。
通知栏(xiaoyi-notice)
说明
页面顶部的 公告 / 通知横条,左侧可显示图标或图片,中间为通知文字,可选右侧操作按钮或关闭按钮。适合活动通知、版本提示、平台规则说明等。
适用页面
| 页面类型 | 是否常用 |
|---|---|
| 应用首页、发现页 | 常用 |
| 自定义页面 | 常用 |
| 面板类页面 | 按需 |
| 服务表单页 | 较少 |
属性配置
内容
| 字段 | 说明 |
|---|---|
| 通知文字 | 横条上显示的主文案 |
左侧图标(优先级:图片 > 字体图标 > 文字/emoji)
| 字段 | 说明 |
|---|---|
| 图片 URL | 填则优先显示图片;可从媒体库选择 |
| 图片边长 / 圆角 | 左侧图片尺寸与圆角(rpx) |
| 图标字体名 | 无图片时使用;可点「选择」 |
| 图标前缀 | 自定义 iconfont 类前缀,一般留空 |
| 图标字号 / 颜色 | 字体图标样式 |
| 文字/emoji 备用 | 无图且无图标名时显示,如 📢 |
文字样式
| 字段 | 说明 |
|---|---|
| 文字颜色 / 字号 / 字重 | 通知正文样式 |
| 对齐 | 左 / 中 / 右 |
操作
| 字段 | 说明 |
|---|---|
| 可关闭 | 用户是否可点 × 关闭(关闭后当次会话内隐藏) |
| 操作按钮 | 是否显示右侧按钮 |
| 按钮文字 / 背景 / 文字色 | 开启操作按钮时可配置 |
样式说明
横条整体背景、内边距、圆角、外边距在 样式 Tab 设置。若希望通知「贴边通栏」,可将左右外边距设为 0,并配合页面背景色。
注意事项
- 左侧展示方式 只生效一种:有图片就不显示图标字体。
- 当前编辑器以 单条通知文字 为主;多条轮播能力以客户端实际渲染为准。
- 关闭后是否再次展示取决于客户端逻辑,重要通知请同时在消息中心或弹窗中同步触达。
结束文本(xiaoyi-no-more)
说明
列表 底部状态条:展示「加载中…」「没有更多了」「加载失败」等文案,加载中时可带转圈图标,失败时可带 重试 链接。
有两种用法:
- 普通结束语:手动选状态,用于自定义页装饰或预览某一态的样式。
- 首页列表页脚(
homeListFooter = true):放在 圈子列表 / 笔记列表 / 笔记瀑布流 下方,运行时由首页数据 自动切换 加载中 ↔ 没有更多 ↔ 失败,编辑器里仅作样式预览。
适用页面
| 页面类型 | 是否常用 |
|---|---|
| 应用首页(含列表区块) | 常用(作为列表页脚) |
| 发现页 | 按需 |
| 自定义页面 | 仅作静态装饰时 |
属性配置
列表底部模式
| 字段 | 说明 |
|---|---|
| homeListFooter | 为「列表页脚」时由系统自动控制状态;属性里 当前状态 仅用于预览样式 |
状态与文案
| 字段 | 说明 |
|---|---|
| 当前状态 | 加载中 / 没有更多 / 错误(非页脚模式时手动切换预览) |
| 完成文字 | 没有更多时的文案,如 - THE END - |
| 加载文字 | 加载中的文案,如 加载中... |
| 错误文字 | 失败时的文案,如 加载失败 |
样式
| 字段 | 说明 |
|---|---|
| 字号 / 文字颜色 / 字重 | 状态文字样式 |
| 加载图标色 | 加载中转圈颜色;可设透明 |
重试
| 字段 | 说明 |
|---|---|
| 显示重试 | 错误态是否显示可点重试 |
| 重试文字 / 颜色 | 如「点击重试」 |
样式说明
页脚组件通常 不需要背景块,在 样式 Tab 设 marginTop 与列表拉开距离即可。字号建议 22~26 rpx,颜色用浅灰(如 #999999)以免抢列表内容注意力。
注意事项
- 作为首页列表页脚时,须放在 笔记列表、圈子列表或瀑布流 正下方,且同一首页建议 只放一个 页脚组件。
homeListFooter为 true 时,不要 指望手动切换「当前状态」能改变线上行为——线上由接口分页自动控制。- 若列表上方使用了 筛选标签 联动,切换标签重新加载时,页脚会同步进入「加载中」态。
