Hoppa till innehåll

add

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

Hämtar block från ett register och skriver dem till projektets blockkatalog.

Argument

Argument Beskrivning
blocks Ett eller flera block att lägga till. Format: namespace/block eller bara block.

Alternativ

Alternativ Beskrivning
-y, --yes Hoppa över alla frågor (överskrivning, konfliktlösning).
--dry-run Förhandsvisa vad som skulle installeras utan att skriva filer.

Namnrymdsupplösning

När du anger en namnrymd söker CLI i det specifika registret:

Shell
npx blockstudio add ui/tabs

När du utelämnar namnrymden söker CLI i alla konfigurerade register:

Shell
npx blockstudio add tabs

Om blocket hittas i exakt ett register används det automatiskt. Om det hittas i flera visar CLI en interaktiv väljfråga.

Med --yes används det första matchande registret enligt ordningen i blocks.json. Utan en terminal och med --dry-run avbryts kommandot vid ett tvetydigt namn och ett felmeddelande med registren visas:

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

Innan något block löses hämtar add alla konfigurerade register. Om något av dem inte kan nås eller är ogiltigt misslyckas kommandot, även för ett block med en uttrycklig namnrymd.

Beroenden

Block kan ange beroenden till andra block i samma register. När du lägger till ett block löses dess beroenden och installeras automatiskt.

Shell
npx blockstudio add ui/tabs

Om tabs är beroende av tab-item hämtas och installeras båda blocken. Beroenden installeras alltid före blocken som är beroende av dem.

Cirkulära beroenden upptäcks och avvisas med ett felmeddelande.

Överskrivningsbeteende

Om en blockmapp redan finns i målkatalogen:

  • Interaktivt läge: du får bekräfta överskrivningen
  • Flaggan --yes: skriver över utan att fråga
  • Flaggan --dry-run: visar vad som skulle skrivas över
  • Icke-interaktivt läge utan --yes: avbryts före hämtning med Block "<name>" already exists at <path>. Use --yes to overwrite.

Kontrollen omfattar även beroenden, så om du lägger till tabs när tab-item redan är installerat krävs --yes.

Flera block

Block som anges i ett kommando behandlas i ordning. Om ett av dem misslyckas avbryts kommandot där, och block som installerades tidigare under samma körning ligger kvar på disken.

Exempel

Lägg till ett block:

Shell
npx blockstudio add ui/hero

Lägg till flera block:

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

Förhandsvisa utan att skriva:

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

Hoppa över alla frågor:

Shell
npx blockstudio add ui/tabs --yes