赵忠林
5f71295aae
- 实现 postcss-remove-wxss-incompatible 插件 - 移除反斜杠转义的重要性修饰符类选择器（.\!xxx） - 删除依赖 :not 和兄弟选择器的 .space-[x|y]-* 规则 - 删除依赖 :not 和兄弟选择器的 .divide-[x|y]-* 规则 - 解决微信小程序 WXSS 不支持的 CSS 特性问题
2.2 KiB
2.2 KiB
websopy-taro 项目记忆
Tailwind CSS 在小程序中的兼容性规则
以下 Tailwind 类名在 WXSS 中不兼容，项目内禁止使用，已通过 PostCSS 插件 postcss-remove-wxss-incompatible.js 自动移除对应的 CSS 规则：
-
!xxximportant 修饰符（如!visible）：生成.!visible选择器，WXSS 不支持反斜杠转义的!。 -
带
0.5的类名（如w-0.5、h-0.5、gap-0.5）：类名中的.被转义为\.，生成.w-0\.5这样的选择器，WXSS 不兼容。应改用等效的整数尺寸或自定义值替代。 -
space-x-*/space-y-*（如space-y-4）：依赖:not()+~兄弟组合器 + CSS 变量 + 嵌套calc()，WXSS 全不支持。应改用flex flex-col gap-*实现等效间距。 -
divide-x-*/divide-y-*：同样依赖:not()+~，WXSS 不兼容。
替代方案速查
| 禁用类名 | 替代写法 |
|---|---|
space-y-4 |
flex flex-col gap-4 |
space-x-4 |
flex flex-row gap-4 |
!visible |
直接写 style={{ visibility: 'visible' }} 或自定义类 |
w-0.5 |
用自定义值或 w-1 替代 |
微信小程序接口合规
剪切板接口（运营规范 5.15.4）
- 只允许用户主动触发复制：所有
Taro.setClipboardData调用必须绑定在明确的用户点击事件上，禁止在无用户操作时自动读写剪切板。 - 禁止复制后强制中断流程：复制成功后不得强制跳转、强制关注、强制添加客服等，不能要求用户通过其他方式才能完成当前业务流程。
- 避免重复 Toast 干扰体验：微信小程序调用
setClipboardData成功后系统会自带「内容已复制」提示。为避免重复提示，统一封装utils/common.ts中的copyText函数：小程序端不再额外显示自定义复制成功Toast，失败时仍显示错误提示。
项目内剪切板使用现状
已审查所有 setClipboardData 调用：
- 均通过按钮点击触发（复制咨询模板、复制密钥、复制链接、复制兑换码等）
- 无
getClipboardData（自动读取剪切板）调用 - 无复制后强制跳转或中断业务流程的行为
当前实现基本符合 5.15.4 规范。