Skip to content
On this page

Astro 继承

UnoCSS 在 Astro 中的集成:@unocss/astro。查看示例

安装

bash
pnpm add -D unocss
pnpm add -D unocss
bash
yarn add -D unocss
yarn add -D unocss
bash
npm install -D unocss
npm install -D unocss
ts
// astro.config.ts
import { defineConfig } from 'astro/config'
import UnoCSS from 'unocss/astro'

export default defineConfig({
  integrations: [UnoCSS()]
})
// astro.config.ts
import { defineConfig } from 'astro/config'
import UnoCSS from 'unocss/astro'

export default defineConfig({
  integrations: [UnoCSS()]
})

创建一个 uno.config.ts 文件:

ts
// uno.config.ts
import { defineConfig } from 'unocss'

export default defineConfig({
  // ...UnoCSS 选项
})
// uno.config.ts
import { defineConfig } from 'unocss'

export default defineConfig({
  // ...UnoCSS 选项
})

样式重置

默认情况下,浏览器样式重置 不会被注入。要启用它,请安装 @unocss/reset 包:

bash
pnpm add -D @unocss/reset
pnpm add -D @unocss/reset
bash
yarn add -D @unocss/reset
yarn add -D @unocss/reset
bash
npm install -D @unocss/reset
npm install -D @unocss/reset

并更新您的 astro.config.ts

ts
// astro.config.ts
import { defineConfig } from 'astro/config'
import UnoCSS from 'unocss/astro'

export default defineConfig({
  integrations: [
    UnoCSS({
      injectReset: true // 或者重置文件的路径
    })
  ]
})
// astro.config.ts
import { defineConfig } from 'astro/config'
import UnoCSS from 'unocss/astro'

export default defineConfig({
  integrations: [
    UnoCSS({
      injectReset: true // 或者重置文件的路径
    })
  ]
})

不使用预设

此插件不带任何默认预设。

bash
pnpm add -D @unocss/astro
pnpm add -D @unocss/astro
bash
yarn add -D @unocss/astro
yarn add -D @unocss/astro
bash
npm install -D @unocss/astro
npm install -D @unocss/astro
ts
// astro.config.mjs
import UnoCSS from '@unocss/astro'

export default {
  integrations: [UnoCSS()]
}
// astro.config.mjs
import UnoCSS from '@unocss/astro'

export default {
  integrations: [UnoCSS()]
}

更多详情,请参考 Vite 插件

INFO

如果你正在构建一个基于 UnoCSS 的元框架,请参考这个文件中的示例,了解如何绑定默认预设。

注意事项

client:only 组件必须放置在 components 文件夹中,或者添加到 UnoCSS 的 extraContent 配置中,以便进行处理。

Released under the MIT License.