Ugrás a tartalomhoz

add

Shell
npx blockstudio add <blocks...> [options]

Blokkokat tölt le egy regiszterből, és a projekted blokkkönyvtárába írja őket.

Argumentumok

Argumentum Leírás
blocks Egy vagy több hozzáadandó blokk. Formátum: namespace/block vagy egyszerűen block.

Beállítások

Kapcsoló Leírás
-y, --yes Minden kérdés kihagyása (felülírás, ütközésfeloldás).
--dry-run A telepítés előnézete fájlok írása nélkül.

Névterek feloldása

Ha megadsz egy névteret, a CLI az adott regiszterben keres:

Shell
npx blockstudio add ui/tabs

Ha nem adsz meg névteret, a CLI az összes beállított regiszterben keres:

Shell
npx blockstudio add tabs

Ha a blokk pontosan egy regiszterben található meg, a rendszer automatikusan azt használja. Ha többben is megtalálható, a CLI interaktív választóablakban kéri, hogy válassz.

A --yes kapcsolóval a blocks.json sorrendjében elsőként egyező regiszter lesz használatban. Terminál nélkül, a --dry-run kapcsolóval a kétértelmű név leállítja a parancsot, és hibaüzenetben felsorolja a regisztereket:

Kód
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero

Bármely blokk feloldása előtt a add lekéri az összes beállított regisztert. Ha valamelyik nem érhető el vagy érvénytelen, a parancs meghiúsul akkor is, ha a blokkhoz kifejezetten megadtál egy névteret.

Függőségek

A blokkok függhetnek ugyanazon regiszter más blokkjaitól. Egy blokk hozzáadásakor a rendszer automatikusan feloldja és telepíti a függőségeit.

Shell
npx blockstudio add ui/tabs

Ha a tabs függ a tab-item blokktól, mindkettő letöltődik és települ. A függőségek mindig az őket igénylő blokkok előtt települnek.

A körkörös függőségeket a rendszer felismeri, és hibaüzenettel elutasítja.

Felülírási viselkedés

Ha a célkönyvtárban már létezik egy blokk mappája:

  • Interaktív mód: megerősítést kér a felülírás előtt
  • --yes kapcsoló: kérdezés nélkül felülír
  • --dry-run kapcsoló: jelzi, mi kerülne felülírásra
  • Nem interaktív mód --yes nélkül: letöltés előtt leáll, és ezt adja meg: Block "<name>" already exists at <path>. Use --yes to overwrite.

Az ellenőrzés a függőségekre is kiterjed, ezért ha a tab-item már telepítve van, a tabs hozzáadásához szükség van erre: --yes.

Több blokk

A parancsban megadott blokkok feldolgozása sorrendben történik. Ha valamelyik meghiúsul, a parancs ott leáll, a futás során korábban telepített blokkok pedig a lemezen maradnak.

Példák

Egyetlen blokk hozzáadása:

Shell
npx blockstudio add ui/hero

Több blokk hozzáadása:

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

Előnézet fájlírás nélkül:

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

Minden kérdés kihagyása:

Shell
npx blockstudio add ui/tabs --yes