Liigu sisu juurde

add

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

Laadib plokid registrist alla ja salvestab need sinu projekti plokkide kataloogi.

Argumendid

Argument Kirjeldus
blocks Üks või mitu lisatavat plokki. Vorming: namespace/block või lihtsalt block.

Suvandid

Valik Kirjeldus
-y, --yes Jäta kõik küsimused vahele (ülekirjutamine, konfliktide lahendamine).
--dry-run Kuva installitava eelvaade faile kirjutamata.

Nimeruumi lahendamine

Nimeruumi määramisel otsib CLI määratud registrist:

Shell
npx blockstudio add ui/tabs

Kui nimeruumi ei määra, otsib CLI kõigist seadistatud registritest:

Shell
npx blockstudio add tabs

Kui plokk leitakse täpselt ühest registrist, kasutatakse seda automaatselt. Kui see leitakse mitmest, kuvab CLI valimiseks interaktiivse valikumenüü.

Valikuga --yes kasutatakse esimest sobivat registrit blocks.json järjestuses. Terminalita käivitamisel ja valikuga --dry-run katkestatakse mitmetähendusliku nime korral käsk ning kuvatakse registrite loend koos veateatega:

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

Enne plokkide lahendamist hangib add kõik seadistatud registrid. Kui mõni neist pole kättesaadav või on vigane, nurjub käsk isegi siis, kui plokile on määratud nimeruum.

Sõltuvused

Plokid võivad sõltuda teistest sama registri plokkidest. Ploki lisamisel lahendatakse selle sõltuvused ja installitakse automaatselt.

Shell
npx blockstudio add ui/tabs

Kui tabs sõltub plokist tab-item, laaditakse mõlemad alla ja installitakse. Sõltuvused installitakse alati enne neist sõltuvaid plokke.

Ringtsüklilised sõltuvused tuvastatakse ja nende korral kuvatakse veateade.

Ülekirjutamise käitumine

Kui sihtkataloogis on ploki kaust juba olemas:

  • Interaktiivne režiim: küsib ülekirjutamise kinnitust
  • Lipp --yes: kirjutab üle küsimata
  • Lipp --dry-run: näitab, mis kirjutataks üle
  • Mitteinteraktiivne režiim ilma valikuta --yes: katkestab enne allalaadimist ja kuvab Block "<name>" already exists at <path>. Use --yes to overwrite.

Kontroll hõlmab ka sõltuvusi, nii et ploki tabs lisamiseks, kui tab-item on juba installitud, on vaja valikut --yes.

Mitu plokki

Ühe käsuga antud plokke töödeldakse järjekorras. Kui mõne ploki töötlemine nurjub, katkestatakse käsk ning sama käivitamise käigus varem installitud plokid jäävad kettale alles.

Näited

Ühe ploki lisamine:

Shell
npx blockstudio add ui/hero

Mitme ploki lisamine:

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

Eelvaade faile kirjutamata:

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

Jäta kõik küsimused vahele:

Shell
npx blockstudio add ui/tabs --yes