Przejdź do treści

add

Powłoka
npx blockstudio add <blocks...> [options]

Pobiera bloki z rejestru i zapisuje je w katalogu bloków projektu.

Argumenty

Argument Opis
blocks Jeden lub więcej bloków do dodania. Format: namespace/block lub samo block.

Opcje

Opcja Opis
-y, --yes Pomija wszystkie monity (nadpisywanie, rozwiązywanie konfliktów).
--dry-run Wyświetla podgląd instalacji bez zapisywania plików.

Rozpoznawanie przestrzeni nazw

Po podaniu przestrzeni nazw CLI szuka w określonym rejestrze:

Powłoka
npx blockstudio add ui/tabs

Jeśli nie podasz przestrzeni nazw, CLI przeszukuje wszystkie skonfigurowane rejestry:

Powłoka
npx blockstudio add tabs

Jeśli blok znajduje się dokładnie w jednym rejestrze, zostaje użyty automatycznie. Jeśli znajduje się w kilku, CLI wyświetla interaktywny monit wyboru.

Z opcją --yes używany jest pierwszy pasujący rejestr w kolejności blocks.json. Bez terminala i z opcją --dry-run niejednoznaczna nazwa powoduje przerwanie polecenia z błędem zawierającym listę rejestrów:

Kod
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero

Przed rozpoznaniem dowolnego bloku add pobiera dane ze wszystkich skonfigurowanych rejestrów. Jeśli któryś jest niedostępny lub nieprawidłowy, polecenie kończy się błędem, nawet gdy blok ma jawną przestrzeń nazw.

Zależności

Bloki mogą deklarować zależności od innych bloków w tym samym rejestrze. Po dodaniu bloku jego zależności są automatycznie rozpoznawane i instalowane.

Powłoka
npx blockstudio add ui/tabs

Jeśli tabs zależy od tab-item, oba bloki zostaną pobrane i zainstalowane. Zależności są zawsze instalowane przed blokami, które od nich zależą.

Wykryte zależności cykliczne powodują błąd i przerwanie polecenia.

Zasady nadpisywania

Jeśli folder bloku już istnieje w katalogu docelowym:

  • Tryb interaktywny: prosi o potwierdzenie nadpisania
  • Flaga --yes: nadpisuje bez pytania
  • Flaga --dry-run: informuje, co zostałoby nadpisane
  • Tryb nieinteraktywny bez --yes: przerywa działanie przed pobieraniem, z komunikatem Block "<name>" already exists at <path>. Use --yes to overwrite.

Kontrola obejmuje też zależności, więc dodanie tabs, gdy tab-item jest już zainstalowany, wymaga opcji --yes.

Wiele bloków

Bloki podane w jednym poleceniu są przetwarzane po kolei. Jeśli któryś z nich spowoduje błąd, polecenie zatrzymuje się w tym miejscu, a bloki zainstalowane wcześniej w ramach tego samego uruchomienia pozostają na dysku.

Przykłady

Dodaj jeden blok:

Powłoka
npx blockstudio add ui/hero

Dodaj wiele bloków:

Powłoka
npx blockstudio add ui/tabs ui/hero ui/accordion

Wyświetl podgląd bez zapisywania:

Powłoka
npx blockstudio add ui/tabs --dry-run

Pomiń wszystkie monity:

Powłoka
npx blockstudio add ui/tabs --yes