přidat
npx blockstudio add <blocks...> [options]
Stahuje bloky z registru a zapisuje je do adresáře bloků vašeho projektu.
Argumenty
| Argument | Popis |
|---|---|
blocks |
Jeden nebo více bloků k přidání. Formát: namespace/block nebo jen block. |
Možnosti
| Volba | Popis |
|---|---|
-y, --yes |
Přeskočí všechny dotazy (přepsání, řešení konfliktů). |
--dry-run |
Zobrazí náhled instalace bez zápisu souborů. |
Rozlišení jmenného prostoru
Pokud zadáte jmenný prostor, CLI vyhledá blok v určeném registru:
npx blockstudio add ui/tabs
Pokud jmenný prostor vynecháte, CLI prohledá všechny nastavené registry:
npx blockstudio add tabs
Pokud je blok nalezen právě v jednom registru, použije se automaticky. Pokud je nalezen ve více registrech, CLI zobrazí interaktivní nabídku, ve které můžete vybrat.
S volbou --yes se použije první odpovídající registr v pořadí blocks.json.
Pokud není k dispozici terminál a je zadána volba --dry-run, nejednoznačný název příkaz ukončí chybou se seznamem registrů:
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero
Před rozlišením jakéhokoli bloku načte add všechny nastavené registry. Pokud je některý nedostupný nebo neplatný, příkaz selže, i když má blok výslovně zadaný jmenný prostor.
Závislosti
Bloky mohou záviset na dalších blocích ve stejném registru. Při přidání bloku se jeho závislosti automaticky rozliší a nainstalují.
npx blockstudio add ui/tabs
Pokud blok tabs závisí na bloku tab-item, stáhnou se a nainstalují oba. Závislosti se vždy instalují před bloky, které na nich závisí.
Kruhové závislosti se zjistí a příkaz skončí chybou.
Chování při přepsání
Pokud cílový adresář již obsahuje složku bloku:
- Interaktivní režim: vyzve k potvrzení přepsání
- Příznak
--yes: přepíše bez dotazu - Příznak
--dry-run: zobrazí, co by se přepsalo - Neinteraktivní režim bez
--yes: zastaví se před stahováním a vypíšeBlock "<name>" already exists at <path>. Use --yes to overwrite.
Kontrola zahrnuje i závislosti. Pokud už je nainstalován tab-item, přidání tabs vyžaduje --yes.
Více bloků
Bloky zadané v jednom příkazu se zpracují v uvedeném pořadí. Pokud některý selže, příkaz se zastaví a bloky nainstalované dříve během stejného běhu zůstanou na disku.
Příklady
Přidání jednoho bloku:
npx blockstudio add ui/hero
Přidání více bloků:
npx blockstudio add ui/tabs ui/hero ui/accordion
Náhled bez zápisu:
npx blockstudio add ui/tabs --dry-run
Přeskočení všech dotazů:
npx blockstudio add ui/tabs --yes