更新记录

v2.3.0（2024-02-19）

• 新增 Number 数字 组件，DigitalNumbers字体。

• 新增 BackgroundImage 背景图 组件。

• 新增常用的基础样式class，用于页面布局，详见文档。

• Barcode 条形码 组件优化，新增支持类型：Code128，微信小程序端改为type=2d实现。

• Qrcode 二维码 组件优化，微信小程序端改为type=2d实现。

• Circle 圆形进度条 组件优化，微信小程序端改为type=2d实现。

• Fab 浮动按钮 组件优化，增加按钮 openType 属性支持， openType 属性详见官网button按钮文档介绍。

• Utils 工具 类组件优化，新增部分方法：生成随机颜色，金额转大写等。

• ShareSheet 分享面板 组件优化，新增部分属性以及事件，详见文档。

• Button 按钮 组件优化，新增部分属性以及事件，详见文档。

• Vtabs 纵向选项卡 组件优化，新增 @scrolltolower 事件（仅linkage=false 时有效）。

• Select 选择器 组件优化，新增 @change 事件（仅type=select 时有效）。

• StatusBar 状态栏 组件优化，新增属性设置当isFixed为true时是否默认占位，防止高度塌陷，详见文档使用。

• Table 表格 组件优化，修复值为0时重置成空的问题。

• Tabbar 标签栏 组件优化，修复设置字体图标大小可能不居中的问题。

• ActionSheet 上拉菜单 组件优化，部分逻辑调整。

• BottomNavbar 底部导航栏 组件优化，部分逻辑调整。

• DigitalKeyboard 数字键盘 组件优化，部分逻辑调整。

• Footer 页脚 组件优化，部分逻辑调整。

• Gallery 画廊 组件优化，部分逻辑调整。

• LicensePlate 车牌号键盘 组件优化，部分逻辑调整。

• SafeArea 底部安全区域组件优化，部分逻辑调整。

• Select 选择器 组件优化，部分逻辑调整。

• ShareSheet 分享面板 组件优化，部分逻辑调整。

• Tabbar 标签栏 组件优化，部分逻辑调整。

• Drawer 抽屉 组件优化，部分逻辑调整。

• Modal 模态框 组件优化，部分逻辑调整。

• BottomPopup 底部弹出层 组件优化，部分逻辑调整。

• SegmentedControl 分段器 组件示例优化，新增自定义高度示例。

• Lazyload 图片懒加载 组件优化修复已知问题。

• Dialog 对话框 组件优化，默认标题改为 提示。

• WhiteSpace 上下间距 组件优化，默认值调整为8，16，24rpx。

• Switch 开关选择器 组件优化，新增插槽支持设置圆形按钮内显示内容，仅type=switch有效，nvue暂不支持。

• DatePicker 日期时间选择器 组件优化，区间选择加入属性判断点击确认按钮是否自动赋值开始日期或结束日期，切换区间按钮显示对应开始日期时间或结束日期时间。

• Poster 绘制分享海报 组件优化，绘制图片支持设置是否等比裁剪参数，来保证图片不会变形，详见文档。

• Table 表格 组件优化，修复小程序端固定高度内容可能显示不全的问题。

• Switch 开关 组件优化，修复小程序端底部出现间隙导致无法居中问题。

• Request 网络请求 组件 优化，timeout 值调整，大于2000ms时生效。

• 全局配置文件（fui-config）调整。

• 修复其他已知问题。

v2.2.0（2023-11-09）

• Poster 绘制分享海报 组件优化，新增支持绘制二维码，详见文档数据配置说明。

• FormItem 表单项 组件优化，结构调整，部分样式优化。

• Input 输入框 组件优化，新增属性设置文本对齐方式，代替textRight属性。

• Calendar 日历 组件优化，新增支持设置 badge 角标。

• Icon 图标 组件优化，调整部分逻辑。

• Tabbar 标签栏 组件优化，内置 fui-icon 图标组件，支持使用字体图标代替图片图标。

• Input 输入框 组件优化，修复在选择模式下组件设置disabled时部分浏览器点击无法选择的问题。

• Lottie 动画 组件优化，修复已知问题。

• SingleInput 单输入框 组件优化，修复编译到支付宝小程序Android端无法输入的问题。

