add
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ā:
npx blockstudio add ui/tabs
Ja nosaukumvieta nav norādīta, CLI meklē visos konfigurētajos reģistros:
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:
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.
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ādotBlock "<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:
npx blockstudio add ui/hero
Pievienot vairākus blokus:
npx blockstudio add ui/tabs ui/hero ui/accordion
Priekšskatīt, nerakstot failus:
npx blockstudio add ui/tabs --dry-run
Izlaist visus jautājumus:
npx blockstudio add ui/tabs --yes