Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions website/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,25 @@

docusaurus + tailwindcss

## 启动项目

```bash
# 安装依赖
pnpm install

# 启动项目
pnpm dev
```

## 报错解决

Module not found: Error: Can't resolve '@weapp-tailwindcss/merge' in '/Users/zzy/Projects/weapp-tailwindcss/website/src/theme/ReactLiveScope'

```bash
# 本地编译,cd 到根目录下

pnpm build

```

<https://tw.icebreaker.top/>
79 changes: 79 additions & 0 deletions website/docs/issues/use-with-taroify.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
# 和 Taroify 一起使用

`taro` 使用 [Taroify](https://taroify.github.io/taroify.com/) 的共同注意点:

由于 [Taroify](https://taroify.github.io/taroify.com/) 引入后,会导致 `tailwindcss` 的样式被覆盖,[Taroify](https://taroify.github.io/taroify.com/) 样式的优先级会高于 `tailwindcss`。

## 解决方案

### 修改Taroify引入方式

按照[Taroify](https://taroify.github.io/taroify.com/) 修改引入方式,将 `taroify` 引入方式改成按需引入

```bash
# 安装插件
yarn add babel-plugin-import
```

修改Babel配置文件,修改组件和图标样式的引入方式为手动引入

```js
// babel.config.js
module.exports = {
plugins: [
[
'import',
{
libraryName: '@taroify/core',
libraryDirectory: '',
// 这修改为false
style: false,
// style: false,
},
'@taroify/core',
],
[
'import',
{
libraryName: '@taroify/icons',
libraryDirectory: '',
camel2DashComponentName: false,
// 这里修改为false
style: false,
// style: () => "@taroify/icons/style",
customName: name => name === 'Icon' ? '@taroify/icons/van/VanIcon' : `@taroify/icons/${name}`,
},
'@taroify/icons',
],
],
}
```

### 修改引入样式顺序

修改根目录下的样式引入顺序,优先引入[Taroify](https://taroify.github.io/taroify.com/) 的样式,再引入Tailwindcss的样式

```tsx
// src/app.tsx

import Taro from '@tarojs/taro'

import '@taroify/icons/index.scss'
import '@taroify/core/index.scss'
import './app.scss'

...

```

```scss
// src/app.scss

@use 'tailwindcss/base';
@use 'tailwindcss/components';
@use 'tailwindcss/utilities';
```

## 参见

- [Taroify 官方文档](https://taroify.github.io/taroify.com/)
5 changes: 5 additions & 0 deletions website/docs/quick-start/install.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,11 @@ module.exports = {
// @tailwind base;
// @tailwind components;
// @tailwind utilities;

// sass 版本1.25+
// @use 'tailwindcss/base';
// @use 'tailwindcss/components';
// @use 'tailwindcss/utilities';
```

然后在 `app.ts` 里引入这个样式文件即可。
Expand Down
1 change: 1 addition & 0 deletions website/routes.json
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,7 @@
"/docs/issues/taro-terser",
"/docs/issues/toast-svg-bug",
"/docs/issues/use-with-nutui",
"/docs/issues/use-with-taroify",
"/docs/issues/use-with-wot-design-uni",
"/docs/issues/v1",
"/docs/mangle",
Expand Down
4 changes: 4 additions & 0 deletions website/sidebars.ts
Original file line number Diff line number Diff line change
Expand Up @@ -238,6 +238,10 @@ const issuesSidebar: SidebarConfig = [
type: 'doc',
id: 'issues/use-with-nutui',
},
{
type: 'doc',
id: 'issues/use-with-taroify',
},
{
type: 'doc',
id: 'issues/externalClasses',
Expand Down
Loading