• Form 表单校验 组件优化，新增方法单独校验某个字段信息，新增方法清除所有校验信息（结合FormItem组件使用时有效），支持rules数据由FormItem组件传入。

• FormItem 表单项 组件优化，支持传入rules数据，新增部分方法，具体查看文档。

• Animation 动画 组件 优化，修复已知问题。

• FormItem 表单项 组件优化，修复当不结合Form组件单独使用时报警告的问题。

• HorizontalScroll 横向滚动的视图容器 组件优化，调整部分平台滚动条动画效果。

• Input 输入框 组件优化，修复部分平台初始化设置默认值时placeholder未消失重叠的问题。

• Textarea 多行输入框 组件优化，修复部分平台初始化设置默认值时placeholder未消失重叠的问题。

• 修复其他已知问题。

v2.1.0（2023-10-18）

• 新增 WhiteSpace 上下间距 组件。

• 新增 WingBlank 左右间距 组件。

• Preview 表单预览 组件优化，按钮数据新增disabled属性控制是否禁用点击。

• DataTag 标签选择 组件优化，新增nowrap属性设置标签列表是否强制一行显示（注：外层需自行加横向滚动容器）。

• Utils 工具 类组件新增方法formatTimeAgo（日期格式化为多久以前），如 刚刚，20秒前，1分钟前，3天前，3个月前等。

• Form 表单校验 组件 与 FormItem 表单项组件优化，新增校验提示显示方式，当校验有错误时提示信息可显示在出错的FormItem项。

• Picker 选择器 组件优化，新增默认插槽自定义标题部分显示内容。

• IndexList 索引列表 组件优化，新增触底事件。

• Skeleton 骨架屏 组件优化，支持在自定义组件内使用，需调用方法显示骨架，具体参考文档说明。

• SwipeAction 滑动菜单 组件优化，新增属性设置点击按钮不立即关闭菜单。

• Input 输入框 组件优化，新增属性disabledStyle设置是否启用禁用状态下的样式（与正常输入框样式略有区别）。

• Textarea 多行输入框 组件优化，新增属性disabledStyle设置是否启用禁用状态下的样式（与正常多行输入框样式略有区别）。

• Table 表格 组件优化，新增部分属性优化数据为空时显示状态。

• Text 文本 组件优化，修复已知问题。

• Steps 步骤条 组件优化，新增部分属性，调整部分样式显示。

• ActionSheet 上拉菜单 组件优化，优化nvue端安全区域适配问题。

• Tabbar 标签栏 组件优化，修复已知问题。

• ShareSheet 分享面板 组件优化，优化nvue端安全区域适配问题。

• SearchBar 搜索栏 组件优化，新增fixed属性。

• Picker 选择器 组件优化，修复抖音小程序change事件可能不触发的问题。

• DatePicker 日期时间选择器 组件优化，修复抖音小程序change事件可能不触发的问题。

• Input 输入框 组件优化，修复已知问题。

• Textarea 多行输入框 组件优化，修复已知问题。

• 全局配置文件（fui-config）调整。

• 修复其他已知问题。

平台兼容性

First UI 移动端框架优质选择

FirstUI 将出品多种框架下组件库供开发者使用，其中包含uni-app、微信小程序、支付宝小程序等，后期将会陆续上线，目前上线的版本有uni-app版本与微信小程序版本！

FirstUI UNI版

First UI UNI版 是一套基于uni-app开发的组件化、可复用、易扩展、低耦合的跨平台移动端UI 组件库。全面兼容App-Nvue、App-vue、小程序（微信、支付宝、百度、字节、QQ）、H5。

官网地址：https://www.firstui.cn

文档地址：https://doc.firstui.cn

FirstUI 微信小程序版

FirstUI-weixin 是一套基于微信小程序开发的组件化、可复用、易扩展、低耦合的原生微信小程序UI组件库。

官网地址：https://www.firstui.cn

文档地址：https://wxdoc.firstui.cn

==============================================================

FirstUI UNI版 快速上手

使用 First UI 前，请确保你已经学习并熟练使用过 uni-app 。

安装

方式一 ：通过 npm 安装

// # Using npm
npm install firstui-uni

方式二 ：通过下载代码

// # GitHub
git clone https://github.com/FirstUI/FirstUI.git

