- #355 将 js 和 css 相关结果全部由 core 抛出,会影响 api 的返回值
- 升级到
[email protected]
,采用新的内置补丁配置
- 使用新的
Tokenizer
来对wxml
进行词法分析获取最精确的结果, 完成 #319
- #316
- 修复原生小程序在一个
class
中使用 {{x}}-{{y}} 写法造成重复转译问题。
- 升级
tailwindcss-mangle
相关依赖包到3.0
- 修复
dts
类型问题 #308
- 支持涂鸦小程序
- 修复 #304
- 升级到
tailwindcss-patch@3
,支持tailwindcss postcss7 compat
的jit
模式
- 添加
cssRemoveHoverPseudoClass
配置,默认在小程序平台去除:hover
元素
- 添加对原生微信小程序的支持,添加
@weapp-tailwindcss/cli
- 整个项目变为
monorepo
- 去除
package.json
里的optionalDependencies
以减小安装依赖的大小,此时启用jsAstTool
:ast-grep
需要用户自己手动安装@ast-grep/napi
- 使用
htmlparser
的xml
模式来解析wxml
- 增加
jsAstTool
配置项,可选使用@ast-grep/napi
来解析js ast
,速度可提升1.5
-2
倍多左右
- Lock htmlparser2 version #268
https://tw.icebreaker.top/docs/migrations/v2
- 修复样式条件编译语法糖,uni-app 会在某些版本中破坏条件编译的注释,这时候需要这个插件去修复一下。
- 添加 uni-app-css-macro 样式条件编译语法糖相关功能
- 升级
rollup
相关依赖到4.x
- 添加
tailwindcssBasedir
配置项 - 异步化
postcss
以及缓存还有所有的插件
- 建立缓存机制,大幅增加
vite
插件的热更新速度
- mpx编译wxml属性值单引号问题 #241
- 建立缓存机制,大幅增加
webpack
插件的热更新速度
- 修复由于使用
eval
导致jsHandler
递归处理时的ast
解析错误问题。
- 添加
mergeVirtualHostAttributes
的virtualHost
虚拟节点支持
- 默认使用
jsEscapeStrategy
的replace
模式 - 重写了
wxml
解析器以代替正则匹配替换的方式,以做到更加精确的匹配 - 更加精准的
customAttributes
配置项,现在配置项中,使用字符串代表着,精确匹配标签或者属性,可以使用正则来匹配多个。
- 升级
tailwindcss-patch
相关的依赖到^2.1.0
- 添加
jsEscapeStrategy
配置项,用于切换所有的js
字符串中,处理字符串和模板字面量的替换模式。 - 详细配置见 https://tw.icebreaker.top/docs/api/interfaces/UserDefinedOptions#jsescapestrategy
- 升级
tailwindcss-patch
和@tailwindcss-mangle
相关依赖到2.x
版本
- 修复直接引用
npm
包时,不出现智能提示的问题
- 拆分
@weapp-core
相关的包引用 - 去除无用依赖,升级相关包到
esm
格式
- 添加
disabledDefaultTemplateHandler
配置项,可以禁用默认的模板标签匹配转化器
- 修复部分错误的
injectAdditionalCssVarScope
注入样式 - 修复因为英语水平差,造成长久以来的拼写问题:
templete -> template
- 升级
tailwindcss-patcher
到1.2.7
- 添加
jsPreserveClass
配置项,用于处理tailwindcss
和js
转义字面量撞车的情况。 - 现在所有的默认值可以通过
weapp-tailwindcss/defaults
获取到了,
- 修复带
*
的js
字面量,由于和tailwindcss
运行时冲突,导致错误转义的问题。
- 添加
injectAdditionalCssVarScope
配置项,用于tailwindcss
变量区域的重新注入
- 升级
@csstools
到最新版本,使用MIT-0
协议 - 升级
babel
相关的依赖
- 添加
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.