ekle
npx blockstudio add <blocks...> [options]
Bir kayıt deposundan blokları indirir ve projenizin blok dizinine yazar.
Bağımsız değişkenler
| Bağımsız değişken | Açıklama |
|---|---|
blocks |
Eklenecek bir veya daha fazla blok. Biçim: namespace/block veya yalnızca block. |
Seçenekler
| Seçenek | Açıklama |
|---|---|
-y, --yes |
Tüm istemleri atlar (üzerine yazma, çakışma çözümü). |
--dry-run |
Dosyaları yazmadan nelerin kurulacağını önizler. |
Ad alanı çözümleme
Bir ad alanı belirttiğinizde, CLI belirtilen kayıt deposunda arama yapar:
npx blockstudio add ui/tabs
Ad alanını belirtmezseniz, CLI yapılandırılmış tüm kayıt depolarında arama yapar:
npx blockstudio add tabs
Blok tam olarak bir kayıt deposunda bulunursa otomatik olarak kullanılır. Birden fazla yerde bulunursa, CLI seçim yapmanız için etkileşimli bir istem gösterir.
--yes ile blocks.json sırasındaki ilk eşleşen kayıt deposu kullanılır.
Terminal olmadığında ve --dry-run kullanıldığında, belirsiz bir ad kayıt depolarını listeleyen bir hatayla komutu durdurur:
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero
Herhangi bir bloğu çözümlemeden önce add yapılandırılmış tüm kayıt depolarını getirir. Bunlardan biri erişilemez veya geçersizse, açıkça bir ad alanı belirtilmiş bloklarda bile komut başarısız olur.
Bağımlılıklar
Bloklar, aynı kayıt deposundaki diğer bloklara bağımlılık bildirebilir. Bir blok eklediğinizde bağımlılıkları çözülür ve otomatik olarak kurulur.
npx blockstudio add ui/tabs
tabs, tab-item öğesine bağlıysa iki blok da indirilip kurulur.
Bağımlılıklar, kendilerine bağlı olan bloklardan önce kurulur.
Döngüsel bağımlılıklar tespit edilir ve hata verilerek reddedilir.
Üzerine yazma davranışı
Hedef dizinde bir blok klasörü zaten varsa:
- Etkileşimli mod: üzerine yazmayı onaylamanız istenir
--yesişareti: sormadan üzerine yazar--dry-runişareti: üzerine yazılacakları bildirir--yesolmadan etkileşimsiz mod: indirmeden önce durur veBlock "<name>" already exists at <path>. Use --yes to overwrite.bildirir
Denetim bağımlılıkları da kapsar; bu nedenle tab-item zaten kuruluysa, tabs eklemek için --yes gerekir.
Birden fazla blok
Tek komutta verilen bloklar sırayla işlenir. İçlerinden biri başarısız olursa komut o noktada durur; aynı çalıştırmada daha önce kurulan bloklar diskte kalır.
Örnekler
Tek bir blok ekleyin:
npx blockstudio add ui/hero
Birden fazla blok ekleyin:
npx blockstudio add ui/tabs ui/hero ui/accordion
Dosya yazmadan önizleyin:
npx blockstudio add ui/tabs --dry-run
Tüm istemleri atlayın:
npx blockstudio add ui/tabs --yes