Vue.js: Загальний
20 питань · ~15 хв · Версія v3.0
Увійдіть, щоб продовжити
Компоненти, реактивність, Composition API, директиви.
- За спробу
- 20
- У пулі
- 100
- Проходжень
- 25
- Середній бал
- 82%
- Пройшли на 70%+
- 80%
Питання для підготовки
108 питаньОбидва створюють реактивний стан, за яким Vue стежить і перемальовує шаблон при змінах.
ref(value)- обгортка над будь-яким значенням: числом, рядком, об'єктом. Значення лежить у.value. У шаблоні.valueписати не треба - Vue розгортає ref автоматично.reactive(object)- реактивний проксі над об'єктом (чи масивом,Map). Поля читаються напряму, без.value.
import { ref, reactive } from 'vue';
const count = ref(0);
count.value++;
const form = reactive({ email: '', password: '' });
form.email = 'olia@example.com';
Обмеження reactive:
- Працює лише з об'єктами -
reactive(0)не має сенсу. - Не можна замінити цілком:
form = reactive({...})розриває зв'язок із шаблоном, бо шаблон стежить за старим проксі. - Деструктуризація губить реактивність:
const { email } = formдає звичайний рядок.
Через ці обмеження документація Vue радить ref як основний інструмент: його можна передавати у функції, повертати з composables, перезаписувати цілком (items.value = newItems), і поведінка завжди однакова. reactive зручний для згрупованого стану на кшталт форми, який не замінюють і не деструктуризують.
Плагіни й app.config.globalProperties додають властивості, доступні в кожному компоненті ($t для перекладів, route() від Ziggy в Laravel-проєктах). Глобально зареєстровані компоненти (app.component('Icon', Icon)) доступні в усіх шаблонах без імпорту. TypeScript про них нічого не знає, поки їх не оголосити.
Глобальні властивості - розширення модуля vue:
// types/vue.d.ts
import type { route as routeFn } from 'ziggy-js'
export {}
declare module 'vue' {
interface ComponentCustomProperties {
route: typeof routeFn
$t: (key: string, params?: Record<string, unknown>) => string
}
}
Тепер у шаблоні {{ route('posts.show', post.id) }} і $t('cart.empty') мають типи, а друкарська помилка в назві - помилка vue-tsc.
Глобальні компоненти:
declare module 'vue' {
interface GlobalComponents {
Icon: typeof import('./components/Icon.vue')['default']
Link: typeof import('@inertiajs/vue3')['Link']
}
}
Розширення Vue - Official і vue-tsc перевіряють props таких компонентів у шаблонах так само, як імпортованих.
Важливі деталі:
- файл оголошень має бути модулем (
export {}чи будь-який імпорт/експорт), інакшеdeclare module 'vue'замінить типи Vue замість розширення; - файл має потрапити в
includeуtsconfig; - бібліотеки (Vue Router, Pinia, Inertia) самі постачають такі розширення -
$route,$routerтипізовані без ваших зусиль.
Краще уникати глобальних властивостей у Composition API. У <script setup> доступ до них через getCurrentInstance() - незручний і крихкий. Явний імпорт чи composable (const { t } = useI18n()) зрозуміліший, краще працює з tree shaking і тестами: у тесті достатньо замокати модуль, а не налаштовувати глобальні властивості.
Глобальні компоненти теж мають ціну: збирач не знає, чи вони використовуються, тож не може їх викинути чи винести в окрему частину. Реєструвати глобально варто лише справді повсюдні (іконка, посилання), решту - імпортувати там, де потрібні.
Докладніше в документації: TypeScript: розширення глобальних властивостей
computed - значення, похідне від іншого стану. Vue кешує результат і перераховує його, лише коли змінилися реактивні залежності.
const items = ref([]);
const total = computed(() => items.value.reduce((sum, i) => sum + i.price, 0));
Метод у шаблоні ({{ calcTotal() }}) викликається при кожному рендері компонента, навіть якщо items не змінювалися. Для важких обчислень це зайва робота.
watch - не значення, а побічна дія у відповідь на зміну: запит на сервер, запис у localStorage, ручна робота з DOM.
watch(searchQuery, async (query) => {
results.value = await search(query);
});
Як обирати:
- Потрібно значення для шаблону чи коду -
computed. - Потрібно щось зробити, коли значення змінилося, -
watch. - Потрібна дія з аргументами за запитом (обробник кліку) - метод.
Типова помилка - watch, що просто записує похідне значення в інший ref:
watch(items, () => { total.value = sum(items.value); }, { deep: true }); // зайве
Це той самий computed, але з ручною синхронізацією, яку легко зламати.
computed має бути чистим: без запитів, змін іншого стану чи DOM. Інакше результат залежатиме від того, коли й скільки разів Vue вирішить його перерахувати.
watch(source, callback)стежить за явно вказаним джерелом. Колбек отримує нове й старе значення і за замовчуванням не запускається одразу - лише при першій зміні.watchEffect(callback)запускається одразу і сам відстежує всі реактивні значення, які прочитав під час виконання. Старого значення немає.
watch(userId, async (id, oldId) => {
user.value = await fetchUser(id);
});
watchEffect(async () => {
user.value = await fetchUser(userId.value); // залежність від userId знайдена сама
});
Опції watch:
immediate: true- викликати колбек одразу з поточним значенням, якwatchEffect.deep: true- реагувати на зміни вкладених полів об'єкта, а не лише на заміну всього значення. Заreactive-об'єктомwatchстежить глибоко автоматично. З Vue 3.5deepприймає й число - глибину обходу.once: true(3.4+) - спрацювати лише раз.
Нюанси:
watchEffectвідстежує лише те, що прочитано синхронно до першогоawait. Значення, прочитані після, у залежності не потрапляють.deepна великій структурі - дорогий обхід при кожній зміні. Краще стежити за конкретним полем:watch(() => form.email, ...).- Гонки: якщо
userIdзмінився двічі швидко, відповіді можуть прийти не в тому порядку.onCleanup(чиonWatcherCleanupу 3.5) дозволяє скасувати попередній запит.
Правило: watch - коли важливо, що саме змінилося і нові/старі значення; watchEffect - коли ефект просто має відповідати поточному стану.
У шаблоні .value писати не треба - але лише для ref верхнього рівня, тобто змінних, оголошених прямо в <script setup> (чи повернених з setup()).
<script setup>
import { ref } from 'vue';
const count = ref(1);
const item = { id: ref(1) }; // ref усередині звичайного об'єкта
</script>
<template>
<p>{{ count + 1 }}</p> <!-- 2 -->
<p>{{ item.id }}</p> <!-- 1 -->
<p>{{ item.id + 1 }}</p> <!-- [object Object]1 -->
</template>
Чому так:
count- ref верхнього рівня, у виразі він розгорнутий;item.id- ref усередині звичайного об'єкта. Виразitem.id + 1додає до об'єкта-ref число;{{ item.id }}без обчислень показує1- це окреме правило: якщо кінцевий результат інтерполяції - ref, текст розгортається. Але для будь-якого виразу з ним - ні.
Як виправити:
const { id } = item; // зробити ref верхнього рівня
або явно {{ item.id.value + 1 }}.
Інші правила розгортання:
- у
reactive()ref, що лежить як властивість, розгортається при доступі:state.count, а неstate.count.value; - у масивах і колекціях (
reactive([ref(1)]),Map) - не розгортається, потрібно.value; - props приходять уже розгорнутими значеннями -
.valueне потрібен.
Практичне правило, що знімає плутанину: не класти ref-и всередину звичайних об'єктів. Або окремі ref-и на верхньому рівні, або один reactive/ref з об'єктом, поля якого - звичайні значення.
Інструменти допомагають: Vue - Official (Volar) у редакторі підсвічує, де .value потрібен, а TypeScript покаже, що item.id + 1 додає Ref<number> до числа.
Докладніше в документації: Особливість розгортання в шаблонах
Прочитати - ще не значить знати
20 питань, по одному на екран, ~15 хв. Після завершення - розбір кожної помилки з посиланням на питання.