add
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:
npx blockstudio add ui/tabs
Ha nem adsz meg névteret, a CLI az összes beállított regiszterben keres:
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:
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.
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
--yeskapcsoló: kérdezés nélkül felülír--dry-runkapcsoló: jelzi, mi kerülne felülírásra- Nem interaktív mód
--yesné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:
npx blockstudio add ui/hero
Több blokk hozzáadása:
npx blockstudio add ui/tabs ui/hero ui/accordion
Előnézet fájlírás nélkül:
npx blockstudio add ui/tabs --dry-run
Minden kérdés kihagyása:
npx blockstudio add ui/tabs --yes