Към съдържанието

добавяне

Обвивка
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