方式三 ：选择需要的模块引入

如何使用

按照以下的方式使用组件，以 Button 为例，其它组件在对应的文档页查看。

使用组件

引入组件后，可以在 页面 中直接使用组件

<fui-button text="默认按钮"></fui-button>

相关链接

官网地址：https://www.firstui.cn

文档地址：https://doc.firstui.cn

GitHub地址：https://github.com/FirstUI/FirstUI

其他说明

First UI分为 开源版 和 商业版，所有示例或文档中加 V 的表示需要开通会员才可获取源码使用，会员内容不会发布到任何公开渠道。

开通会员、版权约束说明以及详细介绍请参考 FAQ中 会员介绍。

更新日志

V1.4.0（2022-03-16）

• 新增 Circle 圆形进度条 组件（VIP组件）。

• 新增 Skeleton 骨架屏 组件（VIP组件）。

• 新增 CubicBezier 贝塞尔曲线 组件（VIP组件）。

• 新增 SlideVerify 滑动验证 组件（VIP组件）。

• 新增 RotateVerify 旋转验证 组件（VIP组件）。

• 新增 SliderCaptcha 滑块拼图验证 组件（VIP组件）。

• 新增 OverflowHidden 内容超出隐藏 组件（VIP组件）。

• 新增 Backtop 回到顶部 组件（VIP组件）。

• 新增 Lazyload 图片懒加载 组件（VIP组件）。

• 新增 Waterfall 瀑布流 组件（VIP组件）。

• 优化部分组件在vue3下显示异常，控制台报出警告的问题。

• 优化 Upload 图片上传 组件。新增属性设置删除图片时是否弹框确认；图片上传数到达限制数max时隐藏选择框。

• 修复 Preview 表单预览 组件改变数据页面不更新的bug。

• 优化 Button 按钮 组件在Nvue以及PC中的点击效果。

• 优化 Card 卡片 组件在Nvue中样式显示不正确的问题。

• 优化 Message 消息提示 组件，部分props属性可在show方法中传值覆盖。

• 优化 Select 选择器 组件，修复单选时设置默认选中项无效的问题。

• 优化 CountDown 倒计时 组件，修复初始化传0触发倒计时结束事件的问题。

• 修复 Layout 栅格布局 组件属性gutter不生效的bug。

• 修复 InputNumber 数字输入框 组件在vue3下 blur 事件未在emits中申明的问题。

• 优化若干已知问题。

V1.3.0（2021-12-31）

• 新增 Calendar 日历 组件（VIP组件）。

• 新增 Cascader 级联选择器 组件（VIP组件）。

• 新增 Slider 滑块 组件（VIP组件）。

• 新增 Rate 评分 组件（VIP组件）。

• 新增 Select 选择器 组件（VIP组件）。

• 新增 Upload 图片上传 组件（VIP组件）。

• 新增 Gallery 画廊 组件（VIP组件）。

• 新增 BubbleBox 气泡框 组件（VIP组件）。

• 新增 BottomNavbar 底部导航栏 组件（VIP组件）。

• 新增 CountDown 倒计时 组件（VIP组件）。

• 新增 CopyText 长按复制 组件（VIP组件）。

• 新增 Timer 计时器 组件（VIP组件）。

• 新增 Qrcode 二维码 组件（VIP组件）。

• 新增 Barcode 条形码 组件（VIP组件）。

• 新增 Autograph 手写签名 组件（VIP组件）。

• 修复 Textarea 多行输入框 组件回车无法换行的问题。

• 优化 Request 网络请求 组件，新增加载中提示信息配置项。

• 优化 Icon 图标 组件，新增部分图标。

• 优化若干已知问题。

V1.2.0（2021-11-22）

• 新增 Tabbar 标签栏 组件（VIP组件）。

• 新增 ActionSheet 上拉菜单 组件。

• 新增 Toast 轻提示 组件。

• 新增 Dialog 对话框 组件。

• 新增 DropdownMenu 下拉菜单 组件。

• 新增 DropdownList 下拉菜单 组件。

• 新增 Modal 模态框 组件（VIP组件）。

• 新增 Landscape 压屏窗 组件（VIP组件）。

• 新增 Message 消息提示 组件（VIP组件）。

