Pāriet uz saturu

add

Apvalks
npx blockstudio add <blocks...> [options]

Lejupielādē blokus no reģistra un ievieto tos projekta bloku mapē.

Argumenti

Arguments Apraksts
blocks Viens vai vairāki pievienojamie bloki. Formāts: namespace/block vai tikai block.

Opcijas

Opcija Apraksts
-y, --yes Izlaist visus jautājumus (pārrakstīšana, konfliktu risināšana).
--dry-run Priekšskatīt instalējamo, nerakstot failus.

Nosaukumvietas atrisināšana

Norādot nosaukumvietu, CLI meklē norādītajā reģistrā:

Apvalks
npx blockstudio add ui/tabs

Ja nosaukumvieta nav norādīta, CLI meklē visos konfigurētajos reģistros:

Apvalks
npx blockstudio add tabs

Ja bloks ir atrodams tieši vienā reģistrā, tas tiek izmantots automātiski. Ja tas atrodams vairākos reģistros, CLI parāda interaktīvu atlases uzvedni.

Ar --yes tiek izmantots pirmais atbilstošais reģistrs secībā blocks.json. Ja termināļa nav un ir norādīts --dry-run, neskaidra nosaukuma gadījumā komanda tiek apturēta ar kļūdu, kurā uzskaitīti reģistri:

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

Pirms jebkura bloka atrašanas add iegūst datus no visiem konfigurētajiem reģistriem. Ja kāds no tiem nav sasniedzams vai ir nederīgs, komanda neizdodas pat tad, ja blokam ir skaidri norādīta nosaukumvieta.

Atkarības

Bloki var deklarēt atkarības no citiem blokiem tajā pašā reģistrā. Pievienojot bloku, tā atkarības tiek atrastas un instalētas automātiski.

Apvalks
npx blockstudio add ui/tabs

Ja tabs ir atkarīgs no tab-item, abi bloki tiek lejupielādēti un instalēti. Atkarības vienmēr tiek instalētas pirms blokiem, kas no tām ir atkarīgi.

Cikliskas atkarības tiek konstatētas un noraidītas ar kļūdu.

Pārrakstīšanas darbība

Ja mērķa mapē jau pastāv bloka mape:

  • Interaktīvais režīms: tiek prasīts apstiprināt pārrakstīšanu
  • Karodziņš --yes: pārraksta bez jautāšanas
  • Karodziņš --dry-run: parāda, ko pārrakstītu
  • Neinteraktīvais režīms bez --yes: aptur komandu pirms lejupielādes, norādot Block "<name>" already exists at <path>. Use --yes to overwrite.

Pārbaude attiecas arī uz atkarībām, tāpēc, lai pievienotu tabs, ja tab-item jau ir instalēts, nepieciešams --yes.

Vairāki bloki

Vienā komandā norādītie bloki tiek apstrādāti pēc kārtas. Ja kāda apstrāde neizdodas, komanda tiek apturēta, un tajā pašā izpildes reizē iepriekš instalētie bloki paliek diskā.

Piemēri

Pievienot vienu bloku:

Apvalks
npx blockstudio add ui/hero

Pievienot vairākus blokus:

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

Priekšskatīt, nerakstot failus:

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

Izlaist visus jautājumus:

Apvalks
npx blockstudio add ui/tabs --yes