add
npx blockstudio add <blocks...> [options]
Lataa lohkoja rekisteristä ja kirjoittaa ne projektisi lohkojen hakemistoon.
Argumentit
| Argumentti | Kuvaus |
|---|---|
blocks |
Yksi tai useampi lisättävä lohko. Muoto: namespace/block tai pelkkä block. |
Asetukset
| Valitsin | Kuvaus |
|---|---|
-y, --yes |
Ohita kaikki kehotteet (ylikirjoitus, ristiriitojen ratkaisu). |
--dry-run |
Esikatsele, mitä asennettaisiin, kirjoittamatta tiedostoja. |
Nimiavaruuden ratkaiseminen
Kun määrität nimiavaruuden, CLI etsii kyseisestä rekisteristä:
npx blockstudio add ui/tabs
Kun jätät nimiavaruuden pois, CLI etsii kaikista määritetyistä rekistereistä:
npx blockstudio add tabs
Jos lohko löytyy täsmälleen yhdestä rekisteristä, sitä käytetään automaattisesti. Jos lohko löytyy useasta rekisteristä, CLI näyttää vuorovaikutteisen valintakehotteen.
Valitsimella --yes käytetään ensimmäistä täsmäävää rekisteriä järjestyksessä blocks.json.
Jos päätettä ei ole käytettävissä ja käytössä on --dry-run, epäselvä nimi pysäyttää komennon virheeseen, jossa luetellaan rekisterit:
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero
Ennen lohkojen ratkaisemista add noutaa kaikki määritetyt rekisterit. Jos jokin niistä ei ole tavoitettavissa tai on virheellinen, komento epäonnistuu myös silloin, kun lohkolle on määritetty nimiavaruus.
Riippuvuudet
Lohkot voivat määrittää riippuvuuksia muihin saman rekisterin lohkoihin. Kun lisäät lohkon, sen riippuvuudet ratkaistaan ja asennetaan automaattisesti.
npx blockstudio add ui/tabs
Jos tabs riippuu lohkosta tab-item, molemmat lohkot ladataan ja asennetaan.
Riippuvuudet asennetaan aina ennen niistä riippuvia lohkoja.
Kehäriippuvuudet havaitaan ja hylätään virheilmoituksella.
Ylikirjoituskäyttäytyminen
Jos lohkokansio on jo kohdehakemistossa:
- Vuorovaikutteinen tila: pyytää vahvistamaan ylikirjoituksen
--yes-valitsin: ylikirjoittaa kysymättä--dry-run-valitsin: ilmoittaa, mitä ylikirjoitettaisiin- Ei-vuorovaikutteinen tila ilman valitsinta
--yes: pysähtyy ennen lataamista ja näyttää virheenBlock "<name>" already exists at <path>. Use --yes to overwrite.
Tarkistus kattaa myös riippuvuudet, joten lohkon tabs lisääminen, kun tab-item on jo asennettu, vaatii valitsimen --yes.
Useita lohkoja
Samassa komennossa annetut lohkot käsitellään järjestyksessä. Jos jokin niistä epäonnistuu, komento pysähtyy siihen, ja aiemmin saman suorituksen aikana asennetut lohkot jäävät levylle.
Esimerkkejä
Lisää yksi lohko:
npx blockstudio add ui/hero
Lisää useita lohkoja:
npx blockstudio add ui/tabs ui/hero ui/accordion
Esikatsele kirjoittamatta tiedostoja:
npx blockstudio add ui/tabs --dry-run
Ohita kaikki kehotteet:
npx blockstudio add ui/tabs --yes