• 新增 BottomPopup 底部弹出层 组件。

• 新增 TopPopup 顶部弹出层 组件。

• 新增 Drawer 抽屉 组件。

• 新增 NoticeBar 通告栏 组件（VIP组件）。

• 新增 TimeAxis 时间轴 组件（VIP组件）。

• 新增 Steps 步骤条 组件（VIP组件）。

• 新增 Progress 进度条 组件（VIP组件）。

• 新增 Collapse 折叠面板 组件。

• 新增 SwiperDot 轮播图指示点 组件（VIP组件）。

• 新增 DigitalRoller 数字滚轮 组件（VIP组件）。

• 新增 DigitalKeyboard 数字键盘 组件（VIP组件）。

• 新增 LicensePlate 车牌号键盘 组件（VIP组件）。

• 新增 CountdownVerify 验证码倒计时 组件（VIP组件）。

• 新增 Sticky 吸顶容器 组件（VIP组件）。

• 新增 Fab 浮动按钮 组件（VIP组件）。

• 新增 ShareSheet 分享面板 组件（VIP组件）。

• 新增 FilterBar 筛选栏 组件（VIP组件）。

• 新增 SwipeAction 滑动菜单 组件。

• 新增 Picker 选择器 组件（VIP组件）。

• 新增 DatePicker 日期时间选择器 组件（VIP组件）。

• 新增 门户模板（物料）。

• 优化掉部分组件中对头条小程序做兼容的冗余代码。

• 优化若干已知问题。

V1.1.0（2021-09-07）

• 调整组件对vue3支持与uni-app官方一致。

• 新增 Panel 面板 组件（VIP组件）。

• 新增 Preview 表单预览 组件（VIP组件）。

• 新增 Empty 缺省页 组件。

• 新增 SegmentedControl 分段器 组件。

• 新增 Pagination 分页器 组件。

• 新增 NavBar 导航栏 组件（VIP组件）。

• 新增 Tabs 标签页 组件。

• 新增 Tag 标签 组件。

• 新增 Backdrop 遮罩层 组件。

• 新增 Result 结果页 组件（VIP组件）。

• 新增 Avatar 头像 组件。

• 新增 Form 表单校验 组件（VIP组件）。

• 新增 Validator 表单验证（JS）组件（VIP组件）。

• 新增 SingleInput 单输入框 组件（VIP组件）。

• 新增 IndexList 索引列表 组件（VIP组件）。

• 新增 SearchBar 搜索栏 组件（VIP组件）。

• 新增 登录（A）模板（物料）。

• 新增 登录（B）模板（物料）。

• 新增 登录（C）模板（物料）。

• 新增 登录（D）模板（物料）。

• 优化若干已知问题。

V1.0.0（2021-08-02）

• 新增 Color 色彩 ，First UI用色指南。

• 新增 Icon 图标 组件，First UI字体图标库。

• 新增 Button 按钮 组件。

• 新增 Footer 页脚 组件。

• 新增 Animation 动画 组件。

• 新增 StatusBar 状态栏 组件。

• 新增 Layout 栅格布局 组件（fui-row和fui-col）。

• 新增 Grid 宫格 组件（fui-grid和fui-grid-item）。

• 新增 List 列表 组件（fui-list和fui-list-cell）。

• 新增 Card 卡片 组件。

• 新增 Input 输入框 组件。

• 新增 InputNumber 数字输入框 组件。

• 新增 Label 标签 组件。

• 新增 FormField 表单数据传递 组件（微信/百度/QQ小程序）。

• 新增 Radio 单选框 组件。

• 新增 Checkbox 复选框 组件。

• 新增 Switch 开关 组件。

• 新增 Textarea 多行输入框 组件。

• 新增 Loading 加载 组件。

• 新增 LoadAni 加载动画 组件（VIP组件）。

• 新增 Badge 徽章 组件。

• 新增 Alert 警告框 组件。

• 新增 Divider 分割线 组件。

• 新增 LoadMore 加载更多 组件。

• 新增 Clipboard 复制文本 组件（VIP组件）。

• 新增 Request 网络请求 组件（VIP组件）。

• 新增 Utils 工具 类组件。

• 新增 Poster 绘制分享海报 组件（VIP组件）。