add
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:
npx blockstudio add ui/tabs
Når du udelader navneområdet, søger CLI i alle konfigurerede registre:
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:
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.
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 medBlock "<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:
npx blockstudio add ui/hero
Tilføj flere blokke:
npx blockstudio add ui/tabs ui/hero ui/accordion
Forhåndsvisning uden at skrive:
npx blockstudio add ui/tabs --dry-run
Spring alle spørgsmål over:
npx blockstudio add ui/tabs --yes