@weapp-tailwindcss/reset
@weapp-tailwindcss/reset 是一个独立的 reset 资源包,适合在 uni-app / Taro 项目的入口样式中直接导入,也可以直接作为 Tailwind 插件使用。
它现在同时提供两类能力:
- 静态样式文件集合,直接
import '@weapp-tailwindcss/reset/xxx.css' - Tailwind 插件入口,通过
reset({...})或@plugin注入 base 规则
为了兼容旧项目,weapp-tailwindcss/reset 仍然保留导出;但新的插件实现本体已经迁到 @weapp-tailwindcss/reset。
安装
pnpm add -D @weapp-tailwindcss/reset
当前提供的 reset
| 路径 | 说明 | 适用场景 |
|---|---|---|
button-after.css | 清理 button::after 默认样式 | 需要更自由地改按钮边框时优先引入 |
normalize.css | normalize.css 的跨端静态版本 | 偏保守、接近浏览器默认行为 |
modern-normalize.css | modern-normalize 的跨端静态版本 | 想要更现代、轻量的基线 |
eric-meyer.css | 经典 Eric Meyer reset | 需要强 reset、自己完全接管基础样式 |
sanitize/sanitize.css | sanitize.css 主体规则 | 更强调可访问性与默认安全值 |
sanitize/assets.css | sanitize.css 的资源尺寸约束补充 | 与上面配套使用 |
tailwind.css | 静态版 Tailwind preflight | 想直接拿 Tailwind 风格 reset |
tailwind-compat.css | 移除按钮背景色重置的 Tailwind preflight | 和组件库一起使用时更稳妥 |
作为 Tailwind 插件使用
import reset from '@weapp-tailwindcss/reset'
export default {
plugins: [
reset({
preset: 'all',
listReset: false,
}),
],
}
插件默认保持兼容旧行为,只注入 button 和 image。如果你希望批量打开更多内置 reset,可以使用:
preset: 'form'preset: 'content'preset: 'media'preset: 'all'
可额外控制的内置 reset 包括:
inputResettextareaResetlistResetnavigatorResetvideoReset
如果你已经在项目里使用 weapp-tailwindcss/reset,无需迁移;两者行为保持一致,只是实际实现现在归属到这个包。
uni-app 用法
通常在 src/main.ts、App.vue 或全局入口样式中导入:
import '@weapp-tailwindcss/reset/uni-app/button-after.css'
import '@weapp-tailwindcss/reset/uni-app/tailwind-compat.css'
如果你使用 sanitize.css,通常要把两个文件一起引入:
import '@weapp-tailwindcss/reset/uni-app/sanitize/sanitize.css'
import '@weapp-tailwindcss/reset/uni-app/sanitize/assets.css'
Taro 用法
通常在 src/app.tsx 或入口样式中导入:
import '@weapp-tailwindcss/reset/taro/button-after.css'
import '@weapp-tailwindcss/reset/taro/tailwind-compat.css'
选择建议
- 项目里已经用了组件库,优先
button-after.css + tailwind-compat.css - 想接近 Tailwind 默认 preflight,选
tailwind.css - 想保守一点,选
modern-normalize.css或normalize.css - 想强力清空默认样式,选
eric-meyer.css - 想要更完整的默认安全值和资源约束,选
sanitize/sanitize.css + sanitize/assets.css
典型组合
import '@weapp-tailwindcss/reset/uni-app/button-after.css'
import '@weapp-tailwindcss/reset/uni-app/tailwind-compat.css'
上面这组通常适合有组件库的项目。
import '@weapp-tailwindcss/reset/taro/modern-normalize.css'
上面这组通常适合只想补一个轻量全局基线的项目。
与主包样式的关系
@weapp-tailwindcss/reset 不会替代 weapp-tailwindcss/index.css、preflight.css 这些主包产物。它更像一个“可选 reset 仓库”,让你在入口处自行决定要引哪一套基线样式。
如果你已经在用 weapp-tailwindcss/index.css,是否还要额外引入这里的 reset,需要根据你的项目基线和组件库兼容性决定,不建议无脑叠加多套 reset。