{"id":14968174,"url":"https://github.com/dcasia/mini-program-tailwind","last_synced_at":"2025-05-16T13:06:11.016Z","repository":{"id":37382304,"uuid":"464831346","full_name":"dcasia/mini-program-tailwind","owner":"dcasia","description":"让你的小程序用上原汁原味的 Tailwind/Windi CSS","archived":false,"fork":false,"pushed_at":"2024-03-07T15:14:05.000Z","size":2219,"stargazers_count":512,"open_issues_count":33,"forks_count":41,"subscribers_count":12,"default_branch":"development","last_synced_at":"2025-04-03T10:09:43.739Z","etag":null,"topics":["atomic-css","css","mini-program","postcss","tailwind","tailwindcss","taro","uni-app","unocss","weapp","webpack","wechat","windicss"],"latest_commit_sha":null,"homepage":"https://www.craft.do/s/Wx2f9cjGwyZYOx","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dcasia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-01T09:43:32.000Z","updated_at":"2025-03-31T11:37:01.000Z","dependencies_parsed_at":"2024-06-19T06:15:11.310Z","dependency_job_id":"45eda482-c91a-4719-996f-e725bf59c801","html_url":"https://github.com/dcasia/mini-program-tailwind","commit_stats":{"total_commits":122,"total_committers":5,"mean_commits":24.4,"dds":0.05737704918032782,"last_synced_commit":"8bff58fd197893a9f365ad5548be76567adfb8fa"},"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcasia%2Fmini-program-tailwind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcasia%2Fmini-program-tailwind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcasia%2Fmini-program-tailwind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dcasia%2Fmini-program-tailwind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dcasia","download_url":"https://codeload.github.com/dcasia/mini-program-tailwind/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248531336,"owners_count":21119746,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["atomic-css","css","mini-program","postcss","tailwind","tailwindcss","taro","uni-app","unocss","weapp","webpack","wechat","windicss"],"created_at":"2024-09-24T13:39:27.644Z","updated_at":"2025-04-12T07:23:01.732Z","avatar_url":"https://github.com/dcasia.png","language":"TypeScript","readme":"![wechat-mp-plugin](https://user-images.githubusercontent.com/3030587/158826917-30c79222-b79d-4857-88f9-7e4184d1e771.jpg)\n\n# Mini Program Tailwind Webpack Plugin\n\n让你的小程序用上原汁原味的 Tailwind/Windi CSS\n\n\u003e 来自 [Digital Creative](https://digitalcreative.cn/), 一家位于上海的数字产品调研、设计与开发公司。\n\u003e \u003cdetails\u003e\n\u003e   \u003csummary\u003e了解我们\u003c/summary\u003e\n\u003e  \n\u003e - [What we do](https://en.digitalcreative.cn/what-we-do/)\n\u003e - [About us](https://en.digitalcreative.cn/about)\n\u003e - [Contact us](https://en.digitalcreative.cn/contact)\n\u003e \u003c/details\u003e\n\n*推荐阅读 [独立文档](https://www.craft.do/s/Wx2f9cjGwyZYOx) 以获得更好的阅读体验 ♥️*\n\n---\n\n## 介绍\n\n由于小程序本身不支持由 Tailwind/Windi CSS 产生的选择器名称中包含的一些特殊转义字符（如 `\\[` `\\!` `\\.` 等），这使得你在开发小程序时无法使用一些本该在开发 Web 应用时使用的得心应手的灵活语法与 Arbitrary values/Value auto-infer 功能，如 `w-[30px]` `translate-x-1/2` `!bg-[#ff0000]` 等。这无疑对我们的开发效率与心智负担带来了不小的影响。\n\n为了突破这一限制，我们开发了这一款插件来帮助你在使用 Tailwind/Windi CSS 开发小程序时仍然保持着与开发 Web 应用高度一致的开发体验，你不再需要关注因为哪些字符串不被支持而不得不换一种写法的问题，而是继续**按照 Tailwind/Windi CSS 的官方语法继续编写你的小程序样式**，背后的兼容工作则由这款插件静默处理。\n\n此外，本插件还集成了 `rpx` 值自动转换的功能。该功能可以将 Tailwind/Windi CSS 配置文件中以及源码中我们书写的 `rem` 与 `px` 单位的值在最终生成的样式文件中自动转换为 `rpx` 单位的值。这既可以让开发者复用在 Web 项目中使用的同一份主题配置又可以让小程序继续使用 responsive pixel 带来的特性。\n\n\u003e \u003cdetails\u003e\n\u003e     \u003csummary\u003e进一步了解本插件的工作原理\u003c/summary\u003e\n\u003e     \n\u003e [让你的小程序用上原汁原味的 Tailwind/Windi CSS](https://juejin.cn/post/7093809282272985119/)\n\u003e \u003c/details\u003e\n\n- - -\n## 快速开始\n\n选择其中一个适合你的小程序类型进行插件安装\n\n\u003cdetails\u003e\n\n\u003csummary\u003e⚙️ 常规 Webpack 类小程序（以 MPX 为例）\u003c/summary\u003e\n\n### 常规 Webpack 类小程序（以 MPX 为例）\n\n\u003e [MPX](https://mpxjs.cn/), 一款具有优秀开发体验和深度性能优化的增强型跨端小程序框架。\n\n由于 MPX 框架为典型的以 Webpack 为构建工具的增强型小程序开发框架，所以本次安装示范将 MPX 项目作为典型案例来演示如何为大部分 Webpack 类小程序项目进行插件安装。**以下安装步骤在 Webpack 项目中具有广泛的通用性**，对于大部分 Webpack 类小程序项目只需参考相同步骤进行安装即可。\n\n#### 安装 windicss-webpack-plugin\n\n```sh\nnpm i windicss-webpack-plugin -D\n```\n\n\u003e \u003cdetails\u003e\n\u003e \u003csummary\u003e参考 Windi CSS 官方文档了解更多细节\u003c/summary\u003e\n\u003e    \n\u003e [Windi CSS Webpack 集成](https://windicss.org/integrations/webpack.html)\n\u003e \u003c/details\u003e\n\n#### 安装 @dcasia/mini-program-tailwind-webpack-plugin\n\n```sh\nnpm i @dcasia/mini-program-tailwind-webpack-plugin -D\n```\n\n#### 更新 webpack 配置文件\n\n使用 Webpack 插件\n\n```javascript\n//webpack.base.conf.js\nconst WindiCSSWebpackPlugin = require(\"windicss-webpack-plugin\");\nconst MiniProgramTailwindWebpackPlugin = require(\"@dcasia/mini-program-tailwind-webpack-plugin\")\n\nmodule.exports = {\n  plugins: [\n    new WindiCSSWebpackPlugin(),\n    new MiniProgramTailwindWebpackPlugin({\n      // options\n    })\n  ]\n}\n```\n\n#### 新建 Windi CSS 配置文件\n\n在项目根目录新建 `windi.config.js` 配置文件\n\n```javascript\n//windi.config.js\nexport default {\n  preflight: false,\n  prefixer: false,\n  extract: {\n    // 将 .mpx 文件纳入范围（其余 Webpack 类小程序根据项目本身的文件后缀酌情设置）\n    include: ['src/**/*.{css,html,mpx}'],\n    // 忽略部分文件夹\n    exclude: ['node_modules', '.git', 'dist']\n  },\n  corePlugins: {\n    // 禁用掉在小程序环境中不可能用到的 plugins\n    container: false\n  }\n}\n```\n\n\u003e 此处 Tailwind CSS 配置文件同样适用\n\u003e \u003cdetails\u003e\n\u003e \u003csummary\u003e参考 Windi CSS 官方文档了解更多细节\u003c/summary\u003e\n\u003e    \n\u003e [Windi CSS 配置文件兼容规则](https://windicss.org/guide/configuration.html)\n\u003e \u003c/details\u003e\n\n#### 在入口文件中引入 Windi CSS 的产物\n\n```html\n// app.mpx\n\u003cstyle src=\"windi.css\"\u003e\u003c/style\u003e\n```\n  \n\u003e 对于其余非 MPX 项目的 Webpack 类小程序，可参考类似的方式在入口文件中引入 `windi.css` 即可，如：\n\u003e ```javascript\n\u003e // main.js\n\u003e import 'windi.css'\n\u003e ``` \n\u003e \u003cdetails\u003e\n\u003e \u003csummary\u003e参考 Windi CSS 官方文档了解更多细节\u003c/summary\u003e\n\u003e    \n\u003e [引入 Windi CSS 样式文件](https://windicss.org/integrations/webpack.html#include-the-virtual-module)\n\u003e \u003c/details\u003e\n\n#### 完成\n开始享受在小程序项目中由 Windi CSS 带来的高效开发体验 🎉\n\n#### 可配置参数\n\n| **名称**      | **类型**  | **默认** | **描述**                          |\n| ----------- | ------- | ------ | ------------------------------- |\n| enableRpx   | Boolean | `true`   | 是否开启自动转换至 rpx 单位值的功能            |\n| designWidth | Number  | `350`    | 设计稿的像素宽度值，该尺寸会影响 rpx 转换过程中的计算比率 |\n| utilitiesSettings.spaceBetweenItems | `Array\u003cstring\u003e`  | `[]`   | 使用了 Space Between utilities 的容器中的子组件的名称。默认已包含 view, button, text, image 四个常用组件，所以大部分情况下开发者不需要配置该项。如需新增则可以在数组中添加新的组件名称。 |\n| utilitiesSettings.divideItems | `Array\u003cstring\u003e` | `[]` | 使用了 Divide width utilities 的容器中的子组件的名称。默认已包含 view, button, text, image 四个常用组件，所以大部分情况下开发者不需要配置该项。如需新增则可以在数组中添加新的组件名称。 |\n\n#### 案例\n\u003e [集成案例：MPX 项目](./examples/mpx)\n  \n\u003c/details\u003e\n\n\u003cdetails\u003e\n\n\u003csummary\u003e👽 Taro 小程序\u003c/summary\u003e\n\n### Taro 小程序\n\n\u003e [Taro](https://taro.jd.com/), 多端统一开发解决方案\n\n本插件包含 Taro 插件，通过“一键安装”的方式来便捷的适配 Taro 小程序。\n\n\u003e Taro 插件已兼容以下前端框架\n\u003e - React\n\u003e - Vue 2\n\u003e - Vue 3\n\u003e - Preact\n\u003e\n\u003e 同时也兼容在混合原生组件开发中使用 Tailwind/Windi CSS\n\n#### 安装 @dcasia/mini-program-tailwind-webpack-plugin\n\n```other\nnpm i @dcasia/mini-program-tailwind-webpack-plugin -D\n```\n\n#### 使用 Taro 插件\n\n```javascript\n// config/index.js\nconst config = {\n  plugins: [\n    ['@dcasia/mini-program-tailwind-webpack-plugin/dist/taro', {\n      // ...options\n    }]\n  ]\n}\n```\n\n#### 新建 Windi CSS 配置文件\n\n在项目根目录新建 `windi.config.js` 配置文件\n\n```javascript\n// windi.config.js\nexport default {\n  prefixer: false,\n  extract: {\n    // 忽略部分文件夹\n    exclude: ['node_modules', '.git', 'dist']\n  },\n  corePlugins: {\n    // 禁用掉在小程序环境中不可能用到的 plugins\n    container: false\n  }\n}\n```\n\n\u003e 此处 Tailwind CSS 配置文件同样适用\n\u003e \u003cdetails\u003e\n\u003e \u003csummary\u003e参考 Windi CSS 官方文档了解更多细节\u003c/summary\u003e\n\u003e    \n\u003e [Windi CSS 配置文件兼容规则](https://windicss.org/guide/configuration.html)\n\u003e \u003c/details\u003e\n\n#### 在入口文件中引入 Windi CSS 的产物\n\n```javascript\n// app.js\nimport 'windi.css';\n```\n\n#### 完成\n\n开始享受在 Taro 中由 Windi CSS 带来的高效开发体验 🎉\n\n#### 可配置参数\n\n| **名称**             | **类型**  | **默认**      | **描述**                                   |\n| ------------------ | ------- | ------------ | ---------------------------------------- |\n| enableWindiCSS     | Boolean | `true`         | 是否开启插件自带的 Windi CSS                      |\n| windiCSSConfigFile | String  | 读取项目根目录的配置文件 | 必要时手动设置 Windi CSS 配置文件的路径                |\n| enableRpx          | Boolean | `false`        | 是否开启自动转换至 rpx 单位值的功能（由于 Taro 自带该功能，默认关闭） |\n| designWidth        | Number  | `375`         | 设计稿的像素宽度值，该尺寸会影响 rpx 转换过程中的计算比率          |\n| utilitiesSettings.spaceBetweenItems | `Array\u003cstring\u003e`  | `[]`   | 使用了 Space Between utilities 的容器中的子组件的名称。默认已包含 view, button, text, image 四个常用组件，所以大部分情况下开发者不需要配置该项。如需新增则可以在数组中添加新的组件名称。 |\n| utilitiesSettings.divideItems       | `Array\u003cstring\u003e` | `[]` | 使用了 Divide width utilities 的容器中的子组件的名称。默认已包含 view, button, text, image 四个常用组件，所以大部分情况下开发者不需要配置该项。如需新增则可以在数组中添加新的组件名称。        |\n| utilitiesSettings.customComponents  | `Array\u003cstring\u003e` | `[]` | 对于使用 Uno CSS 作为 Atomic CSS 引擎的开发者需要根据项目情况配置。默认已包含所有小程序自带的组件名称，所以大部分情况下开发者不需要配置该项。如需新增则可以在数组中添加新的组件名称。                  |\n| enableDebugLog     | Boolean | `false`        | 是否开启打印本插件的内部运行日志                         |\n\n#### 案例\n\n\u003e - [集成案例：Taro - React 项目](https://github.com/dcasia/mini-program-tailwind/tree/development/examples/taro/react)\n\u003e - [集成案例：Taro - Vue 2 项目](https://github.com/dcasia/mini-program-tailwind/tree/development/examples/taro/vue-2)\n\u003e - [集成案例：Taro - Vue 3 项目](https://github.com/dcasia/mini-program-tailwind/tree/development/examples/taro/vue-3)\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\n\u003csummary\u003e🔗 uni-app 小程序\u003c/summary\u003e\n\n### uni-app 小程序\n\n\u003e [uni-app](https://uniapp.dcloud.net.cn/), 开发一次，多端覆盖。\n\n本篇内容包含 uni-app 的 Vue 3 与 Vue 2 两种安装示范。\n\n### Vue 3 安装示范\n\n\u003e 请参考下一个小程序类型：常规 Vite 类小程序（以 uni-app 为例）\n\n### Vue 2 安装示范\n\n#### 安装 windicss-webpack-plugin\n\n```sh\nnpm i windicss-webpack-plugin -D\n```\n\n\u003e \u003cdetails\u003e\n\u003e \u003csummary\u003e参考 Windi CSS 官方文档了解更多细节\u003c/summary\u003e\n\u003e    \n\u003e [Windi CSS Webpack 集成](https://windicss.org/integrations/webpack.html)\n\u003e \u003c/details\u003e\n\n#### 安装 @dcasia/mini-program-tailwind-webpack-plugin\n\n```sh\nnpm i @dcasia/mini-program-tailwind-webpack-plugin -D\n```\n\n#### 新建 Vue 配置文件\n\n在项目根目录新建 `vue.config.js` 配置文件并使用 Webpack 插件\n\n```javascript\n// vue.config.js\nconst WindiCSSWebpackPlugin = require(\"windicss-webpack-plugin\");\nconst MiniProgramTailwindWebpackPlugin = require(\"@dcasia/mini-program-tailwind-webpack-plugin\")\n\nmodule.exports = {  \n  configureWebpack: {  \n    plugins: [  \n      new WindiCSSWebpackPlugin(),\n      new MiniProgramTailwindWebpackPlugin({\n        // options\n      })\n    ]  \n  }  \n}\n```\n\n#### 新建 Windi CSS 配置文件\n\n在项目根目录新建 `windi.config.js` 配置文件\n\n```javascript\n//windi.config.js\nexport default {\n  preflight: false,\n  prefixer: false,\n  extract: {\n    // 忽略部分文件夹\n    exclude: ['node_modules', '.git', 'dist']\n  },\n  corePlugins: {\n    // 禁用掉在小程序环境中不可能用到的 plugins\n    container: false\n  }\n}\n```\n\n\u003e 此处 Tailwind CSS 配置文件同样适用\n\u003e \u003cdetails\u003e\n\u003e \u003csummary\u003e参考 Windi CSS 官方文档了解更多细节\u003c/summary\u003e\n\u003e    \n\u003e [Windi CSS 配置文件兼容规则](https://windicss.org/guide/configuration.html)\n\u003e \u003c/details\u003e\n\n#### 在入口文件中引入 Windi CSS 的产物\n\n```javascript\n// main.js\nimport 'windi.css'\n```\n\n#### 完成\n开始享受在小程序项目中由 Windi CSS 带来的高效开发体验 🎉\n\n#### 可配置参数\n\n| **名称**      | **类型**  | **默认** | **描述**                          |\n| ----------- | ------- | ------ | ------------------------------- |\n| enableRpx   | Boolean | `true`   | 是否开启自动转换至 rpx 单位值的功能            |\n| designWidth | Number  | `350`    | 设计稿的像素宽度值，该尺寸会影响 rpx 转换过程中的计算比率 |\n| utilitiesSettings.spaceBetweenItems | `Array\u003cstring\u003e`  | `[]`   | 使用了 Space Between utilities 的容器中的子组件的名称。默认已包含 view, button, text, image 四个常用组件，所以大部分情况下开发者不需要配置该项。如需新增则可以在数组中添加新的组件名称。 |\n| utilitiesSettings.divideItems       | `Array\u003cstring\u003e` | `[]` | 使用了 Divide width utilities 的容器中的子组件的名称。默认已包含 view, button, text, image 四个常用组件，所以大部分情况下开发者不需要配置该项。如需新增则可以在数组中添加新的组件名称。        |\n| utilitiesSettings.customComponents  | `Array\u003cstring\u003e` | `[]` | 对于使用 Uno CSS 作为 Atomic CSS 引擎的开发者需要根据项目情况配置。默认已包含所有小程序自带的组件名称，所以大部分情况下开发者不需要配置该项。如需新增则可以在数组中添加新的组件名称。                  |\n\n#### 案例\n\u003e [集成案例：uni-app Vue 2 项目](https://github.com/dcasia/mini-program-tailwind/tree/development/examples/uni-app/vue-2)\n  \n\u003c/details\u003e\n\n\u003cdetails\u003e\n\n\u003csummary\u003e🔩 常规 Vite 类小程序（以 uni-app 为例）\u003c/summary\u003e\n\n### 常规 Vite 类小程序（以 uni-app 为例）\n\n\u003e [uni-app](https://uniapp.dcloud.net.cn/), 开发一次，多端覆盖。\n\n由于在 uni-app 中使用 Vue 3 进行小程序开发时项目是基于 Vite 进行构建的，所以本次安装示范将 uni-app Vue 3 项目作为典型案例来演示如何为大部分 Vite 类小程序项目进行插件安装。**以下安装步骤在 Vite 项目中具有广泛的通用性**，对于大部分 Vite 类小程序项目只需参考相同步骤进行安装即可。\n\n#### 安装 vite-plugin-windicss 与 windicss\n\n```sh\nnpm i vite-plugin-windicss windicss -D\n```\n\n\u003e \u003cdetails\u003e\n\u003e \u003csummary\u003e参考 Windi CSS 官方文档了解更多细节\u003c/summary\u003e\n\u003e    \n\u003e [Windi CSS Vite 集成](https://windicss.org/integrations/vite.html)\n\u003e \u003c/details\u003e\n\n#### 安装 @dcasia/mini-program-tailwind-webpack-plugin\n\n```sh\nnpm i @dcasia/mini-program-tailwind-webpack-plugin -D\n```\n\n#### 更新 Vite 配置文件\n\n在 `vite.config.js` 配置文件中使用插件\n\n```javascript\n// vite.config.js\nimport WindiCSS from 'vite-plugin-windicss';\nimport MiniProgramTailwind from '@dcasia/mini-program-tailwind-webpack-plugin/rollup';\n\nexport default {\n  plugins: [\n    WindiCSS(),\n    MiniProgramTailwind()\n  ]\n}\n```\n\n#### 新建 Windi CSS 配置文件\n\n在项目根目录新建 `windi.config.js` 配置文件\n\n```javascript\n//windi.config.js\nexport default {\n  preflight: false,\n  prefixer: false,\n  extract: {\n    // 忽略部分文件夹\n    exclude: ['node_modules', '.git', 'dist']\n  },\n  corePlugins: {\n    // 禁用掉在小程序环境中不可能用到的 plugins\n    container: false\n  }\n}\n```\n\n\u003e 此处 Tailwind CSS 配置文件同样适用\n\u003e \u003cdetails\u003e\n\u003e \u003csummary\u003e参考 Windi CSS 官方文档了解更多细节\u003c/summary\u003e\n\u003e    \n\u003e [Windi CSS 配置文件兼容规则](https://windicss.org/guide/configuration.html)\n\u003e \u003c/details\u003e\n\n#### 在入口文件中引入 Windi CSS 的产物\n\n```javascript\n// main.js\nimport 'virtual:windi.css'\n```\n\n#### 完成\n开始享受在小程序项目中由 Windi CSS 带来的高效开发体验 🎉\n\n#### 可配置参数\n\n| **名称**      | **类型**  | **默认** | **描述**                          |\n| ----------- | ------- | ------ | ------------------------------- |\n| enableRpx   | Boolean | `true`   | 是否开启自动转换至 rpx 单位值的功能            |\n| designWidth | Number  | `350`    | 设计稿的像素宽度值，该尺寸会影响 rpx 转换过程中的计算比率 |\n| utilitiesSettings.spaceBetweenItems | `Array\u003cstring\u003e`  | `[]`   | 使用了 Space Between utilities 的容器中的子组件的名称。默认已包含 view, button, text, image 四个常用组件，所以大部分情况下开发者不需要配置该项。如需新增则可以在数组中添加新的组件名称。 |\n| utilitiesSettings.divideItems       | `Array\u003cstring\u003e` | `[]` | 使用了 Divide width utilities 的容器中的子组件的名称。默认已包含 view, button, text, image 四个常用组件，所以大部分情况下开发者不需要配置该项。如需新增则可以在数组中添加新的组件名称。        |\n| utilitiesSettings.customComponents  | `Array\u003cstring\u003e` | `[]` | 对于使用 Uno CSS 作为 Atomic CSS 引擎的开发者需要根据项目情况配置。默认已包含所有小程序自带的组件名称，所以大部分情况下开发者不需要配置该项。如需新增则可以在数组中添加新的组件名称。                  |\n\n#### 案例\n\u003e [集成案例：uni-app Vue 3 项目](https://github.com/dcasia/mini-program-tailwind/tree/development/examples/uni-app/vue-3)\n  \n\u003c/details\u003e\n\n\u003cdetails\u003e\n\n\u003csummary\u003e🛠 原生开发或自定义构建的小程序\u003c/summary\u003e\n\n### 原生开发或自定义构建工具的小程序\n  \n无论你的项目基于什么 bundler 或 workflow 工具进行开发，只要有一个可编程的文件监听与处理服务便可以进行自定义实现。但这里需要明确的一点是，**若想在以原生开发模式的基础之上去集成本插件的功能，则一定需要我们去启动一套可编程的文件监听处理服务作为插件的运行基础**，这个服务通常由配置好的 Webpack, Gulp 等第三方工具完成。\n\n\u003e \u003cdetails\u003e\n\u003e \u003csummary\u003e使用 Tailwind/Windi CSS CLI 的开发者请看\u003c/summary\u003e\n\u003e    \n\u003e 如果你是通过 Tailwind/Windi CSS 官方的 CLI 进行小程序 UI 开发，遗憾的是由于该 CLI 不支持插件机制而且不可能支持对于模板文件的修改，所以我们无法在此基础之上以自定义的方式集成本插件。\n\u003e \u003c/details\u003e\n\n我们将本插件的核心功能解耦并打包进了 `universal-handler.js` 文件中，若你想在自定义的构建工具中集成本插件的核心功能，可以在工作流逻辑中引入 `universal-handler`：\n\n```javascript\nconst { handleTemplate, handleStyle } = require('@dcasia/mini-program-tailwind-webpack-plugin/universal-handler')\n```\n\n处理 template:\n```javascript\nconst rawContent = '\u003cview class=\"w-10 h-[0.5px] text-[#ffffff]\"\u003e\u003c/view\u003e'\nconst handledTemplate = handleTemplate(rawContent)\n```\n\n处理 style:\n```javascript\nconst rawContent = '.h-\\\\[0\\\\.5px\\\\] {height: 0.5px;}'\nconst handledStyle = handleStyle(rawContent, options)\n```\n\n此后你便可以将处理过的字符串返回至工作流原本的流程中来生成最终的文件。\n\n\u003e \u003cdetails\u003e\n\u003e \u003csummary\u003e进一步了解自定义实现过程中的实践细节\u003c/summary\u003e\n\u003e    \n\u003e [小程序集成 Windi CSS 的自定义实现](https://juejin.cn/post/7093809282272985119#heading-5)\n\u003e \u003c/details\u003e\n\n#### 可配置参数\n\n| **名称**      | **类型**  | **默认** | **描述**                          |\n| ----------- | ------- | ------ | ------------------------------- |\n| enableRpx   | Boolean | `false`  | 是否开启自动转换至 rpx 单位值的功能            |\n| designWidth | Number  | `350`    | 设计稿的像素宽度值，该尺寸会影响 rpx 转换过程中的计算比率 |\n| utilitiesSettings.spaceBetweenItems | `Array\u003cstring\u003e`  | `[]`   | 使用了 Space Between utilities 的容器中的子组件的名称。默认已包含 view, button, text, image 四个常用组件，所以大部分情况下开发者不需要配置该项。如需新增则可以在数组中添加新的组件名称。 |\n| utilitiesSettings.divideItems       | `Array\u003cstring\u003e` | `[]` | 使用了 Divide width utilities 的容器中的子组件的名称。默认已包含 view, button, text, image 四个常用组件，所以大部分情况下开发者不需要配置该项。如需新增则可以在数组中添加新的组件名称。        |\n| utilitiesSettings.customComponents  | `Array\u003cstring\u003e` | `[]` | 对于使用 Uno CSS 作为 Atomic CSS 引擎的开发者需要根据项目情况配置。默认已包含所有小程序自带的组件名称，所以大部分情况下开发者不需要配置该项。如需新增则可以在数组中添加新的组件名称。                  |\n\n\n#### 案例\n\n\u003e [集成案例：基于 Gulp 进行自定义实现](./examples/native)\n\n\u003c/details\u003e\n\n\u003e 示范操作步骤均以集成 Windi CSS 为例（Windi CSS 的体验更佳且兼容 Tailwind CSS）\n\u003e \u003cdetails\u003e\n\u003e   \u003csummary\u003e进一步了解 Windi CSS\u003c/summary\u003e\n\u003e  \n\u003e [Windi CSS](https://windicss.org/)\n\u003e \u003c/details\u003e\n\n- - -\n\n## 陷阱\n- 在小程序中为了使组件样式可以被 Tailwind/Windi 的 CSS 产物作用到，我们需要在每一个组件的 JSON 配置文件中设置其[样式的作用域](https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/wxml-wxss.html#%E7%BB%84%E4%BB%B6%E6%A0%B7%E5%BC%8F%E9%9A%94%E7%A6%BB) `styleIsolation`，否则即使 Tailwind/Windi CSS 工作正常也无法用来开发组件 UI。\n    \u003e Taro 小程序不受该限制影响\n    ```json\n    {\n      \"component\": true,\n      \"styleIsolation\": \"apply-shared\"\n    }\n    ```\n    \u003e \u003cdetails\u003e\n    \u003e \u003csummary\u003e相关 issue\u003c/summary\u003e\n    \u003e    \n    \u003e [Issue #1](https://github.com/dcasia/wechat-mini-program-tailwind/issues/1)\n    \u003e \u003c/details\u003e\n\n- 由于目前微信开发者工具的热重载功能无法监听到样式文件内由 `@import` 导入的 wxss 文件内容的变动，所以当启用热重载功能开发时，模拟器不会随着你对 Tailwind/Windi CSS 的更改而更新 UI。目前微信官方已知晓该 bug 的存在，在该 bug 修复之前，我们建议你在开发时关闭热重载，用传统的页面自动刷新来预览每一次的 UI 更新。\n目前，该问题已在微信开发者工具 [1.06.2205231 RC](https://developers.weixin.qq.com/miniprogram/dev/devtools/rc.html#_1-06-2205231-%E6%9B%B4%E6%96%B0%E8%AF%B4%E6%98%8E) 中被修复。\n    \u003e \u003cdetails\u003e\n    \u003e \u003csummary\u003e相关 issue\u003c/summary\u003e\n    \u003e    \n    \u003e [Issue #3](https://github.com/dcasia/wechat-mini-program-tailwind/issues/3)\n    \u003e \u003c/details\u003e\n\n- 对于原生小程序中[外部样式类](https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/wxml-wxss.html#%E5%A4%96%E9%83%A8%E6%A0%B7%E5%BC%8F%E7%B1%BB)  `externalClasses` 的声明，插件仅支持将该 `externalClasses` 名称声明为 `'class'` 的做法，不支持其他名称。\n    ```javascript\n    Component({\n      externalClasses: [ 'class' ]\n    })\n    ```\n    \u003e \u003cdetails\u003e\n    \u003e \u003csummary\u003e相关 issue\u003c/summary\u003e\n    \u003e    \n    \u003e [Issue #44](https://github.com/dcasia/mini-program-tailwind/issues/44)\n    \u003e \u003c/details\u003e\n\n\n\n- - -\n## 功能对比\n\n| **语法**                                                 | **不使用本插件** | **使用本插件** |\n| ------------------------------------------------------ | ---------- | --------- |\n| **Regular**: `h-10` `text-white`                       | ✅          | ✅         |\n| **Arbitrary values/Value infer**: `t-[25px]` `bg-[#ffffff]`         | ❌          | ✅         |\n| **Fraction**: `translate-x-1/2` `w-8.5`                | ❌          | ✅         |\n| **Important**: `!p-1`                                  | ❌          | ✅         |\n| **RGB value infer**: `text-[rgb(25,25,25)]`            | ❌          | ✅         |\n| **Space between**: `space-y-2` `space-y-reverse`          | ❌          | ✅         |\n| **Divide width**: `divide-x-2` `divide-y-reverse`            | ❌          | ✅         |\n| **Variants**: `dark:bg-gray-800`                       | ❌          | ✅         |\n| **Variants groups**: `hover:(bg-gray-400 font-medium)` | ❌          | ✅         |\n| **Responsive**: `md:p-2`                               | ❌          | ✅         |\n| **Universal selector**: `*`                                     | ❌          | ✅         |\n| `rpx` value transformed from `rem` and `px` value      | ❌          | ✅         |\n\n- - -\n## 兼容范围\n\n- Webpack `\u003e= 4.0.0`\n- Taro `\u003e= 3.4.0`\n- MPX `\u003e= 2.7.5`\n- uni-app\n\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdcasia%2Fmini-program-tailwind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdcasia%2Fmini-program-tailwind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdcasia%2Fmini-program-tailwind/lists"}