Skip to content

Complete guide to

Mastering Pinia

written by its creator

Перевод синхронизирован с документацией от , хэш коммита 837a5e8.

Ленивая загрузка маршрутов

Если вы собираете ваше приложение при помощи инструментов сборки, итоговый размер Javascript приложения может стать довольно большим, тем самым влиять на время загрузки страницы. Было бы более эффективныее, если бы мы могли разделить компоненты каждого маршрута на отдельные части и загружать их только при посещении маршрута.

Vue Router поддерживает динамические импорты из коробки, что дает возможность замены статических импортов на динамические:

js
// замените
// import UserDetails from './views/UserDetails'
// на это
const UserDetails = () => import('./views/UserDetails.vue')

const router = createRouter({
  // ...
  routes: [
    { path: '/users/:id', component: UserDetails }
    // или используйте напрямую в определении маршрута
    { path: '/users/:id', component: () => import('./views/UserDetails.vue') },
  ],
})

Опция componentcomponents) принимает функцию, которая возвращает Promise компонента, Vue Router загрузит его только при первом посещении страницы, а затем будет использовать закешированную версию. Также вы можете использовать более сложные функции, при условии, что они возвращают Promise:

js
const UserDetails = () =>
  Promise.resolve({
    /* определение компонентоа */
  })

В общем случае целесообразно всегда использовать динамический импорт для всех маршрутов.

Совет

Не используйте асинхронные компоненты для маршрутов. Асинхронные компоненты могут все еще использоваться внутри компонентов маршрута, но сами компоненты маршрута - это просто динамические импорты.

При использовании инструментов сборки, например webpack, это автоматически позволит использовать разделение кода.

При использовании Babel необходимо добавить плагин syntax-dynamic-import, чтобы Babel мог правильно анализировать синтаксис.

Группировка компонентов в одном чанке

С webpack

Иногда мы можем захотеть сгруппировать все компоненты, вложенные в один маршрут, в один асинхронный чанк (chunk). Для этого необходимо использовать именованные чанки, указав имя чанка с помощью специального синтаксиса комментариев (требуется webpack > 2.4):

js
const UserDetails = () =>
  import(/* webpackChunkName: "group-user" */ './UserDetails.vue')
const UserDashboard = () =>
  import(/* webpackChunkName: "group-user" */ './UserDashboard.vue')
const UserProfileEdit = () =>
  import(/* webpackChunkName: "group-user" */ './UserProfileEdit.vue')

webpack сгруппирует все асинхронные модули с одинаковым именем чанка в один асинхронный.

С Vite

В Vite вы можете определить чанки в разделе rollupOptions:

js
// vite.config.js
export default defineConfig({
  build: {
    rollupOptions: {
      // https://rollupjs.org/guide/en/#outputmanualchunks
      output: {
        manualChunks: {
          'group-user': [
            './src/UserDetails',
            './src/UserDashboard',
            './src/UserProfileEdit',
          ],
        },
      },
    },
  },
})

Released under the MIT License.