- 添加
wxs
支持,包含内联使用和引入的转义,并添加对应的配置项 - 添加多
tailwindcss
上下文的支持,用户可以在一个项目里,创建多个tailwindcss
上下文,使得不同的目录,应用不同的tailwindcss
策略
- 添加
cssChildCombinatorReplaceValue
配置项,允许用户自定义直接子代选择器行为 - 更精细化的处理了 css 选择器的转义逻辑
- 修复class name 第一个css selector 为数字,导致的16进制选择器问题,导致小程序报错的问题,解决方案位添加首字母阻止\3转义
- 仓库改名为
weapp-tailwindcss
- 添加
arbitraryvalues
配置项,允许用户切换分割模式 - 使用
typedoc
来生成options
的文档 - 重构
mangle
功能代码,添加对应的单元测试用例,现在的单元测试代码覆盖率已经提升到了99%
修复了 tarojs vue3 框架下,由于vue3产生静态节点,产生静态的html字符串,导致js转义字符串时,没有匹配到相应字符串的问题。 不过这个这个改动也导致我们在写 tailwindcss class 的时候,使用任意值,无法在里面写双引号了。 什么意思呢?
after:content-["你好啊,我很无聊"] ×
after:content-['你好啊,我很无聊'] √
所以接下来会开放配置项,允许用户自行开启关闭这个问题,毕竟目前只在 taro vue3 里面出现。
- 最小支持 nodejs 版本为 16
- 增加
./webpack
路径下的导出和类型,现在都可以使用xxx/webpack
,xxx/vite
,xxx/gulp
,xxx/postcss
,xxx/replace
这类的方式来处理了 - 更完善的 readme.md
- 修复ts直接引入
./
下的type
智能提示问题
- 添加
mangle
配置项,可以对tailwindcss
生成的类名进行缩短以及混淆 - 添加
esm
支持
- 使用
exports
导出项目,去除根目录下的.d.ts
- 升级
pnpm
from v7 to v8 - 去除所有
webpack4
相关的依赖 - 使用
jest
测试cjs
,vitest
测试vite
相关case
- 采用
Github Action
进行正式发布以及自动生成github changelog
- class选择器支持 unicode
- 重写了转义核心方法,优化性能
- tarojs 在热更新时,保存非
[jt]sx
文件,比如tailwind.config.js
/xx.scss
文件,导致样式丢失的问题
- 去除所有的 v1 版本的插件,重构代码和更改目录,如果你还是想用 v1 插件,请锁定你的版本在
2.1.5
以下。 - 去除了无用的配置项
js
文件进行转义时,自动判断格式是cjs
还是esm
- 现在能针对
eval
包裹的js
脚本进行转义了 - 去除所有
mangle
相关代码,相关功能现在到 tailwindcss-mangle
- 给之前的
v1
版本的插件打上deprecated
标记,添加对应的jsdoc
- 整理目录去除
v1
版本的markdown
文件目录,相关转移到了website
中
- 默认按照环境变量来决定是否压缩js代码,同时添加
minifiedJs
配置项手动进行指定 [#164] - 修复
webpack filesystem
缓存,导致的二次编译结果错误问题。这是由于启用文件缓存后,webpack
二次打包时候直接使用缓存,而不去触发postcss
相关插件导致的。
- 升级
tailwindcss-patch
的最小版本,修复nodejs14
npm preinstall hook
报错的问题 - 把
tailwindcss
打补丁最低版本降到3.0.0
- 默认
jsMatcher
现在会包括.cjs
/.mjs
这种文件后缀名了
- 支持作为
gulp
插件使用 #161
修复 bg-[url('img_src')]
写法失效的问题 #158
- jsHandler 增强,添加了针对模板字符串的处理
- tailwindcss-patch 如今作为一个独立的
npm
包来依赖了 - 增强了所有字面量分割的方式,增强了针对
vue3
静态模板字符串的处理方式。
- 修复因
typescript
升级5.x
导致的dts
路径错误问题 - 展开
:is()
#153
rpx
支持,在patch
时,语法上统一转化为单引号字符串数组。
- 大量的文档优化
- 增加
customReplaceDictionary
的simple
/complex
模式,simple
为更简短的className
replace
导出所有,用于自定义运行时对replace
行为进行二次封装。
- typescript dts fixed
文档更新,添加 customAttributes
案例
- 实现
customAttributes
*
全匹配的逻辑
- 额外导出
UniAppWeappTailwindcssWebpackPluginV5
用于uni-app
的vue/cli 5
版本
- 添加
uni-app-webpack5
Demo 用于vue/cli 5
版本 - uni-app Readme 完善
- 添加
supportCustomLengthUnitsPatch
配置项,默认开启。
自从tailwindcss 3.2.0
对任意值添加了长度单位的校验后,小程序中的rpx
这个wxss
单位,由于不在长度合法名单中,于是被识别成了颜色,导致与预期不符,详见:issues/110。
所以这个选项是用来给tailwindcss
运行时,自动打上一个支持rpx
单位的补丁。默认开启,在绝大部分情况下,你都可以忽略这个配置项,除非你需要更高级的自定义。
比较和处理的策略详见 patcher.ts
- 升级
rollup
主版本和相关包到3
, 优化rollup
打包生成的chunk
- 添加
cli
, 目前添加了patch
指令,可手动给tailwindcss
打上patch
。具体执行npx weapp-tailwindcss patch
ornpx weapp-tw patch
- 在安装这个包后,会自动检索
tailwindcss
运行时源码,打上支持rpx
的patch
。不过这种自动检索存在一定的缺陷,比如在第一次运行的时候会不生效,第二次运行的时候才生效了。这是因为 nodejs 运行时先加载好了tailwindcss
,然后再来运行插件,自动给tailwindcss
运行时打上patch
。此时由于tailwindcss
模块已经加载,所以patch
在第一次运行时不生效,ctrl+c 关闭之后,再次运行才生效。这种情况可以使用:
"scripts": {
+ "postinstall": "weapp-tw patch"
}
这样的 npm hook
来自动打 patch
- 使用
utf-8
中文字体进行wxml
条件判断时,会默认进行unicode
转义的bug.
- 去除
vite
插件使用windicss
和unocss
的命令行警告 - 添加
unocss
的使用文档和案例
customAttributes
现在允许使用Map
类型了,可以自定义匹配标签正则。
webpack jsx test case
完善
- 现在针对
wxml
的匹配默认会更加精准,同时也影响customAttributes
配置,详见 test/regexp-maker.test.ts customAttributes
现在允许正则类型了。
- 更改
readme
options
的排版, 去除原先的md table
,让阅读体验好一些。 - 去除
vite plugin
的重复性创建function
方法
- 增加
customAttributes
配置,用于自定义wxml标签上的转化属性,默认转化所有的class
和hover-class
。 - 增加
customReplaceDictionary
配置,自定义转化class
名称字典,你可以使用这个选项来简化生成的class
- 编写了第二版本的
jsx
处理方法,替换第一版本。 - 支持
vue2/vue3
+tsx
开发 #100
- 以模板为主的
uni-app
,mina
等等的wxml
变量处理方式,当遇到二元运算符时,忽略运算符中,字符串字面量的转义。
tailwindcss
伪元素jit
的自定义特殊字符。
- 重构重命名核心方法,为
v2
做准备。
vite
插件,可以直接注册,不需要再引入postcss
插件
- 暂时去除
mangle
配置 - 去除
lodash.groupby
引用,减少包的体积
- 添加
mangle
配置,用于压缩混淆className
,详见 mangle.md - 重构
transformSync
, 废弃mpRulePreflight
weapp-tailwindcss-webpack-plugin/replacer
额外暴露replaceEscapedCss
- 暴露
weapp-tailwindcss-webpack-plugin/mangle
插件
- using-arbitrary-variants 自定义选择器类名支持与修复 [#84]
- 添加
tailwindcss
默认伪元素的--tw-content
变量初始值 - 依赖处理方式改变,
postcss
和postcss-selector-parser
从编译时打入,变为安装时连带 - 精细化的移除选择器,当发现不支持的伪类选择器时,原先的策略是把
Rule
整个移除,现在会遍历这个Rule
的所有选择器,只把不支持的选择器的移除,当且仅当所有的选择器都被移除时,这个Rule
才被整个移除
- 修复
vite
版本tailwindcss
默认注入变量选择器undefined
的问题
- 允许用户使用
replaceUniversalSelectorWith
选项来自定义css
全局选择器*
的替换值 [issue#81]
- 修复在伪元素中使用
*
自动被替换的问题 #79
- 更改转义字典表,添加
*
,\\
和"
的默认转义,规范化以前转义生成的_[code]_
。
- 更新打包成
app
文档和模板选择文档 - 依赖更新
- 支持
taro 3.5
,用法如下:
简单修改 Taro 的编译配置即可切换使用 Webpack4 或 Webpack5 进行编译:
/** config/index.js */
const config = {
// 自定义编译工具,可选 'Webpack4' 或 'Webpack5'
compiler: 'webpack5'
}
其中:
Webpack4
使用TaroWeappTailwindcssWebpackPluginV4
进行注册Webpack5
使用TaroWeappTailwindcssWebpackPluginV5
进行注册
- 添加
disabled
配置项,用来表示是否禁用该插件,默认为false
,一般用于多平台构建,有些平台比如h5
不需要开启此插件,所以可以根据环境变量进行禁用。 onUpdate
这个生命周期hook
增加传入参数,即编译前的rawSource
和 编译后的newSource
作为第二和第三个参数,用于插件调试和文件内容比较。
- 添加
cssPreflightRange
配置项 pull/62,用来限制全局选择器影响的dom
范围,从而增加或者减少cssPreflight
注入的dom
,具体的使用方式见README.md
- 不再锁定
@babel/*
的具体版本
- 修复
remax
版本的hoverClassName
不处理的问题。(remax
命名比较特殊)
- 添加
tailwindcss
的dark mode
(media) 支持。 - 现在
uni-app
和taro
都会同时转义class
和hover-class
里的内容了 uni-app-vite-vue3-tailwind-vscode-template/issues/3。
- 修复
taro vue3
版本babel
处理导致打包失败的问题。
- 优化
ts
生成的.d.ts
文件的npm
包索引。
issues/53 在BaseJsxWebpackPlugin
的新文件开始处理前强制重置replacer
状态。(Thanks to sandro-qiang)
- 优化被分割的
vite
,postcss
的d.ts
智能提示
- 优化
Tree-shaking
,减小npm
包打包体积
issues/50 vite
插件依赖 webpack
问题
vite
引入插件的方式,改为:
import vwt from 'weapp-tailwindcss-webpack-plugin/vite';
import postcssWeappTailwindcssRename from 'weapp-tailwindcss-webpack-plugin/postcss';
issues/48 Source map 指向错误问题.
更改了兼容 webpack 4/5
的 react
版本插件的实现。原先是对 webpack
emit
后的产物进行分析和替换,现在新的实现为: 动态创建一个新的 jsx-rename-loader
,它运行在 babel-loader
之后,对 babel-loader
的产物进行替换。这样最终生成的 Source map
就不会存在指向错误问题了。
收到影响的 Plugin
:
- taro react :
TaroWeappTailwindcssWebpackPluginV4
- rax react :
RaxTailwindcssWebpackPluginV5
- remax react :
RemaxWeappTailwindcssWebpackPluginV4
Breaking change: handle wxml
with regex
instead of wxml-ast
issues/38.