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

додати

Командна оболонка
npx blockstudio add <blocks...> [options]

Завантажує блоки з реєстру та записує їх у каталог блоків вашого проєкту.

Аргументи

Аргумент Опис
blocks Один або кілька блоків для додавання. Формат: namespace/block або просто block.

Параметри

Параметр Опис
-y, --yes Пропустити всі запити (перезапис, розв’язання конфліктів).
--dry-run Показати, що буде встановлено, не записуючи файли.

Визначення простору імен

Якщо вказати простір імен, CLI шукатиме у відповідному реєстрі:

Командна оболонка
npx blockstudio add ui/tabs

Якщо не вказувати простір імен, CLI шукатиме в усіх налаштованих реєстрах:

Командна оболонка
npx blockstudio add tabs

Якщо блок знайдено рівно в одному реєстрі, він буде використаний автоматично. Якщо в кількох, CLI покаже інтерактивний список для вибору.

З --yes використовується перший відповідний реєстр у порядку blocks.json. Якщо термінал недоступний і вказано --dry-run, команда зупиниться з помилкою та покаже список реєстрів, якщо назва неоднозначна:

Код
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero

Перш ніж визначити реєстр для будь-якого блоку, add отримує дані з усіх налаштованих реєстрів. Якщо один із них недоступний або некоректний, команда завершиться помилкою, навіть якщо для блоку явно вказано простір імен.

Залежності

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

Командна оболонка
npx blockstudio add ui/tabs

Якщо tabs залежить від tab-item, обидва блоки буде завантажено та встановлено. Залежності завжди встановлюються раніше за блоки, які від них залежать.

Циклічні залежності виявляються, і команда завершується помилкою.

Перезаписування

Якщо папка блоку вже існує в цільовому каталозі:

  • Інтерактивний режим: з’явиться запит підтвердити перезапис
  • Прапорець --yes: перезаписує без запиту
  • Прапорець --dry-run: показує, що буде перезаписано
  • Неінтерактивний режим без --yes: зупиняється до завантаження з помилкою Block "<name>" already exists at <path>. Use --yes to overwrite.

Перевірка охоплює також залежності, тож для додавання tabs, якщо tab-item вже встановлено, потрібен --yes.

Кілька блоків

Блоки, передані однією командою, обробляються по черзі. Якщо один із них не вдається встановити, команда зупиняється, а блоки, встановлені раніше під час цього запуску, залишаються на диску.

Приклади

Додати один блок:

Командна оболонка
npx blockstudio add ui/hero

Додати кілька блоків:

Командна оболонка
npx blockstudio add ui/tabs ui/hero ui/accordion

Попередній перегляд без запису файлів:

Командна оболонка
npx blockstudio add ui/tabs --dry-run

Пропустити всі запити:

Командна оболонка
npx blockstudio add ui/tabs --yes