Ga naar de inhoud

toevoegen

Shell
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:

Shell
npx blockstudio add ui/tabs

Wanneer je de naamruimte weglaat, doorzoekt de CLI alle geconfigureerde registers:

Shell
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:

Code
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.

Shell
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, met Block "<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:

Shell
npx blockstudio add ui/hero

Meerdere blokken toevoegen:

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

Voorbeeld bekijken zonder bestanden te schrijven:

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

Alle vragen overslaan:

Shell
npx blockstudio add ui/tabs --yes