HTML Yardımcı İşlevleri
Bazen öznitelik değerlerini CSS veya JS dosyalarınızda kullanmanız gerekir. Blockstudio, öznitelikleri veri öznitelikleri veya CSS değişkenleri olarak oluşturmak için yardımcı işlevler sunar.
Örnek Blok
Aşağıdaki özniteliklere sahip bir blok olduğunu varsayalım:
JSON
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message"
},
{
"id": "color",
"type": "color",
"label": "My color"
}
]
}
}
Veri Öznitelikleri
bs_render_attributes işlevi, öznitelikleri veri öznitelikleri olarak oluşturur:
PHP
PHP
<h1 <?php bs_render_attributes($a); ?>>
<?php echo $a['message']; ?>
</h1>
Twig
Twig
<h1 {{ fn('bs_render_attributes', a) }}>
{{ a.message }}
</h1>
Çıktı:
HTML
<h1 data-message="Hello" data-color="#7C3AED">
Hello
</h1>
Öznitelikleri Filtreleme
Oluşturulacak öznitelikleri belirtmek için ikinci bir parametre geçirin:
PHP
PHP
<h1 <?php bs_render_attributes($a, ['color']); ?>>
<?php echo $a['message']; ?>
</h1>
Twig
Twig
<h1 {{ fn('bs_render_attributes', a, ['color']) }}>
{{ a.message }}
</h1>
Çıktı:
HTML
<h1 data-color="#7C3AED">
Hello
</h1>
Oluşturmadan Döndürme
Yankılamadan dizeyi almak için bs_attributes kullanın:
PHP
<?php $attrs = bs_attributes($a); ?>
CSS Değişkenleri
bs_render_variables işlevi, öznitelikleri CSS değişkenleri olarak oluşturur:
PHP
PHP
<h1 style="<?php bs_render_variables($a); ?>">
<?php echo $a['message']; ?>
</h1>
Twig
Twig
<h1 style="{{ fn('bs_render_variables', a) }}">
{{ a.message }}
</h1>
Çıktı:
HTML
<h1 style="--message: Hello; --color: #7C3AED;">
Hello
</h1>
Değişkenleri Filtreleme
PHP
<h1 style="<?php bs_render_variables($a, ['color']); ?>">
Çıktı:
HTML
<h1 style="--color: #7C3AED;">
Hello
</h1>
Oluşturmadan Döndürme
Yankılamadan dizeyi almak için bs_variables kullanın:
PHP
<?php $vars = bs_variables($a); ?>
Dize Dönüştürme
Her iki işlev de öznitelik kimliklerini kebab-case biçimine dönüştürür:
| Girdi | Çıktı |
|---|---|
myAttribute |
my-attribute |
my_attribute |
my-attribute |
backgroundColor |
background-color |
CSS İçinde Kullanım
CSS
.my-block h1 {
color: var(--color);
}
JavaScript İçinde Kullanım
JavaScript
const block = document.querySelector('.my-block h1');
const color = block.dataset.color;
const message = block.dataset.message;