İçeriğe geç

ekle

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

Kabuk
npx blockstudio add ui/tabs

Ad alanını belirtmezseniz, CLI yapılandırılmış tüm kayıt depolarında arama yapar:

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

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

Kabuk
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
  • --yes işareti: sormadan üzerine yazar
  • --dry-run işareti: üzerine yazılacakları bildirir
  • --yes olmadan etkileşimsiz mod: indirmeden önce durur ve Block "<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:

Kabuk
npx blockstudio add ui/hero

Birden fazla blok ekleyin:

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

Dosya yazmadan önizleyin:

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

Tüm istemleri atlayın:

Kabuk
npx blockstudio add ui/tabs --yes