如果您想将 Quasar 嵌入到您现有的 Vite 项目中,请按照本指南安装并使用 @quasar/vite-plugin
。我们的 Vite 插件开箱即用地提供了 Quasar 的 tree-shaking 和 Quasar Sass 变量集成。
警告!前方限制
- 您确定已正确访问此页面吗?此页面将教您如何使用我们的 Vite 插件,但这与我们功能齐全的 带有 Vite 的 Quasar CLI 不同。
- 不支持使用我们的 Vite 插件进行 SSR 构建(仅通过带有 Vite 的 Quasar CLI 支持)。
Vite 的跨平台支持由社区插件处理。这些插件与 Quasar 的集成不像 Quasar CLI 那样紧密,可能会出现问题。因此,为了获得最佳的开发者体验,我们建议您改用 带有 Vite 的 Quasar CLI。
创建 Vite 项目
$ yarn create vite my-vue-app --template vue
content_paste
有关官方(完整)指南,请访问 Vite 项目脚手架指南。在提示时选择“Vue”。
安装
导航到您的 Vite 项目文件夹并安装必要的软件包。
提示
- 请注意,
@quasar/extras
是可选的。 - 此外,如果您想使用 Quasar Sass/SCSS 变量,则需要根据 Quasar UI 的版本添加
sass
依赖项- 对于 Quasar >= v2.14,添加
sass@^1.33.0
- 对于 Quasar <= v2.13,添加
[email protected]
(请注意确切的固定版本)
- 对于 Quasar >= v2.14,添加
$ yarn add quasar @quasar/extras
$ yarn add --dev @quasar/vite-plugin sass@^1.33.0
content_paste
使用 Quasar
我们构建了一个配置器,可帮助您尽快上手
Roboto 字体
Roboto 字体扩展
来自 Animate.css 的动画
Material Icons
Material Icons (Outlined)
Material Icons (Round)
Material Icons (Sharp)
Material Symbols (Outlined)
Material Symbols (Rounded)
Material Symbols (Sharp)
MDI v7
Fontawesome v6
Fontawesome v5
Ionicons v4
Eva Icons
Themify
Line Awesome
Bootstrap Icons
Quasar Sass/SCSS 变量
Quasar 配置对象
// FILE: main.js
import { createApp } from 'vue'
import { Quasar } from 'quasar'
// Import icon libraries
import '@quasar/extras/material-icons/material-icons.css'
// Import Quasar css
import 'quasar/src/css/index.sass'
// Assumes your root component is App.vue
// and placed in same folder as main.js
import App from './App.vue'
const myApp = createApp(App)
myApp.use(Quasar, {
plugins: {}, // import Quasar plugins and add here
})
// Assumes you have a <div id="app"></div> in your index.html
myApp.mount('#app')
content_paste
// FILE: vite.config.js
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import { quasar, transformAssetUrls } from '@quasar/vite-plugin'
// https://vite.vuejs.ac.cn/config/
export default defineConfig({
plugins: [
vue({
template: { transformAssetUrls }
}),
// @quasar/plugin-vite options list:
// https://github.com/quasarframework/quasar/blob/dev/vite-plugin/index.d.ts
quasar({
sassVariables: 'src/quasar-variables.sass'
})
]
})
content_paste
// FILE (create it): src/quasar-variables.sass
$primary : #1976D2
$secondary : #26A69A
$accent : #9C27B0
$dark : #1D1D1D
$positive : #21BA45
$negative : #C10015
$info : #31CCEC
$warning : #F2C037
content_paste
@quasar/vite-plugin 选项
完整的选项列表可以在 此处 找到。
RTL 支持
要启用,请查看我们的 RTL 支持 页面并按照说明操作。