add
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:
npx blockstudio add ui/tabs
När du utelämnar namnrymden söker CLI i alla konfigurerade register:
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:
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.
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 medBlock "<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:
npx blockstudio add ui/hero
Lägg till flera block:
npx blockstudio add ui/tabs ui/hero ui/accordion
Förhandsvisa utan att skriva:
npx blockstudio add ui/tabs --dry-run
Hoppa över alla frågor:
npx blockstudio add ui/tabs --yes