빠른 시작
Vuetify 프로젝트를 바로 시작하려면 (공식 예제를 바탕으로한) Vuetify Vue CLI 패키지를 사용하세요. Vuetify는 SSR (서버사이드 렌더링), SPA (싱글페이지 어플리케이션), PWA (프로그레시브 웹 어플리케이션)와 단독 HTML 페이지를 지원합니다.
지원하는 브라우져
Vuetify는 웹개발의 다음 단계로 나아가는 것을 추구하는 진보적인 프레임웤입니다. 이 과업을 성취하기 위해, 오래된 버변의 인터넷 익스플로러를 지원하지 않는 다소의 희생이 있어야만 했습니다. 이 리스트는 호환되는 브라우져에 대한 완벽한 리스트는 아니지만 주로 지원하는 브라우져들입니다.
새로운 어플리케이션
Vue-CLI 3 is the next generation cli tool made to help you get started more easily than before. When you start your app with vue-cli you will also be able to get the official webpack updates and config changes, as well as Vuetify's updates without an arduous upgrade process.
For information on how to use Vue-CLI-3, visit the official documentation
Once the cli is installed, you can generate a new project scaffold. Select the default install unless you have specific packages that you need to include (e.g. vuex or vue-router). This will create a new Vue project that's ready to go with your selected options.
Tip: If you already have vue-cli installed, make sure you are on the latest version by typing vue --version into your cli.
Now that you have an instantiated project, you can add the Vuetify package using the cli.
This will provide you with a set of options for customizing your installation. The default preset has a-la-carte already enabled for you.
After installation simply run yarn serve or npm run serve to start your application.
기존 어플리케이션
Vuetify를 기존 프로젝트에 적용하려면 Vuetify를 node_modules에 반드시 설치해야 합니다. 이를 위해 npm
이나 yarn
을 사용할 수 있습니다. 이 두 패키지 매니져는 당신의 어플리케이션에 사용되는 리소스를 관리할 수 있도록 해줍니다.
npm
을 사용하기 위한 더 자세한 설명은 공식문서에서 확인할 수 있습니다. npm
대신 yarn
을 사용하고 싶다면 여기에 공식문서가 있습니다. npm이나 yarn의 셋업(setup)이 끝나면 Vuetify를 설치하기 위해 다음 두 명령어중에 하나를 명령줄(command prompt)에서 사용할 수 있습니다.
Vuetify 가 설치되었다면, 어플리케이션의 메인 엔트리 포인트로 이동합니다. 대부분의 경우는 index.js
나 main.js
일 겁니다. 이 파일에서 Vuetify 를 임포트(import)하고 Vue에게 Vuetify를 사용하도록 지시해야합니다.
다음엔 Vuetify css 파일은 인클루드(include) 해야합니다. 간단하게 index.html
파일에서 include 하거나 실제 스타일러스(stylus) 파일이나 minified css 파일을 import 합니다.
머티리얼 디자인 아이콘들을 include 하는 가장 쉬운 방법은 index.hteml
파일에 link
태그를 추가하는 것입니다.
Alternatively use npm
or yarn
to install material-design-icons-iconfont
.
경고: Vuetify 는 css 충돌을 최대한 줄이려고 노력하지만, Vuetify 를 기존의 프로젝트의 추가할때 당신의 커스텀 스타일들과 문제를 만들지 않을 거라고 보장하지는 못합니다.
Vue UI
Vuetify can also be installed using Vue UI, the new visual application for vue-cli-3. Ensure that you have the latest version of vue-cli installed and from your terminal type:
This will start the Vue User Interface and open a new window in your browser. On the left side of your screen, click on Plugins. Once navigated, simply search for Vuetify in the input field.
After installation, you will have the option to configure your application's default Vuetify settings.
CDN을 이용한 설치
Vue CLI 를 이용한 템플릿 설치 없이 Vuetify.js를 테스트해보려면 아래 코드를 복사해서 index.html
파일에 붙여넣으세요. 이 코드는 최신 버젼의 Vue와 Vuetify를 받아서 컴포넌트들을 가지고 놀 수 있게 해줍니다. 또한 codepen 사이트의 Vuetify starter를 이용할 수도 있습니다.
IE11 & Safari 9 지원
Vuetify utilizes features of ES2015/2017 that require the need to use polyfills for Internet Explorer 11 and Safari 9/10. If you are using vue-cli-3, this is done automatically for you. Otherwise, in your project directory, you can install babel-polyfill
:
인터넷 익스플로러 <template>
태그를 제대로 지원하지 못하기 때문에 항상 완전히 컴파일된 DOM 요소들을 브라우져로 보내야 합니다. This can be done by either building your Vue code in advance or by creating helper components to replace the dom elements. For instance, if sent directly to IE, this will fail:
It is recommended that you use babel-preset-env
with the corresponding polyfill to ensure only the necessary polyfills are added to your application. For more information on babel-present-env
, visit the documentation
Once installed, add the preset to your .babelrc
or babel.config.js
Unfortunately vue-cli-3 doesn't automatically bring IE11 compatibility in which you may encounter various errors (such as Symbol is not defined). To assist in resolving these errors you may need to manually add transpileDependencies
parameter in vue.config.js
Unfortunately vue-cli-3 doesn't automatically bring IE11 compatibility in which you may encounter various errors (such as Symbol is not defined). To assist in resolving these errors you may need to manually add transpileDependencies
parameter in vue.config.js
Due to Internet Explorer's limited support for <template>
tags, you must send fully compiled dom elements to the browser. This can be done by either building your Vue code in advance or by creating helper components to replace the dom elements. For instance, if sent directly to IE, this will fail: