Siirry sisältöön

add

Shell
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ä:

Shell
npx blockstudio add ui/tabs

Kun jätät nimiavaruuden pois, CLI etsii kaikista määritetyistä rekistereistä:

Shell
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:

Koodi
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.

Shell
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ää virheen Block "<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:

Shell
npx blockstudio add ui/hero

Lisää useita lohkoja:

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

Esikatsele kirjoittamatta tiedostoja:

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

Ohita kaikki kehotteet:

Shell
npx blockstudio add ui/tabs --yes