3.2.02026-09-20
日期时间能力增强,补齐选择器自定义触发与范围快捷选项;优化表格、颜色选择、反馈组件交互与遮罩视觉。
新功能
- DateRangePicker:支持
show-time与default-time,面板内切换日期 / 时间并确认写入 - 范围快捷选项:新增
range-shortcuts、shortcuts-position,默认提供近 7 天 / 近 30 天 / 近一年,可自定义或关闭 - 自定义触发器:DatePicker、DateRangePicker、MonthPicker、YearPicker、TimePicker 新增
#trigger插槽,可用按钮等元素唤起面板 - 今日标识:范围选择日历对「今天」增加圆点提示
- ColorPicker:新增
shape(square/circle)、show-value(触发器旁展示色值);size四档尺寸继续可用 - Table:新增
size(mini/normal/large)控制表格密度 - ConfigProvider:支持全局
fontFamily,组件字体统一跟随配置 - Radio 按钮组:选中项增加滑动指示块过渡
- Steps / Switch:状态切换补充过渡动画
优化
- TimePicker / 范围时间:时间列滚动定位、居中与高亮交互优化
- Message:顶部向下、底部向上淡入弹出;底部堆叠改为偏移定位,连续弹出更顺畅
- 遮罩:Modal、Drawer、Spin 统一为毛玻璃 + 淡黑遮罩,适配深色模式
修复
- Table:去除末行与表格外框叠加的双边框
- DateRangePicker:修复
defaultTime的 TypeScript 类型断言,避免构建报错
3.1.02026-08-30
完善组件国际化能力,修复发布后 UnoCSS 工具类样式缺失。
新功能
- 国际化(i18n):新增
zh-CN/en-US语言包与useLocale,组件内置文案统一走语言包 - ConfigProvider:新增
localeMessages,可按组件局部覆盖文案;locale切换后 Modal、Drawer、Popconfirm、Pagination、Table、DatePicker、TimePicker 等自动跟随 - 上述组件的
okText/cancelText/title/emptyText/ 分页模板等默认值改为空字符串,未传入时回退到当前语言包
修复
- 样式产物:构建时将 UnoCSS 工具类合并进
theme/index.css、dist/index.css,并按组件注入到按需theme/*.css,修复安装后mr-1等工具类失效的问题
3.0.02026-08-24
Birdpaper UI v3(Blue)正式发布。基于 Vue 3 全面重写,补齐设计体系、主题定制与深色模式,并提供完整 TypeScript 类型与可按需引入的组件包。
破坏性变更
- 最低依赖提升为 Vue 3.5+,不再兼容 Vue 2 / Vue 3.4 及以下
- 主题改为 CSS 变量驱动,请改用
birdpaper-ui/theme/index.css(或按需theme/*.css)引入样式 - 深色模式根类名统一为
.dark(不再使用.bp-dark),业务侧切换逻辑需同步调整 - 弹出层默认基准层级调整为
zIndex: 3000,并与--z-index-base对齐 - 包结构改为 monorepo 产物(
es/lib/theme/types),请按 安装 文档更新引入方式
设计体系
- 全新色彩体系:功能色(Primary / Success / Warning / Danger)与中性色各 10 阶,浅色 / 深色双套 Token
- 统一尺寸规范:
mini/small/default/large四级高度、字号、内边距与圆角 - 补齐阴影、间距、动效与 z-index 层级规范,组件共享同一套设计令牌
- 提供设计原则、样式指南、深色模式与设计资源文档,便于设计与研发对齐
新功能
- ConfigProvider / 全局配置:支持
prefix、namespace、locale、size、zIndex、emptyText - 主题定制:覆盖
--bp-primary-*、--bp-size-*等变量即可改品牌色与组件尺寸 - 深色模式:根节点切换
.dark,语义色与中性色自动映射,组件无需额外适配 - 按需引入:支持 Tree-shaking,可单独引入组件与对应样式
- 日期时间:DatePicker、DateRangePicker、MonthPicker、YearPicker、TimePicker
- 表单增强:InputTag、InputNumber、VerifyCode、ColorPicker,以及 Form 校验能力
- 数据展示:Table(固定列 / 滚动 / 选择等)、Statistic、Rate、Badge、Empty、Image、Avatar、Tag
- 导航与反馈:Steps、Pagination、Dropdown、Modal、Drawer(支持异步确认)、Message、Popconfirm、Tooltip、Spin、Alert
- 布局与基础:Grid、Space、Button / ButtonGroup、Link、Switch、Checkbox、Radio、Select、Trigger
- 图标 birdpaper-icon