add
npx blockstudio add <blocks...> [options]
Sťahuje bloky z registra a zapisuje ich do adresára blokov vášho projektu.
Argumenty
| Argument | Popis |
|---|---|
blocks |
Jeden alebo viac blokov na pridanie. Formát: namespace/block alebo iba block. |
Možnosti
| Možnosť | Popis |
|---|---|
-y, --yes |
Preskočí všetky výzvy (prepísanie, riešenie konfliktov). |
--dry-run |
Zobrazí náhľad toho, čo by sa nainštalovalo, bez zápisu súborov. |
Rozpoznávanie menných priestorov
Ak zadáte menný priestor, CLI vyhľadá blok v príslušnom registri:
npx blockstudio add ui/tabs
Ak menný priestor vynecháte, CLI prehľadá všetky nastavené registre:
npx blockstudio add tabs
Ak sa blok nájde presne v jednom registri, použije sa automaticky. Ak sa nájde vo viacerých, CLI zobrazí interaktívnu výzvu na výber.
Pomocou --yes sa použije prvý zodpovedajúci register v poradí blocks.json.
Ak nie je k dispozícii terminál a použijete --dry-run, nejednoznačný názov príkaz zastaví a vypíše chybu so zoznamom registrov:
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero
Pred rozpoznaním ľubovoľného bloku add načíta všetky nastavené registre. Ak niektorý z nich nie je dostupný alebo je neplatný, príkaz zlyhá, a to aj pri bloku s výslovne zadaným menným priestorom.
Závislosti
Bloky môžu deklarovať závislosti od iných blokov v tom istom registri. Keď pridáte blok, jeho závislosti sa automaticky rozpoznajú a nainštalujú.
npx blockstudio add ui/tabs
Ak tabs závisí od tab-item, stiahnu a nainštalujú sa oba bloky.
Závislosti sa vždy inštalujú pred blokmi, ktoré od nich závisia.
Kruhové závislosti sa zistia a odmietnu s chybou.
Správanie pri prepisovaní
Ak priečinok bloku už v cieľovom adresári existuje:
- Interaktívny režim: zobrazí výzvu na potvrdenie prepísania
- Príznak
--yes: prepíše bez opýtania - Príznak
--dry-run: oznámi, čo by sa prepísalo - Neinteraktívny režim bez
--yes: zastaví sa pred sťahovaním a zobrazíBlock "<name>" already exists at <path>. Use --yes to overwrite.
Kontrola zahŕňa aj závislosti, takže pridanie tabs, keď je tab-item už nainštalovaný, vyžaduje --yes.
Viacero blokov
Bloky zadané v jednom príkaze sa spracúvajú v uvedenom poradí. Ak niektorý zlyhá, príkaz sa tam zastaví a bloky nainštalované skôr v rámci toho istého spustenia zostanú na disku.
Príklady
Pridanie jedného bloku:
npx blockstudio add ui/hero
Pridanie viacerých blokov:
npx blockstudio add ui/tabs ui/hero ui/accordion
Náhľad bez zápisu súborov:
npx blockstudio add ui/tabs --dry-run
Preskočenie všetkých výziev:
npx blockstudio add ui/tabs --yes