add
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:
npx blockstudio add ui/tabs
Kui nimeruumi ei määra, otsib CLI kõigist seadistatud registritest:
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:
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.
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 kuvabBlock "<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:
npx blockstudio add ui/hero
Mitme ploki lisamine:
npx blockstudio add ui/tabs ui/hero ui/accordion
Eelvaade faile kirjutamata:
npx blockstudio add ui/tabs --dry-run
Jäta kõik küsimused vahele:
npx blockstudio add ui/tabs --yes