Pereiti prie turinio

add

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

Atsisiunčia blokus iš registro ir įrašo juos į jūsų projekto blokų katalogą.

Argumentai

Argumentas Aprašymas
blocks Vienas ar daugiau pridėtinų blokų. Formatas: namespace/block arba tiesiog block.

Parinktys

Parinktis Aprašymas
-y, --yes Praleidžia visus patvirtinimo klausimus (perrašymą, konfliktų sprendimą).
--dry-run Parodo, kas būtų įdiegta, bet failų neįrašo.

Vardų srities parinkimas

Nurodžius vardų sritį, CLI ieško nurodytame registre:

Shell
npx blockstudio add ui/tabs

Nenurodžius vardų srities, CLI ieško visuose sukonfigūruotuose registruose:

Shell
npx blockstudio add tabs

Jei blokas randamas tik viename registre, jis pasirenkamas automatiškai. Jei keliuose, CLI parodo interaktyvų pasirinkimo meniu.

Naudojant --yes, pasirenkamas pirmas atitinkantis registras pagal blocks.json tvarką. Be terminalo ir naudojant --dry-run, esant dviprasmiškam pavadinimui komanda sustabdoma ir parodoma registrų eilutė:

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

Prieš parinkdamas bet kurį bloką, add gauna visus sukonfigūruotus registrus. Jei kuris nors nepasiekiamas arba netinkamas, komanda nepavyksta net ir nurodžius aiškią vardų sritį.

Priklausomybės

Blokai gali priklausyti nuo kitų to paties registro blokų. Pridėjus bloką, jo priklausomybės automatiškai parenkamos ir įdiegiamos.

Shell
npx blockstudio add ui/tabs

Jei tabs priklauso nuo tab-item, abu blokai atsisiunčiami ir įdiegiami. Priklausomybės visada įdiegiamos prieš nuo jų priklausančius blokus.

Ciklinės priklausomybės aptinkamos ir atmetamos pateikiant klaidą.

Perrašymo elgsena

Jei tiksliniame kataloge jau yra bloko aplankas:

  • Interaktyvusis režimas: prašoma patvirtinti perrašymą
  • --yes vėliavėlė: perrašo neklausdamas
  • --dry-run vėliavėlė: parodo, kas būtų perrašyta
  • Neinteraktyvusis režimas be --yes: sustabdo komandą prieš atsisiuntimą ir pateikia Block "<name>" already exists at <path>. Use --yes to overwrite.

Tikrindamos taip pat atsižvelgiama į priklausomybes, todėl norint pridėti tabs, kai tab-item jau įdiegtas, reikia naudoti --yes.

Keli blokai

Vienoje komandoje nurodyti blokai apdorojami iš eilės. Jei vieno apdoroti nepavyksta, komanda sustoja, o tos pačios vykdymo sesijos metu anksčiau įdiegti blokai lieka diske.

Pavyzdžiai

Pridėkite vieną bloką:

Shell
npx blockstudio add ui/hero

Pridėkite kelis blokus:

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

Peržiūrėkite neįrašydami:

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

Praleiskite visus patvirtinimo klausimus:

Shell
npx blockstudio add ui/tabs --yes