Gå til indhold

add

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

Downloader blokke fra et register og skriver dem til projektets blokmappe.

Argumenter

Argument Beskrivelse
blocks En eller flere blokke, der skal tilføjes. Format: namespace/block eller blot block.

Indstillinger

Tilvalg Beskrivelse
-y, --yes Spring alle spørgsmål over (overskrivning, konfliktløsning).
--dry-run Se en forhåndsvisning af, hvad der ville blive installeret, uden at skrive filer.

Navneområdeopløsning

Når du angiver et navneområde, søger CLI i det pågældende register:

Shell
npx blockstudio add ui/tabs

Når du udelader navneområdet, søger CLI i alle konfigurerede registre:

Shell
npx blockstudio add tabs

Hvis blokken findes i præcis ét register, bruges det automatisk. Hvis den findes i flere, viser CLI en interaktiv valgprompt.

Med --yes bruges det første register, der matcher i rækkefølgen blocks.json. Uden en terminal og med --dry-run stopper en tvetydig navneangivelse kommandoen med en fejl, der viser registrene:

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

Før add opløser nogen blok, henter det alle konfigurerede registre. Hvis et af dem ikke kan nås eller er ugyldigt, mislykkes kommandoen, også for en blok med et eksplicit navneområde.

Afhængigheder

Blokke kan erklære afhængigheder af andre blokke i samme register. Når du tilføjer en blok, opløses dens afhængigheder og installeres automatisk.

Shell
npx blockstudio add ui/tabs

Hvis tabs afhænger af tab-item, downloades og installeres begge blokke. Afhængigheder installeres altid før de blokke, der afhænger af dem.

Cirkulære afhængigheder registreres og afvises med en fejl.

Overskrivningsadfærd

Hvis der allerede findes en blokmappe i målmappen:

  • Interaktiv tilstand: du bliver bedt om at bekræfte overskrivningen
  • --yes-flag: overskriver uden at spørge
  • --dry-run-flag: viser, hvad der ville blive overskrevet
  • Ikke-interaktiv tilstand uden --yes: stopper før download med Block "<name>" already exists at <path>. Use --yes to overwrite.

Kontrollen omfatter også afhængigheder, så hvis du tilføjer tabs, når tab-item allerede er installeret, kræves --yes.

Flere blokke

Blokke, der angives i én kommando, behandles i rækkefølge. Hvis en af dem mislykkes, stopper kommandoen dér, og blokke, der blev installeret tidligere i samme kørsel, forbliver på disken.

Eksempler

Tilføj en enkelt blok:

Shell
npx blockstudio add ui/hero

Tilføj flere blokke:

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

Forhåndsvisning uden at skrive:

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

Spring alle spørgsmål over:

Shell
npx blockstudio add ui/tabs --yes