Preskoči na vsebino

add

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

Lupina
npx blockstudio add ui/tabs

Če imenskega prostora ne navedete, CLI išče po vseh nastavljenih registrih:

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

Koda
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.

Lupina
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že Block "<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:

Lupina
npx blockstudio add ui/hero

Dodajte več blokov:

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

Predogled brez zapisovanja:

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

Preskočite vse pozive:

Lupina
npx blockstudio add ui/tabs --yes