add
npx blockstudio add <blocks...> [options]
Prenese bloke iz registra in jih zapiše v imenik blokov vašega projekta.
Argumenti
| Argument | Opis |
|---|---|
blocks |
Eden ali več blokov za dodajanje. Oblika: namespace/block ali samo block. |
Možnosti
| Možnost | Opis |
|---|---|
-y, --yes |
Preskoči vse pozive (prepisovanje, razreševanje sporov). |
--dry-run |
Prikaže predogled namestitve brez zapisovanja datotek. |
Razreševanje imenskih prostorov
Ko navedete imenski prostor, CLI poišče blok v določenem registru:
npx blockstudio add ui/tabs
Če imenskega prostora ne navedete, CLI išče po vseh nastavljenih registrih:
npx blockstudio add tabs
Če je blok najden v natanko enem registru, se ta uporabi samodejno. Če je najden v več registrih, CLI prikaže interaktivni poziv za izbiro.
Z možnostjo --yes se uporabi prvi ustrezni register v vrstnem redu blocks.json. Brez terminala in z možnostjo --dry-run se ukaz pri dvoumnem imenu ustavi z napako, ki navede registre:
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero
Pred razreševanjem katerega koli bloka add pridobi podatke iz vseh nastavljenih registrov. Če kateri od njih ni dosegljiv ali je neveljaven, ukaz spodleti, tudi če ima blok izrecno naveden imenski prostor.
Odvisnosti
Bloki lahko določijo odvisnosti od drugih blokov v istem registru. Ko dodate blok, se njegove odvisnosti samodejno razrešijo in namestijo.
npx blockstudio add ui/tabs
Če je blok tabs odvisen od bloka tab-item, se preneseta in namestita oba. Odvisnosti se vedno namestijo pred bloki, ki so od njih odvisni.
Krožne odvisnosti se zaznajo in zavrnejo z napako.
Vedenje pri prepisovanju
Če mapa bloka v ciljnem imeniku že obstaja:
- Interaktivni način: pozove vas, da potrdite prepisovanje
- Zastavica
--yes: prepiše brez vprašanja - Zastavica
--dry-run: prikaže, kaj bi bilo prepisano - Neinteraktivni način brez možnosti
--yes: ustavi se pred prenosom; prikažeBlock "<name>" already exists at <path>. Use --yes to overwrite.
Preverjanje zajema tudi odvisnosti, zato za dodajanje bloka tabs, ko je blok tab-item že nameščen, potrebujete možnost --yes.
Več blokov
Bloki, podani v enem ukazu, se obdelajo po vrsti. Če kateri od njih spodleti, se ukaz ustavi; bloki, nameščeni prej v istem zagonu, ostanejo na disku.
Primeri
Dodajte en blok:
npx blockstudio add ui/hero
Dodajte več blokov:
npx blockstudio add ui/tabs ui/hero ui/accordion
Predogled brez zapisovanja:
npx blockstudio add ui/tabs --dry-run
Preskočite vse pozive:
npx blockstudio add ui/tabs --yes