İçeriğe geç

Bileşenler

Blockstudio her derlemeyle birlikte 59 UI bileşen sunar. Bunlar otomatik olarak kaydedilir, tasarım belirteçleriyle biçimlendirilir ve diğer tüm bloklarla aynı etiket söz dizimiyle yazılır.

Blockstudio 7.3, WordPress Etkileşim API ile desteklenen başsız UI bloklardan oluşan bir set içerir. Bunlar bsui/* ad alanı altında kaydedilir ve şablonlarda, dosya tabanlı sayfalarda, desenlerde ve yazı içeriğinde bir araya getirilebilir.

Not

Bileşen seti, adlandırma, davranış ve proje kullanım kalıpları hakkında geri bildirim topladığımız süre boyunca UI bileşenleri beta aşamasındadır. 7.3'te denenmeye hazırdırlar, ancak kararlı olarak işaretlenmeden önce API arayüzü hâlâ iyileştirilebilir.

UI bileşenlerini etkinleştirme

Paketlenmiş UI bileşenleri isteğe bağlıdır. Bunları temanızın blockstudio.json dosyasında etkinleştirin:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "ui": {
    "enabled": true
  }
}

Bunları bir filtreyle de etkinleştirebilirsiniz:

PHP
add_filter('blockstudio/settings/ui/enabled', '__return_true');

Etkinleştirildiğinde Blockstudio, paketlenmiş bileşen kitaplığını includes/ui/blocks konumundan kaydeder.

Genel Envanter ve Örnekler

Paketlenmiş uygulama blokları normal bsui/* kayıtları olarak kalır; ancak bileşen galerisi oluştururken kullanıcıların genel aile envanterini kullanması gerekir:

PHP
use Blockstudio\Ui;

$families = Ui::inventory();
$examples = Ui::examples();

Ui::inventory(), her bileşik bileşeni genel kökü altında gruplar ve o aile için gereken uygulama kayıtlarını listeler. Ui::examples(), varsayılan ve örnek verileri içeren, belirlenimci ve normalleştirilmiş bir bildirim ekler. Gerekli kök/alt öğe ilişkilerini koruduğu için sonuç doğrudan Blockstudio\Render::document() öğesine aktarılabilir.

Genel Canvas envanteri bu örnekleri ui türünde sunar ve paketlenmiş uygulama kayıtlarını normal blocks türünden çıkarır. Böylece iç kök, tetikleyici, açılır pencere ve katman parçalarından oluşan bir galeri yerine her genel bileşen ailesi için eksiksiz bir örnek elde edilir.

Önceden oluşturulmuş bir belge bir araya getirilirken Ui::global_assets($block_names, $html), paketlenmiş genel stil ve betiğin tam sürümünü yalnızca seçilen çıktı gerçekten bir UI bileşeni kullanıyorsa döndürür.

Oluşturma

Normal blok etiketi sözdizimini kullanın:

HTML
<block name="bsui/button" label="Save" variant="default"></block>

Daha kısa <bs:> sözdizimi de çalışır:

HTML
<bs:bsui-button label="Save" variant="default" />

Blockstudio şablonlarında blok etiketleri otomatik olarak oluşturulur. Dosya tabanlı sayfalarda ve desenlerde yerel WordPress bloklarıyla eşzamanlanırlar. UI bileşenlerini doğrudan yazı içeriğinden veya bileşen alanlarından oluşturmak istiyorsanız sayfa düzeyinde blok etiketlerini etkinleştirin:

JSON
{
  "ui": {
    "enabled": true
  },
  "blockTags": {
    "enabled": true,
    "allow": ["bsui/*", "app/*"]
  }
}

Temel Bileşenler

Basit bileşenler tek bir blok olarak oluşturulur:

HTML
<block name="bsui/button" label="Continue" variant="default"></block>
<block name="bsui/badge" label="Beta"></block>
<block
  name="bsui/input"
  nameAlt="email"
  type="email"
  placeholder="Email"
></block>
<block name="bsui/textarea" name="message" placeholder="Message"></block>
<block name="bsui/spinner"></block>

Öznitelikler her bileşenin block.json öznitelikleriyle doğrudan eşleşir. Örneğin bsui/button; label, icon, iconPosition, href, variant, size ve disabled değerlerini destekler.

PHP
bs_render_block([
  'name' => 'bsui/button',
  'data' => [
    'label' => 'Continue',
    'icon' => [
      'set' => 'heroicons',
      'subSet' => 'outline',
      'icon' => 'arrow-right',
    ],
    'iconPosition' => 'right',
  ],
]);

Bileşik Bileşenler

Birçok UI bileşeni bileşik bloklardır. Kök blok durumu yönetir, alt bloklar ise üst öğelerini bildirir.

Sekmeler

HTML
<block name="bsui/tabs" defaultValue="tab1">
  <block name="bsui/tabs-list">
    <block name="bsui/tabs-trigger" value="tab1" title="Features"></block>
    <block name="bsui/tabs-trigger" value="tab2" title="Pricing"></block>
    <block name="bsui/tabs-trigger" value="tab3" title="FAQ"></block>
  </block>
  <block name="bsui/tabs-panel" value="tab1">
    <p>Features content.</p>
  </block>
  <block name="bsui/tabs-panel" value="tab2">
    <p>Pricing content.</p>
  </block>
  <block name="bsui/tabs-panel" value="tab3">
    <p>FAQ content.</p>
  </block>
</block>

İletişim kutusu

HTML
<block name="bsui/dialog">
  <block name="bsui/dialog-trigger" label="Open Dialog"></block>
  <block name="bsui/dialog-backdrop"></block>
  <block name="bsui/dialog-popup">
    <p>Dialog content.</p>
    <block name="bsui/dialog-close" label="Close"></block>
  </block>
</block>

Seçim listesi

HTML
<block name="bsui/select" placeholder="Choose a fruit" nameAlt="fruit">
  <block name="bsui/select-trigger"></block>
  <block name="bsui/select-popup">
    <block name="bsui/select-option" value="apple" label="Apple"></block>
    <block name="bsui/select-option" value="banana" label="Banana"></block>
    <block name="bsui/select-option" value="cherry" label="Cherry"></block>
  </block>
</block>

Form Alanları

HTML
<block name="bsui/form" block="contact/form" successMessage="Thank you!">
  <block name="bsui/field">
    <block name="bsui/field-label" text="Email"></block>
    <block name="bsui/input" nameAlt="email" type="email"></block>
    <block name="bsui/field-error"></block>
  </block>
</block>

Kullanılabilir Bloklar

Paketlenmiş UI kitaplığı şunları içerir:

Alan Bloklar
Düzen bsui/aspect-ratio, bsui/card, bsui/separator, bsui/stack, bsui/table
Eylemler bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar
Girdiler bsui/checkbox, bsui/color-picker, bsui/date-input, bsui/file-upload, bsui/input, bsui/number-field, bsui/otp-input, bsui/password-input, bsui/phone-input, bsui/radio-group, bsui/rating, bsui/select, bsui/slider, bsui/switch, bsui/textarea, bsui/time-picker
Katmanlar bsui/alert-dialog, bsui/dialog, bsui/drawer, bsui/menu, bsui/menubar, bsui/popover, bsui/preview-card, bsui/tooltip
Gezinme bsui/accordion, bsui/breadcrumb, bsui/carousel, bsui/collapsible, bsui/context-menu, bsui/navigation-menu, bsui/pagination, bsui/tabs
Geri Bildirim bsui/badge, bsui/kbd, bsui/meter, bsui/progress, bsui/skeleton, bsui/spinner, bsui/text, bsui/toast
Formlar bsui/field, bsui/field-group, bsui/form

Bileşik bileşenler ayrıca bsui/dialog-trigger, bsui/dialog-popup, bsui/tabs-list, bsui/tabs-trigger, bsui/tabs-panel, bsui/select-trigger, bsui/select-popup ve bsui/select-option gibi alt bloklar sunar.

Stil

UI bileşenleri, --bs-ui-* ön ekini kullanan kendi CSS özel özellikleriyle birlikte gelir. Bunları temanızın CSS dosyasından geçersiz kılabilirsiniz:

CSS
:root {
  --bs-ui-radius: 0.5rem;
  --bs-ui-primary: oklch(0.45 0.18 260);
  --bs-ui-primary-foreground: white;
}

Davranış bakımından başsız olan bileşenler, kutudan çıktığı gibi kullanılabilecek kadar da belirgin tercihlere sahiptir. Önce belirteçleri geçersiz kılın, ardından gerektiğinde bileşene özel CSS ekleyin.

Paketlenmiş bileşen CSS, adı belirtilen bsui basamak katmanında yayımlanır. Katmansız tema CSS kuralları, !important gerektirmeden bileşen kurallarını geçersiz kılabilir:

CSS
.button-brand {
  background: var(--brand-primary);
}

Özel bir bsui/button varyantı eklemek için mevcut öznitelik filtresiyle seçim seçeneğini ekleyin ve varyant CSS değerini blockstudio/ui/button/variants-style ile sağlayın:

PHP
add_filter('blockstudio/blocks/attributes', function($attribute, $block) {
  if (($block['name'] ?? '') === 'bsui/button' && ($attribute['id'] ?? '') === 'variant') {
    $attribute['options'][] = [
      'label' => 'Brand',
      'value' => 'brand',
    ];
  }

  return $attribute;
}, 10, 2);

add_filter('blockstudio/ui/button/variants-style', function($css) {
  return $css . '
[data-bsui-button][data-variant="brand"] {
  background: var(--brand-primary);
  color: white;
}';
});

Tüm bileşenler

Akordeon Her seferinde tek paneli genişleten, üst üste sıralanmış bölümler. Uyarı İletişim Kutusu Kullanıcı akışını kesen ve kapanmadan önce yanıt gerektiren bir modal. En Boy Oranı İçeriği sabit bir genişlik-yükseklik oranına kilitler. Avatar Yüklenemediğinde baş harflere dönen bir kullanıcı görseli. Rozet Durumlar, sayılar ve kategoriler için küçük bir etiket. İçerik Haritası Geçerli sayfanın hiyerarşide nerede olduğunu gösterir. Düğme Her vurgu düzeyi için varyantlarla bir eylemi tetikler. Düğme Grubu İlgili düğmeleri tek bir bölümlü denetimde birleştirir. Takvim Tek bir gün seçmek için tarih ızgarası. Kart Başlık, gövde ve alt bilgiyi bir arada tutan bir yüzey. Karusel Klavye desteği olan, kaydırılabilir slayt şeridi. Onay Kutusu Belirsiz durumu da destekleyen ikili seçim. Daraltılabilir Tek bir içerik bölgesini gizler ve gösterir. Renk Seçici Bir renk seçer ve çevresindeki formla birlikte gönderir. Birleşik Kutu Yazarken seçenek listesini filtreleyen metin girişi. Bağlam Menüsü Sağ tıklamayla açılan ve işaretçiye sabitlenen eylemler. Tarih Girdisi Tarih seçici olmadan tarih girmek için maskeli alan. İletişim Kutusu Odaklanılmış görevler ve onaylar için modal katman. Çekmece Ekranın herhangi bir kenarından kayan panel. Alan Bir denetimi etiketi, açıklaması ve hatasıyla sarar. Alan Grubu İlgili alanları ortak bir başlık altında gruplar. Dosya Yükleme Birden çok dosyayı destekleyen bırakma alanı ve dosya seçici. Form Alanlarını gönderir ve sayfayı yeniden yüklemeden başarıyı bildirir. Girdi Yaygın tüm giriş türleri için tek satırlı metin alanı. Klavye Kısayolu Klavye kısayolunu kendi tuş başlığında gösterir. Etiket Etiketli her bileşenin paylaştığı denetim açıklaması. Menü Bir tetikleyiciye sabitlenen eylemler açılır listesi. Menü Çubuğu Masaüstü uygulamalarındaki gibi yatay menü çubuğu. Ölçer Bilinen bir aralık içindeki ölçümü gösterir. Gezinme Menüsü İç içe bağlantılar ve üzerine gelince açılan panellerle site gezinmesi. Sayı Alanı Artırma ve azaltma düğmeleri ile sınırlandırılmış aralık içeren sayısal giriş. OTP Girişi Tek kullanımlık parola girmek için ayrı kutular. Sayfalandırma Önceki, sonraki ve kısaltma seçenekleri içeren sayfa bağlantıları. Parola Girişi Gösterme düğmesi olan parola alanı. Telefon Numarası Girişi Ülke seçimi ve biçimlendirme içeren telefon alanı. Açılır Kart Bir tetikleyiciye sabitlenen, dışarı tıklanınca kapanan zengin içerik. Önizleme Kartı Bir bağlantının nereye gittiğini önizleyen üzerine gelme kartı. İlerleme Bir görevin ne kadar ilerlediğini gösterir. Radyo Düğmesi Grubu Tam olarak birinin seçilebildiği seçenek kümesi. Puanlama Puan vermek için yıldız denetimi. Kaydırma Alanı Biçimlendirilmiş, üst katmanda görünen kaydırma çubuklarına sahip kaydırma kapsayıcısı. Seçiniz Seçenek listesinden seçim yapmak için açılır liste. Ayırıcı İçeriği veya denetim gruplarını ayıran çizgi. İskelet İçerik yüklenirken onun yerini tutan yer tutucu şekil. Kaydırıcı Bir iz boyunca sürükleyerek değer veya aralık seçer. Boşluk Boşluk ölçeğinden alınan sabit bir dikey ritim adımı. Yükleme Göstergesi Tahmini süre olmadan devam eden işi belirtir. Yığın Alt öğeleri tutarlı aralıklarla satır veya sütun halinde dizer. Anahtar Hemen uygulanan bir ayarı açıp kapatır. Tablo İsteğe bağlı sıralama ve şeritlendirme içeren tablo verileri. Sekmeler Aynı alanı kaplayan paneller arasında geçiş yapar. Text Düzyazıyı seçilen boyutta ve anlamsal etikette işler. Metin Alanı Satır sayısına göre büyüyen çok satırlı metin alanı. Saat Seçici Seçilen adım aralığında günün saatini seçer. Bildirim Sağlayıcısı Ekran köşesinde geçici bildirimleri gösterir. Aç/Kapat Açık durumunu göstermek için basılı kalan düğme. Aç/Kapat Grubu Tekli veya çoklu seçim olarak çalışan geçiş düğmeleri kümesi. Araç Çubuğu Öğeler arasında odak dolaşımı olan denetim satırı. İpucu Üzerine gelince veya odaklanınca gösterilen kısa ipucu.