💨跨多端开发CSS兼容

何时开启插件

本插件主要作用于小程序环境，让开发者可以在小程序环境下可以使用 tailwindcss 的特性

然而在 h5 和 app 中，它们本来就是 tailwindcss 支持的环境，所以是没有必要开启本插件的。

所以你可以这样传入 disabled 选项。

uni-app 示例

比如 uni-app:

vite.config.[jt]s
const isH5 = process.env.UNI_PLATFORM === "h5";
// uni-app v2
// const isApp = process.env.UNI_PLATFORM === "app-plus";
// uni-app v3
const isApp = process.env.UNI_PLATFORM === "app";
// 只在小程序平台开启 weapp-tailwindcss 插件
const WeappTailwindcssDisabled = isH5 || isApp;

const vitePlugins = [
  uni(), 
  uvwt({
    disabled: WeappTailwindcssDisabled
  })
];

Taro 示例

config/index.ts
const isH5 = process.env.TARO_ENV === "h5";
const isApp = process.env.TARO_ENV === "rn";
const WeappTailwindcssDisabled = isH5 || isApp;

webpackChain(chain) {
  chain.merge({
    plugin: {
      install: {
        plugin: UnifiedWebpackPluginV5,
        args: [
          {
            disabled: WeappTailwindcssDisabled,
            rem2rpx: true
          }
        ]
      }
    }
  });
},

其他的框架，请自行在对应的文档中，发掘不同目标平台的环境变量判断方式。

uni-app 打包到 h5 svg icon 偏移问题

这是由于 tailwindcss 默认会把 svg 的 display 设置成 block 导致的，所以解决方案很简单

在你的全局样式，引入 tailwindcss 的地方下面加一行，进行样式覆盖:

@tailwind base;
@tailwind components;
@tailwind utilities;
/*  #ifdef  H5  */
svg {
  display: initial;
}
/*  #endif  */

uni-app 打包安卓 `rgb()` 颜色失效问题

这是由于 uni-app 打包成安卓中 webview 内核版本较低，无法兼容 rgb(245 247 255 / var(--tw-bg-opacity)) 这样的 css 写法导致的

这时候我们需要把这个写法，转换为兼容写法: rgba(245, 247, 255, var(--tw-bg-opacity))，具体解决方案:

安装 `postcss-preset-env`

npm
Yarn
pnpm
Bun

npm i -D postcss-preset-env

yarn add --dev postcss-preset-env

pnpm add -D postcss-preset-env

bun add --dev postcss-preset-env

设置 `postcss.config.js`

module.exports = {
  plugins: {
    tailwindcss: {},
    autoprefixer: {},
    'postcss-preset-env': {
      browsers: 'chrome >= 50', // configure a compatible browser version
    },
  },
};

这样，所有的 rgb 和 / 写法就被转化成兼容写法了。

CSS变量计算模式

在 tailwindcss@4 下，默认启用 CSS 变量计算模式。tailwindcss@3 默认不启用。

此模式下会去预编译所有的 css 变量和 calc 计算表达式。

比如 tailwindcss@4 下原先生成的样式为:

page,
:root {
  --spacing: 8rpx;
}
.h-2 {
  height: calc(var(--spacing) * 2);
}

在CSS变量计算模式启动，进行预编译之后，现在的结果为:

page,
:root {
  --spacing: 8rpx;
}
.h-2 {
  height: 16rpx;
  height: calc(var(--spacing) * 2);
}

这个模式可以解决很多手机机型 calc rpx 单位的兼容问题

可通过给插件，传入 cssCalc 配置项 false 来手动关闭这个功能

假如这时候你需要去除 CSS 变量的声明，你可以传入

{
  cssCalc: ['--spacing']
}
// 或者更精确的
{
  cssCalc: {
    includeCustomProperties: ['--spacing']
  }
}

你也可以传入正则表达式

这样生成的结果就是:

page,
:root {
  --spacing: 8rpx;
}
.h-2 {
  height: 16rpx;
}

通过这种方式可以解决手机机型 calc rpx 单位的兼容问题

详见: https://tw.icebreaker.top/docs/api/interfaces/UserDefinedOptions#csscalc

何时开启插件​

uni-app 示例​

Taro 示例​

uni-app 打包到 h5 svg icon 偏移问题​

uni-app 打包安卓 rgb() 颜色失效问题​

安装 postcss-preset-env​

设置 postcss.config.js​

CSS变量计算模式​