# すぐに始められる ここでは、プロジェクトでElementPlusを使用する方法について説明します。 ## コンポーネントの使用 ### すべてのコンポーネントの完全導入 > main.ts ```typescript import { createApp } from 'vue' import ElementPlus from 'element-plus' import 'element-plus/dist/index.css' import App from './App.vue' const app = createApp(App) app.use(ElementPlus) app.mount('#app') ``` ### オンデマンドでコンポーネントを導入 `ElementPlus`的なJS代弁者认为支持基于ESモジュール的[树揺](https://webpack.js.org/guides/tree-shaking/)。 > App.vue ```html ``` ### スタイルの紹介 スタイルの導入は、**完全なスタイルファイルを直接導入することを強くお勧めします**。アプリケーション全体のサイズが大きくなるように見えるかもしれませんが、 これによりパッケージングツールのプラグインを追加で導入する必要がなくなります(負担が少なくなります)。また、 [CDN](https://www.cloudflare.com/learning/cdn/what-is-)を使用することもできます。 a-cdn/) を使ってスタイルファイルを読み込むことで、アプリケーションの読み込みが速くなります。 JSの方法で紹介されました ```typescript import 'element-plus/dist/index.css' ``` HTMLヘッダで紹介 ```html ``` スタイルもオンデマンドで導入したい場合は、対応するツールが提供するプラグインを使って参照することができます。 [よくあるご質問](/#/zh-cn/component/quickstart#yokuarugo-zhi-wen)をご覧ください。 ## クイックビルドプロジェクトテンプレート ### vue-cli@4.5 をご利用ください。 の新バージョンに対応したvue-cliプラグインを用意しました。 をベースにしたプロジェクトを素早く構築するために使用できる[Element Plus plugins](https://github.com/element-plus/vue-cli-plugin-element-plus)を提供します。 Element Plusプロジェクト。 ### スターターキットの使い方 そのまま使える汎用的な[プロジェクトテンプレート](https://github.com/element-plus/element-plus-starter)を提供し、さらには Vite[テンプレート](https://github.com/element-plus/element-plus-vite-starter)を使用しています。 のために Laravelをお使いの方は、対応する[テンプレート](https://github.com/element-plus/element-plus-in-laravel-starter)も用意していますので、そのままダウンロードしてお使いいただけます。 ## グローバルコンフィギュレーション Element Plusを導入する際に、グローバルコンフィギュレーションオブジェクトを渡すことができます。 このオブジェクトは現在、`size` と `zIndex` フィールドをサポートしています。 サイズ は、コンポーネントのデフォルトサイズを変更するために使用され、`zIndex`は、ポップアップボックスの初期z-indexを設定します(デフォルト値:2000)。 要求に応じて「エレメント・プラス」を以下のように導入します。 ElementPlusを完全紹介。 ```js import { createApp } from 'vue' import ElementPlus from 'element-plus'; import App from './App.vue'; const app = createApp(App) app.use(ElementPlus, { size: 'small', zIndex: 3000 }); ``` ElementPlusのオンデマンド導入。 ```js import { createApp } from 'vue' import { ElButton } from 'element-plus'; import App from './App.vue'; const app = createApp(App) app.config.globalProperties.$ELEMENT = option app.use(ElButton); ``` 上記の設定により、プロジェクト内で`size`プロパティを持つすべてのコンポーネントのデフォルトサイズは「small」となり、ポップアップボックスの初期z-indexは3000となります。 ## Nuxt.jsを使う また、[Nuxt.js](https://nuxtjs.org)を使って
## スタートアップ VueとElement Plusをベースにした開発環境が整ったところで、いよいよコードを書いてみましょう。 各コンポーネントの使用方法については、各コンポーネントのドキュメントを参照してください。 ## よくあるご質問 ### コンポーネントとスタイルを同時にオンデマンドで導入したいのですが、どのようにすればよいでしょうか? #### viteでオンデマンドのローディングスタイル ビルドパッケージングツールとして[vite](https://vitejs.dev)を使用している場合は、オンデマンドでスタイルを読み込むために、まず `vite-plugin-element-plus` をインストールする必要があります。 ```shell yarn add vite-plugin-element-plus -D # または npm install vite-plugin-element-plus -D ``` 次に、`vite.config.js`ファイルに以下のコードを追加します。 ```typescript import { defineConfig } from 'vite' import vue from '@vitejs/plugin-vue' import VitePluginElementPlus from 'vite-plugin-element-plus' // https://vitejs.dev/config/ export default defineConfig({ plugins: [ vue(), VitePluginElementPlus({ // コンポーネント名].scssのソースファイルを使用する必要がある場合は、以下のようにコメントアウトを解除する必要があります。 // useSource: true // すべてのAPIについては、https://github.com/element-plus/vite-plugin-element-plus のドキュメントノートを参照してください。 }), ], }) ``` #### webpackによるオンデマンドでのスタイルの読み込み ビルドパッケージングツールとしてwebpackを使用している場合は、必要に応じてスタイルを読み込むために、まず`babel-plugin-import`をインストールする必要があります。 ```shell yarn add babel-plugin-import -D # または npm install babel-plugin-import -D ``` 次に、以下のコードを `babel.config.js` ファイルに追加してください。 > babel.config.js ```javascript module.exports = { plugins: [ // ...others [ "import", { libraryName: 'element-plus', customStyleName: (name) => { name = name.slice(3) // [name].cssファイルが必要な場合は、次の行を返す必要があります。 return `element-plus/es/${name}/style/css` // [name].scssファイルが必要な場合は、前の行のコードをコメントアウトし、次の行のコードをアンコメントする必要があります。 // return `element-plus/es/${name}/style`; }, }, ], ], }; ```