İçeriğe geç

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;