跳到主要内容

@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.cssnormalize.css 的跨端静态版本偏保守、接近浏览器默认行为
modern-normalize.cssmodern-normalize 的跨端静态版本想要更现代、轻量的基线
eric-meyer.css经典 Eric Meyer reset需要强 reset、自己完全接管基础样式
sanitize/sanitize.csssanitize.css 主体规则更强调可访问性与默认安全值
sanitize/assets.csssanitize.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,
}),
],
}

插件默认保持兼容旧行为,只注入 buttonimage。如果你希望批量打开更多内置 reset,可以使用:

  • preset: 'form'
  • preset: 'content'
  • preset: 'media'
  • preset: 'all'

可额外控制的内置 reset 包括:

  • inputReset
  • textareaReset
  • listReset
  • navigatorReset
  • videoReset

如果你已经在项目里使用 weapp-tailwindcss/reset,无需迁移;两者行为保持一致,只是实际实现现在归属到这个包。

uni-app 用法

通常在 src/main.tsApp.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.cssnormalize.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.csspreflight.css 这些主包产物。它更像一个“可选 reset 仓库”,让你在入口处自行决定要引哪一套基线样式。

如果你已经在用 weapp-tailwindcss/index.css,是否还要额外引入这里的 reset,需要根据你的项目基线和组件库兼容性决定,不建议无脑叠加多套 reset。