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:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Bunları bir filtreyle de etkinleştirebilirsiniz:
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:
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:
<block name="bsui/button" label="Save" variant="default"></block>
Daha kısa <bs:> sözdizimi de çalışır:
<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:
{
"ui": {
"enabled": true
},
"blockTags": {
"enabled": true,
"allow": ["bsui/*", "app/*"]
}
}
Temel Bileşenler
Basit bileşenler tek bir blok olarak oluşturulur:
<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.
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
<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
<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
<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ı
<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:
: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:
.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:
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;
}';
});
İlgili
- UI Bileşim; denetimli alanlar, alan kartları ve araç çubuğu ayırıcıları dahil
- Programatik Oluşturma
- Bileşenler
- Etkileşim API