Preskočiť na obsah

add

Shell
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:

Shell
npx blockstudio add ui/tabs

Ak menný priestor vynecháte, CLI prehľadá všetky nastavené registre:

Shell
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:

Kód
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ú.

Shell
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:

Shell
npx blockstudio add ui/hero

Pridanie viacerých blokov:

Shell
npx blockstudio add ui/tabs ui/hero ui/accordion

Náhľad bez zápisu súborov:

Shell
npx blockstudio add ui/tabs --dry-run

Preskočenie všetkých výziev:

Shell
npx blockstudio add ui/tabs --yes