toevoegen
npx blockstudio add <blocks...> [options]
Haalt blokken op uit een register en schrijft ze naar de blokmap van je project.
Argumenten
| Argument | Beschrijving |
|---|---|
blocks |
Een of meer blokken om toe te voegen. Formaat: namespace/block of alleen block. |
Opties
| Optie | Beschrijving |
|---|---|
-y, --yes |
Slaat alle vragen over (overschrijven, conflicten oplossen). |
--dry-run |
Toont een voorbeeld van wat er geïnstalleerd zou worden, zonder bestanden te schrijven. |
Naamruimteresolutie
Wanneer je een naamruimte opgeeft, zoekt de CLI in dat specifieke register:
npx blockstudio add ui/tabs
Wanneer je de naamruimte weglaat, doorzoekt de CLI alle geconfigureerde registers:
npx blockstudio add tabs
Als het blok in precies één register wordt gevonden, wordt dat automatisch gebruikt. Wordt het in meerdere registers gevonden, dan toont de CLI een interactieve keuzelijst.
Met --yes wordt het eerste overeenkomende register in de volgorde van blocks.json gebruikt.
Zonder terminal en met --dry-run stopt de opdracht bij een ambigue naam met een foutmelding waarin de registers worden vermeld:
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero
Voordat de add een blok opzoekt, haalt deze alle geconfigureerde registers op. Als een register onbereikbaar of ongeldig is, mislukt de opdracht, zelfs voor een blok met een expliciete naamruimte.
Afhankelijkheden
Blokken kunnen afhankelijk zijn van andere blokken in hetzelfde register. Wanneer je een blok toevoegt, worden de afhankelijkheden automatisch opgezocht en geïnstalleerd.
npx blockstudio add ui/tabs
Als tabs afhankelijk is van tab-item, worden beide blokken gedownload en geïnstalleerd.
Afhankelijkheden worden altijd geïnstalleerd voordat de blokken die ervan afhankelijk zijn.
Circulaire afhankelijkheden worden gedetecteerd en met een foutmelding afgewezen.
Gedrag bij overschrijven
Als er al een blokmap in de doelmap bestaat:
- Interactieve modus: vraagt je om het overschrijven te bevestigen
--yes-vlag: overschrijft zonder te vragen--dry-run-vlag: meldt wat er overschreven zou worden- Niet-interactieve modus zonder
--yes: stopt vóór het downloaden, metBlock "<name>" already exists at <path>. Use --yes to overwrite.
Deze controle omvat ook afhankelijkheden. Daarom is voor het toevoegen van tabs, wanneer tab-item al is geïnstalleerd, --yes nodig.
Meerdere blokken
Blokken die in één opdracht worden opgegeven, worden op volgorde verwerkt. Als een blok mislukt, stopt de opdracht daar en blijven eerder in dezelfde uitvoering geïnstalleerde blokken op schijf staan.
Voorbeelden
Eén blok toevoegen:
npx blockstudio add ui/hero
Meerdere blokken toevoegen:
npx blockstudio add ui/tabs ui/hero ui/accordion
Voorbeeld bekijken zonder bestanden te schrijven:
npx blockstudio add ui/tabs --dry-run
Alle vragen overslaan:
npx blockstudio add ui/tabs --yes