add
npx blockstudio add <blocks...> [options]
Descarcă blocuri dintr-un registru și le scrie în directorul de blocuri al proiectului dvs.
Argumente
| Argument | Descriere |
|---|---|
blocks |
Unul sau mai multe blocuri de adăugat. Format: namespace/block sau doar block. |
Opțiuni
| Opțiune | Descriere |
|---|---|
-y, --yes |
Omite toate solicitările (suprascriere, rezolvarea conflictelor). |
--dry-run |
Previzualizează ce s-ar instala fără a scrie fișiere. |
Rezolvarea spațiului de nume
Când specificați un spațiu de nume, CLI caută în registrul respectiv:
npx blockstudio add ui/tabs
Când omiteți spațiul de nume, CLI caută în toate registrele configurate:
npx blockstudio add tabs
Dacă blocul este găsit într-un singur registru, acesta este folosit automat. Dacă este găsit în mai multe, CLI afișează o solicitare interactivă de selectare.
Cu --yes, se folosește primul registru care corespunde, în ordinea blocks.json. Fără terminal și cu --dry-run, un nume ambiguu oprește comanda cu o eroare care enumeră registrele:
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero
Înainte de a rezolva orice bloc, add preia toate registrele configurate. Dacă unul dintre ele nu este accesibil sau este invalid, comanda eșuează, chiar și pentru un bloc cu spațiu de nume explicit.
Dependențe
Blocurile pot declara dependențe de alte blocuri din același registru. Când adăugați un bloc, dependențele sale sunt rezolvate și instalate automat.
npx blockstudio add ui/tabs
Dacă tabs depinde de tab-item, ambele blocuri sunt descărcate și instalate. Dependențele sunt instalate întotdeauna înaintea blocurilor care depind de ele.
Dependențele circulare sunt detectate și respinse cu o eroare.
Comportamentul la suprascriere
Dacă există deja un director al blocului în directorul țintă:
- Mod interactiv: vi se cere să confirmați suprascrierea
- Indicatorul
--yes: suprascrie fără confirmare - Indicatorul
--dry-run: raportează ce ar fi suprascris - Mod non-interactiv fără
--yes: se oprește înainte de descărcare, cuBlock "<name>" already exists at <path>. Use --yes to overwrite.
Verificarea include și dependențele, așadar adăugarea lui tabs când tab-item este deja instalat necesită --yes.
Mai multe blocuri
Blocurile transmise într-o singură comandă sunt procesate în ordine. Dacă unul dintre ele eșuează, comanda se oprește acolo, iar blocurile instalate anterior în aceeași rulare rămân pe disc.
Exemple
Adăugați un singur bloc:
npx blockstudio add ui/hero
Adăugați mai multe blocuri:
npx blockstudio add ui/tabs ui/hero ui/accordion
Previzualizați fără a scrie:
npx blockstudio add ui/tabs --dry-run
Omiteți toate solicitările:
npx blockstudio add ui/tabs --yes