add
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:
npx blockstudio add ui/tabs
Nenurodžius vardų srities, CLI ieško visuose sukonfigūruotuose registruose:
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ė:
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.
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ą
--yesvėliavėlė: perrašo neklausdamas--dry-runvėliavėlė: parodo, kas būtų perrašyta- Neinteraktyvusis režimas be
--yes: sustabdo komandą prieš atsisiuntimą ir pateikiaBlock "<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ą:
npx blockstudio add ui/hero
Pridėkite kelis blokus:
npx blockstudio add ui/tabs ui/hero ui/accordion
Peržiūrėkite neįrašydami:
npx blockstudio add ui/tabs --dry-run
Praleiskite visus patvirtinimo klausimus:
npx blockstudio add ui/tabs --yes