# Установка
# Примечание совместимости
- Vue.js версии
2.0.0
+
# Загрузка файла / CDN
https://unpkg.com/vue-i18n@8 (opens new window)
Сервис unpkg.com (opens new window) предоставляет CDN-ссылки на основе NPM-пакетов. Ссылка выше будет всегда указывать на последнюю версию на NPM. Можно использовать конкретную версию или тег с помощью URL следующего вида https://unpkg.com/vue-i18n@8.17.5/dist/vue-i18n.js (opens new window)
При подключении vue-i18n после Vue плагин установит себя автоматически:
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script src="https://unpkg.com/vue-i18n@8"></script>
# NPM
npm install vue-i18n
# Yarn
yarn add vue-i18n
При использовании системы модулей нужно явно устанавливать vue-i18n
через Vue.use()
:
import Vue from 'vue'
import VueI18n from 'vue-i18n'
Vue.use(VueI18n)
Подобного не требуется делать при подключении через глобальный тег <script>
.
# Vue CLI 3.x
vue add i18n
Предварительно требуется установить Vue CLI 3.x, его можно установить следующей командой:
npm install @vue/cli -g
# Dev-сборка
При необходимости использовать последнюю dev-сборку нужно склонировать репозиторий с GitHub и выполнить сборку vue-i18n
самостоятельно.
git clone https://github.com/kazupon/vue-i18n.git node_modules/vue-i18n
cd node_modules/vue-i18n
npm install # или `yarn`
npm run build # или `yarn run build`
# Отличия различных сборок
Внутри каталога dist / NPM-пакета (opens new window) можно обнаружить несколько различных сборок VueI18n. Вот следующие отличия между ними:
- UMD:
vue-i18n.js
- CommonJS:
vue-i18n.common.js
- ES Module для систем сборки:
vue-i18n.esm.js
- ES Module для браузеров:
vue-i18n.esm.browser.js
# Термины
UMD (opens new window): UMD-сборки можно использовать непосредственно в браузере через тег
<script>
. Файл по умолчанию с Unpkg CDN https://unpkg.com/vue-i18n (opens new window) указывает на UMD-сборку (vue-i18n.js
).CommonJS (opens new window): CommonJS сборки предназначены для использования со старыми системами сборки, такими как browserify (opens new window) или webpack 1 (opens new window). Файлом по умолчанию для этих систем сборки (
pkg.main
) будет сборка CommonJS (vue-i18n.common.js
).ES Module (opens new window): VueI18n, начиная с версии 8.11, предоставляет две сборки ES-модулей (ESM):
- ESM для систем сборки: предназначен для использования с современными системами сборки, такими как webpack 2 (opens new window) или Rollup (opens new window). Формат ESM разработан для возможности статического анализа, чтобы системы сборки могли применять "tree-shaking" и удалять неиспользуемый код из финального приложения. Файлом по умолчанию для этих систем сборки (
pkg.module
) будет ES-сборка (vue-i18n.esm.js
). - ESM для браузеров (только для 8.11+,
vue-i18n.esm.browser.js
): предназначен для импорта напрямую в современных браузерах через тег<script type="module">
.
- ESM для систем сборки: предназначен для использования с современными системами сборки, такими как webpack 2 (opens new window) или Rollup (opens new window). Формат ESM разработан для возможности статического анализа, чтобы системы сборки могли применять "tree-shaking" и удалять неиспользуемый код из финального приложения. Файлом по умолчанию для этих систем сборки (