Перейти до вмісту
tatetUI

Як перенести компонент

Що саме копіювати, у якому порядку і чого не робити.

Компоненти не встановлюються пакетом. Ви копіюєте файл у свій проєкт — і далі він ваш.

Завантажити з сайту

На кожній сторінці компонента є кнопка «Завантажити ZIP». Архів містить компонент, усі вкладені залежності, базові стилі та інструкцію. JSON-каталог і інструкція для агентів дозволяють отримувати ті самі файли без браузера та Git.

Порядок

1. Токени. Один раз на проєкт скопіюйте app/assets/css/tokens.css і підключіть його. Це чистий CSS без синтаксису Tailwind: працює однаково на v3 і v4.

2. Реєстрація токенів. На Tailwind v4 скопіюйте ще й theme.css. На v3 замість нього візьміть конфіг зі сторінки Токени — класи утиліт будуть ті самі.

3. Сам компонент. Завантажте ZIP на його сторінці та перенесіть потрібні файли зі збереженням структури каталогів. Разом із токенами підключіть components.css — базові стилі, утиліти прокрутки та reduced-motion.

Мобільний viewport. Один раз на проєкт: viewport-fit=cover у meta viewport. Без нього на iPhone безпечні зони компонентів (футер модалки, нижній sheet, тостер) дорівнюють нулю. Деталі — на сторінці Мобільні пристрої.

4. Залежності. Якщо на сторінці компонента є блок «Портування» зі списком файлів — скопіюйте і їх. Наприклад, UiSelect без uiFieldStyles.ts лишиться без стилів, а UiModal без чотирьох композаблів overlay-ядра просто не працюватиме.

Що варто змінити після копіювання

Українські рядки. Типові підписи українські. Для i18n підключіть setUiTextTranslator((message, values) => i18n.t(message, values)) з ~/composables/useUiText перед монтуванням застосунку. Якщо перекладач читає реактивну мову, підписи оновлюються при її перемиканні.

Шляхи імпортів. Компоненти імпортують одне одного через ~/components/ui/… і ~/composables/…. Якщо у вашому проєкті інший аліас — поправте.

Чого не робити

Не копіюйте компонент без токенів. Він виглядатиме зламаним, бо всі кольори посилаються на змінні, яких у проєкті немає. Це найчастіша помилка.

Не правте компонент, щоб він «вписався» в чужі кольори. Якщо кнопка на вашому фоні виглядає не так — виправляйте токени, а не класи всередині компонента. Інакше наступне оновлення доведеться зливати руками.

Не тягніть overlay-ядро двічі. Якщо в проєкті вже є UiModal, то для UiDrawer чи UiConfirmDialog композабли копіювати вдруге не потрібно — вони спільні, і саме тому вкладені оверлеї працюють правильно.