Přejít k obsahu

přidat

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

Shell
npx blockstudio add ui/tabs

Pokud jmenný prostor vynecháte, CLI prohledá všechny nastavené registry:

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

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

Shell
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íše Block "<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:

Shell
npx blockstudio add ui/hero

Přidání více bloků:

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

Náhled bez zápisu:

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

Přeskočení všech dotazů:

Shell
npx blockstudio add ui/tabs --yes