Μετάβαση στο περιεχόμενο

Βοηθητικά εργαλεία HTML

Μερικές φορές χρειάζεται να χρησιμοποιήσετε τιμές χαρακτηριστικών στα αρχεία CSS ή JS. Το Blockstudio παρέχει βοηθητικές συναρτήσεις για την απόδοση χαρακτηριστικών ως χαρακτηριστικών δεδομένων ή μεταβλητών CSS.

Παράδειγμα block

Ας υποθέσουμε ότι έχουμε ένα block με τα ακόλουθα χαρακτηριστικά:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "message",
        "type": "text",
        "label": "My message"
      },
      {
        "id": "color",
        "type": "color",
        "label": "My color"
      }
    ]
  }
}

Χαρακτηριστικά δεδομένων

Η συνάρτηση bs_render_attributes αποδίδει χαρακτηριστικά ως χαρακτηριστικά δεδομένων:

PHP

PHP
<h1 <?php bs_render_attributes($a); ?>>
  <?php echo $a['message']; ?>
</h1>

Twig

Twig
<h1 {{ fn('bs_render_attributes', a) }}>
  {{ a.message }}
</h1>

Αποτέλεσμα:

HTML
<h1 data-message="Hello" data-color="#7C3AED">
  Hello
</h1>

Φιλτράρισμα χαρακτηριστικών

Περάστε μια δεύτερη παράμετρο για να ορίσετε ποια χαρακτηριστικά θα αποδοθούν:

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>

Αποτέλεσμα:

HTML
<h1 data-color="#7C3AED">
  Hello
</h1>

Επιστροφή χωρίς απόδοση

Χρησιμοποιήστε το bs_attributes για να λάβετε τη συμβολοσειρά χωρίς να την εκτυπώσετε:

PHP
<?php $attrs = bs_attributes($a); ?>

Μεταβλητές CSS

Η συνάρτηση bs_render_variables αποδίδει χαρακτηριστικά ως μεταβλητές CSS:

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>

Αποτέλεσμα:

HTML
<h1 style="--message: Hello; --color: #7C3AED;">
  Hello
</h1>

Φιλτράρισμα μεταβλητών

PHP
<h1 style="<?php bs_render_variables($a, ['color']); ?>">

Αποτέλεσμα:

HTML
<h1 style="--color: #7C3AED;">
  Hello
</h1>

Επιστροφή χωρίς απόδοση

Χρησιμοποιήστε το bs_variables για να λάβετε τη συμβολοσειρά χωρίς να την εκτυπώσετε:

PHP
<?php $vars = bs_variables($a); ?>

Μετατροπή συμβολοσειρών

Και οι δύο συναρτήσεις μετατρέπουν τα αναγνωριστικά χαρακτηριστικών σε kebab-case:

Είσοδος Έξοδος
myAttribute my-attribute
my_attribute my-attribute
backgroundColor background-color

Χρήση σε CSS

CSS
.my-block h1 {
  color: var(--color);
}

Χρήση σε JavaScript

JavaScript
const block = document.querySelector('.my-block h1');
const color = block.dataset.color;
const message = block.dataset.message;