组件总览
ReView 移动端组件库全部组件,按功能分类
@reglow/review 是基于 uni-app x(uts/uvue)的移动端组件库,参考 TDesign 设计风格,覆盖基础模块、基础、导航、输入、数据展示、反馈、列表与布局、营销、业务 9 大分类。每个组件文档页顶部均内置手机模拟器演示区:H5 版本发布后(配置 NUXT_PUBLIC_REVIEW_H5_BASE_URL),将自动加载该组件的实时演示页面;发布前展示占位提示。
演示
9:41
基础模块
| 组件 | 说明 |
|---|---|
re-common 公共工具 | re 组件库公共工具模块,提供类型定义、样式拼接、单位处理和唯一 ID 等基础能力 |
re-config-provider 全局配置 | 统一管理局部主题、国际化文案和弹层层级,是整个组件体系的配置入口。 |
re-theme 主题系统 | re 组件库 CSS 变量主题系统,负责注入默认设计令牌并支持暗色和局部变量覆盖 |
基础
| 组件 | 说明 |
|---|---|
re-button 按钮 | 按钮组件,支持多种主题、尺寸、形状和变体,参考TDesign设计风格 |
re-divider 分割线 | 分割线组件,支持水平/垂直布局、虚线样式和自定义内容 |
re-fab 悬浮按钮 | 悬浮动作按钮组件,支持拖拽、图标和文字,固定定位在页面边缘。纯图标时显示圆形,带文字时显示胶囊形。一次只展示一个按钮,点击切换不同用法 |
re-icon 图标 | 基础组件图标,点击图标复制名称。当前优先使用本地 SVG 图标,也支持图片和普通文本符号 |
re-layout 栅格布局 | 栅格布局组件,含 re-row 行和 re-col 列,参考TDesign栅格布局设计 |
re-link 链接 | 文字超链接用于跳转一个新页面,如当前项目跳转、友情链接等。 |
re-typography 排版 | 排版组件,支持 type 类型、主题色(含 mark 标记)、字重、对齐、复制和省略展开收起 |
导航
| 组件 | 说明 |
|---|---|
re-back-top 返回顶部 | 参考 uniapp-components 的 BackTop 交互,只保留一个实际可用的返回顶部实例,通过按钮切换当前样式并在长内容区域里验证显隐与回顶。 |
re-fixed-nav 悬浮导航 | 参考 NutUI fixednav 示例,支持右侧、左侧、无遮罩与自定义按钮/列表。 |
re-indexes 索引 | 索引列表:数据驱动 + 分组锚点,右侧字母点击 / 拖动可跳转定位并滚动高亮联动。吸顶由原生 sticky-header 提供(App / H5),微信小程序 WebView 暂不吸顶。点击组件类型或打开按钮,以全屏弹层体验真实交互。 |
re-navbar 导航条 | 自定义导航条组件,支持标题、左右文字/图标,可固定在顶部 |
re-pagination 分页 | 分页组件,用于数据分页导航,支持显示总数、自定义文案、省略号显示 |
re-side-bar 侧边导航栏 | 侧边导航栏搭配内容区,左侧 tab 与右侧内容联动。点击左侧 tab 右侧自动滚动到对应分类,右侧滚动时左侧 tab 同步高亮。 |
re-steps 步骤条 | 步骤条组件,引导用户按照流程完成任务的导航条,支持水平和垂直方向 |
re-tab-bar 标签栏 | 底部标签栏组件,用于页面底部导航切换,配合 re-tab-bar-item 使用 |
re-tabs 选项卡 | 选项卡组件,用于内容分类切换,配合 re-tab-panel 使用。支持均分/非均分宽度、可滚动模式。 |
输入
| 组件 | 说明 |
|---|---|
re-address 地址选择 | 省市区三级联动地址选择器,支持自定义省份数据 |
re-calendar 日历 | 日历组件,用于选择日期或日期范围,支持单选、多选、范围选择,支持弹窗和内联模式 |
re-cascader 级联选择器 | 多层级数据选择器,支持选项联动和自定义标题 |
re-checkbox 多选框 | 用于从多个选项中选择一个或多个结果,支持样式切换、全选和卡片态。 |
re-code-input 验证码输入 | 多位验证码逐格输入,支持密码遮罩和自定义长度 |
re-color-picker 颜色选择器 | 用于颜色选择,支持基础色板、完整调色板、弹窗模式和多种色值格式。 |
re-date-time-picker 日期时间选择器 | 日期时间选择器,支持多种模式:日期、时间、日期时间、年、月 |
re-form 表单 | 用以收集、校验和提交数据,支持水平与竖向两种排布示例。 |
re-input 输入框 | 用于单行文本信息输入,示例结构与 TDesign live 保持一致。 |
re-invoice 发票 | 发票信息录入组件,支持发票类型、抬头、税号和内容选择 |
re-number-keyboard 数字键盘 | 弹出式数字输入面板,支持随机按键、标题和最大长度 |
re-picker 选择器 | 用于从列数据中选择值,支持多列联动和自定义标题 |
re-radio 单选框 | 用于在预设的一组选项中执行单项选择,并呈现选择结果。 |
re-rate 评分 | 星级评价组件,支持半星选择、自定义文案和只读 |
re-search 搜索框 | 参考 TDesign search 示例,支持结果预览、字数限制、焦点操作按钮与形状切换。 |
re-short-password 短密码 | 网格状密码输入,常用于支付密码,支持自定义长度和提示 |
re-signature 签名 | 手写签名画板,支持确认、清除和自定义画板尺寸颜色 |
re-slide-captcha 滑块验证码 | 滑块拼图验证组件,支持触屏拖动、SVG 降级与自适应缩放,通常配合后端滑动校验接口(verify_token)使用 |
re-slider 滑动选择器 | 用于在一定范围内选择数值,支持步长、范围和数值显示 |
re-stepper 步进器 | 通过 +/- 按钮调整数值,支持范围、步长和整数限制 |
re-switch 开关 | 参考 TDesign switch 示例,支持文字/图标内容、加载态、自定义颜色和不同尺寸动画。 |
re-textarea 多行文本框 | 多行文本输入,支持自适应高度、字数统计和最大长度限制 |
re-time-picker 时间选择器 | 底部弹层式时间滚轮选择器,对齐 TDesign 时间场景,支持时分、时分秒、范围限制与步长设置 |
re-time-select 时间选择 | 时间段选择器,左侧选择日期,右侧选择可用时间段 |
re-tree-select 树形选择器 | 用于多层级数据的逐级选择,交互和视觉参考示例 demo 进行了补全。 |
re-upload 上传 | 文件上传组件,支持图片预览、多选、大小限制和上传前钩子 |
数据展示
| 组件 | 说明 |
|---|---|
re-avatar-cropper 头像裁剪 | 图片裁剪交互,用于头像裁剪,支持旋转、缩放 |
re-avatar 头像 | 用于展示用户头像信息,除了纯展示也可点击进入个人详情等操作。 |
re-badge 徽章 | 徽章组件,支持数字、文字、红点、气泡和角标展示 |
re-barrage 弹幕 | 单实例切换不同弹幕场景,保证动画、循环与点击事件都是实际可运行的。 |
re-card 商品卡片 | 参考 NutUI 业务卡片能力,支持价格、商品信息、店铺信息与具名插槽自定义 |
re-cell 单元格 | 用于各个类别行的信息展示 |
re-circle-progress 环形进度条 | 以圆环形式展示进度,支持自定义颜色、大小、方向 |
re-collapse 折叠面板 | 参考 TDesign 的示例结构,展示基础折叠、状态说明、手风琴和卡片式视觉效果。 |
re-comment 商品评论 | 参考 NutUI 的 comment 组件,支持对象驱动的评论详情、图片/视频、追评与操作栏。 |
re-count-down 倒计时 | 倒计时组件,支持自定义格式化 |
re-count-up 数字滚动 | 数字从起始值滚动到目标值的动画效果,支持缓动 |
re-empty 空状态 | 空状态组件,用于展示无数据时的占位 |
re-footer 页脚 | 页脚组件,用于页面底部展示版权信息、链接等 |
re-grid 宫格 | 宫格组件,用于展示多个等宽的宫格内容 |
re-image-viewer 图片预览 | 图片预览组件,支持全屏查看、滑动切换、删除等 |
re-image 图片 | 图片组件,支持懒加载、自定义形状、加载状态等 |
re-price 价格展示 | 商品价格格式化展示,支持货币符号、小数位、千分位、删除线 |
re-progress 进度条 | 进度条组件,用于展示任务进度 |
re-qrcode 二维码 | 二维码生成组件,支持自定义颜色、尺寸、中心图标 |
re-result 结果页 | 用于反馈一系列操作任务的处理结果 |
re-segmented 分段器 | 分段器组件,用于选项切换 |
re-skeleton 骨架屏 | 骨架屏组件,用于数据加载时的占位展示 |
re-sticky 吸顶 | 吸顶组件,用于滚动时固定内容到顶部 |
re-swiper 轮播 | 数据驱动的轮播组件,统一适配小程序、Web、App |
re-table 表格 | 表格组件,用于展示结构化数据 |
re-tag 标签 | 标签组件,用于标记和分类 |
re-trend-arrow 趋势箭头 | 展示涨/跌趋势箭头及百分比,支持自定义颜色和文案 |
re-video 视频 | 视频播放组件,支持自定义控制、自动播放、循环等 |
re-watermark 水印 | 水印组件,在页面上添加文字或图片水印 |
反馈
| 组件 | 说明 |
|---|---|
re-action-sheet 动作面板 | 从底部弹出的菜单列表,提供多个操作选项 |
re-dialog 对话框 | 用于显示重要信息或需要用户确认操作的模态对话框 |
re-drawer 抽屉 | 抽屉组件,从屏幕边缘滑出,支持推拉手势关闭、模态层过渡动画。closeOnOverlayClick 默认 false,默认禁止点击遮罩关闭。 |
re-dropdown-menu 下拉菜单 | 菜单呈现数个并列的选项类目,用于整个页面的内容筛选,由菜单面板和菜单选项组成。 |
re-guide 引导 | 用于引导用户了解产品功能的气泡提示组件 |
re-loading-page 加载页 | 全屏加载页组件,用于页面初始化或数据加载 |
re-loading 加载 | 用于页面或数据加载状态展示的动画组件 |
re-message 消息通知 | 用于全局展示通知提醒信息,支持多种主题 |
re-notice-bar 公告栏 | 参考 TDesign NoticeBar 示例结构,集中演示基础类型、主题状态、滚动形态与交互控制。 |
re-overlay 遮罩层 | 创建一个遮罩层,用于强调页面特定内容 |
re-popover 气泡弹出框 | 参考 popover 示例,提供基础用法、主题样式和 12 个方向定位演示。 |
re-popup 弹出层 | 参考 TDesign popup demo,保留不同方向与应用示例,方便直接对比动画节奏。 |
re-pull-down-refresh 下拉刷新 | 下拉列表区域即可刷新数据,松手后自动加载新内容 |
re-swipe-cell 滑动单元格 | 参考 TDesign 最终示例,使用 re-cell 组合出单侧、双侧与图标操作场景。 |
re-toast 轻提示 | 轻量级消息提示组件,支持多种状态和位置 |
列表与布局
| 组件 | 说明 |
|---|---|
re-address-list 地址列表 | 地址列表组件,用于展示和管理收货地址,支持选择、新增、编辑、删除 |
re-animate 动画 | 动画组件,提供常用的CSS动画效果,支持淡入、滑动、缩放等。点击"重播"按钮可重新播放动画 |
re-drag 拖拽排序 | 支持列表上下拖拽、卡片选项拖拽和九宫格位置互换三种常见拖拽场景。 |
re-indicator 指示器 | 指示器组件,用于展示当前页码位置,支持圆点和数字两种类型 |
re-infinite-loading 无限加载 | 滚动到底部时自动加载更多数据,松手后自动加载新内容 |
re-list 虚拟列表 | 虚拟列表组件,用于大数据量列表的高性能渲染 |
re-safe-area 安全区域 | 安全区域组件,用于处理刘海屏、底部安全区域等适配问题 |
re-transition 过渡动画 | 过渡动画组件,用于元素的显示/隐藏过渡效果,支持淡入淡出、滑动、缩放等 |
营销
| 组件 | 说明 |
|---|---|
re-gift-box 礼物盒 | 参考 NutUI bingo demo,还原神秘大礼盒开启动效。 |
re-gift-rain 红包雨 | 参考 __VUE/giftrain/demo.vue,开始后点击下落红包收集奖励。 |
re-guess-gift 猜礼物 | 礼盒洗牌后任选一个,适合做猜奖互动和裂变分享活动。 |
re-hit-eggs 砸金蛋 | 参考 NutUI bingo demo,还原砸金蛋抽奖玩法。 |
re-lotto-roll 摇奖机 | 三列奖品按列向上滚动,三列相同即可获得对应中奖产品。 |
re-luck-shake 摇一摇 | 参考 __VUE/luckshake/demo.vue,支持点击指针和真实摇动两种开奖方式。 |
re-marquee 跑马灯抽奖 | 参考 NutUI Bingo 的 8 宫格跑马灯抽奖,实现中心按钮触发和逐格高亮停留效果。 |
re-scratch-card 刮刮卡 | 支持手势连续刮开,也支持按钮触发模拟刮卡,达到阈值后自动揭晓。 |
re-shake-dice 摇骰子 | 参考 __VUE/shakedice/demo.vue,还原 3D 骰子旋转与落点停留效果。 |
re-square-nine 九宫格 | 参考 __VUE/squarenine/demo.vue,中间开始抽奖,外围卡片翻牌开奖。 |
re-turntable 大转盘 | 参考本地 nutui-bingo-dev 的基础 demo,实现大转盘抽奖展示。 |
业务
| 组件 | 说明 |
|---|---|
re-cart-bar 购物车栏 | 商品详情页底部操作栏,组合图标区与购买按钮,覆盖购物车、店铺和立即下单等常见场景。 |
re-chat 智能对话 | 智能对话组件,基于 re-chat 系列子组件构建,支持消息列表、操作栏、发送器与思考过程,用于搭建 AI 对话界面 |
re-coupon 优惠券 | 补充优惠券卡片与底部选择面板两种业务场景,支持领取、筛选和关闭不使用优惠券 |
re-ecard 电子卡券 | 电子卡券组件,用于卡券展示与操作 |
re-floating-panel 浮动面板 | 拖动底部面板,在不同锚点之间停靠。 |
re-goods-filter 商品筛选 | 商品列表筛选面板,支持价格区间、属性分组与地址入口等电商常见筛选场景。 |
re-login 登录 | 登录 / 注册 / 找回密码一体化组件,内置 5 套预设模板,支持验证码登录、账号密码登录、注册并登录、重置密码、第三方登录与发送验证码前的滑动验证,主题色 / Logo / 文案可定制 |
re-order-cancel-panel 订单取消面板 | 订单取消原因选择面板,支持提示文案、其它原因输入和勾选确认等业务场景。 |
re-order-remark 订单备注 | 用于提交订单前补充备注信息,支持快捷标签、自定义文案和事件回调。 |
re-product-feed 商品 Feed 流 | 商品流列表组件,支持单列双列布局、刷新场景和滚动加载更多。 |
re-quick-enter 快捷入口 | 用于首页宫格与滑动入口展示,支持多行分页、单行轮播和横向滑动布局。 |
re-search-history 搜索历史 | 搜索历史展示组件,支持最近搜索、搜索发现、输入关键词联想、删除管理与返回箭头(单独搜索页场景)。 |
re-share-sheet 分享面板 | 底部分享选择面板,支持单行滚动、分页展示和取消回调等分享场景 |
re-sku 商品规格 | 商品规格弹层,支持规格联动、数量调整、不可售态与自定义底部操作 |
re-submit-bar 提交订单栏 | 底部固定的订单提交栏,展示合计金额和提交按钮,支持优惠券选择入口 |
服务与集成
| 组件 | 说明 |
|---|---|
re-cs-sdk 智能客服 | 智能客服 SDK(带界面版):提供 |
re-track 数据埋点 | 基于 uni-app x 的跨端埋点采集 SDK,支持 App / H5 / 微信小程序,自动采集标准事件、会话管理、批量可靠上报与远程埋点规则 |
