добавяне
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