hinzufügen
npx blockstudio add <blocks...> [options]
Lädt Blöcke aus einer Registry herunter und schreibt sie in das Blockverzeichnis deines Projekts.
Argumente
| Argument | Beschreibung |
|---|---|
blocks |
Ein oder mehrere hinzuzufügende Blöcke. Format: namespace/block oder einfach block. |
Optionen
| Option | Beschreibung |
|---|---|
-y, --yes |
Alle Eingabeaufforderungen überspringen (Überschreiben, Konfliktlösung). |
--dry-run |
Zeige vorab an, was installiert würde, ohne Dateien zu schreiben. |
Namensraumauflösung
Wenn du einen Namensraum angibst, sucht der CLI in der angegebenen Registry:
npx blockstudio add ui/tabs
Wenn du keinen Namensraum angibst, durchsucht der CLI alle konfigurierten Registries:
npx blockstudio add tabs
Wird der Block in genau einer Registry gefunden, wird er automatisch verwendet. Wird er in mehreren gefunden, zeigt der CLI eine interaktive Auswahl an.
Mit --yes wird die erste passende Registry in der Reihenfolge von blocks.json verwendet.
Ohne Terminal und mit --dry-run bricht der Befehl bei einem mehrdeutigen Namen mit einer Fehlermeldung ab, die die Registries auflistet:
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero
Bevor der add einen Block auflöst, ruft er alle konfigurierten Registries ab. Ist eine davon nicht erreichbar oder ungültig, schlägt der Befehl fehl – auch bei einem Block mit explizitem Namensraum.
Abhängigkeiten
Blöcke können Abhängigkeiten zu anderen Blöcken in derselben Registry festlegen. Wenn du einen Block hinzufügst, werden seine Abhängigkeiten automatisch aufgelöst und installiert.
npx blockstudio add ui/tabs
Wenn tabs von tab-item abhängt, werden beide Blöcke heruntergeladen und installiert.
Abhängigkeiten werden immer vor den Blöcken installiert, die von ihnen abhängen.
Zyklische Abhängigkeiten werden erkannt und mit einer Fehlermeldung abgelehnt.
Verhalten beim Überschreiben
Wenn im Zielverzeichnis bereits ein Blockordner vorhanden ist:
- Interaktiver Modus: Du wirst gefragt, ob du das Überschreiben bestätigen möchtest
--yes-Flag: überschreibt ohne Nachfrage--dry-run-Flag: zeigt an, was überschrieben würde- Nicht-interaktiver Modus ohne
--yes: bricht vor dem Download ab, mitBlock "<name>" already exists at <path>. Use --yes to overwrite.
Die Prüfung berücksichtigt auch Abhängigkeiten. Wenn tab-item bereits installiert ist, brauchst du zum Hinzufügen von tabs also --yes.
Mehrere Blöcke
Blöcke, die in einem Befehl übergeben werden, werden der Reihe nach verarbeitet. Schlägt einer fehl, wird der Befehl an dieser Stelle abgebrochen. Blöcke, die während desselben Durchlaufs zuvor installiert wurden, bleiben auf der Festplatte.
Beispiele
Einen einzelnen Block hinzufügen:
npx blockstudio add ui/hero
Mehrere Blöcke hinzufügen:
npx blockstudio add ui/tabs ui/hero ui/accordion
Vorschau ohne Schreibvorgang:
npx blockstudio add ui/tabs --dry-run
Alle Eingabeaufforderungen überspringen:
npx blockstudio add ui/tabs --yes