从 v3 迁移到 v4
注意
由于 tailwindcss@4
改动较大,直接变成了一个样式预处理器,和 sass
/ less
类似。
目前 weapp-tailwindcss@4
版本并没有较好地兼容 tailwindcss@4
,
请继续以 weapp-tailwindcss@4
+ tailwindcss@3
的方式使用
等待 weapp-tailwindcss
正式兼容改造的文档发布 (2025-02-12)
v4 版本相比于 v3, 主要没有什么影响功能的重大变动,假如你没有用到什么复杂自定义配置,那么完全可以平滑升级上来。
特性更新
- 添加
@weapp-tailwindcss/merge
包作为小程序版本的tailwind-merge
- 增加
ignoreTaggedTemplateExpressionIdentifiers
和ignoreCallExpressionIdentifiers
配置,用于和@weapp-tailwindcss/merge
结合起来使用 - 在安装
@weapp-tailwindcss/merge
时自动设置ignoreCallExpressionIdentifiers
为['twMerge', 'twJoin', 'cva']
默认不进行转义里面的字面量 - 更改
cssChildCombinatorReplaceValue
默认值从['view']
->['view', 'text']
为了更好的小程序开发体验
重构
- 移除
@babel/generator
依赖 - 去除
weapp-tailwindcss/postcss
导出,代替可直接安装使用@weapp-tailwindcss/postcss
- 增加
weapp-tailwindcss/escape
来取代weapp-tailwindcss/replace
,weapp-tailwindcss/replace
导出被移除 - 项目
monorepo
区分包 - 项目打包方式从
rollup
变为tsup
pnpm@10.x
假如你已经升级到了 pnpm@10.x
,在安装依赖后,请执行 pnpm approve-builds
来运行一些 npm hook
命令