Treci la conținut

add

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

Shell
npx blockstudio add ui/tabs

Când omiteți spațiul de nume, CLI caută în toate registrele configurate:

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

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

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

Shell
npx blockstudio add ui/hero

Adăugați mai multe blocuri:

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

Previzualizați fără a scrie:

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

Omiteți toate solicitările:

Shell
npx blockstudio add ui/tabs --yes