Βοηθητικά εργαλεία HTML
Μερικές φορές χρειάζεται να χρησιμοποιήσετε τιμές χαρακτηριστικών στα αρχεία CSS ή JS. Το Blockstudio παρέχει βοηθητικές συναρτήσεις για την απόδοση χαρακτηριστικών ως χαρακτηριστικών δεδομένων ή μεταβλητών CSS.
Παράδειγμα block
Ας υποθέσουμε ότι έχουμε ένα block με τα ακόλουθα χαρακτηριστικά:
{
"blockstudio": {
"attributes": [
{
"id": "message",
"type": "text",
"label": "My message"
},
{
"id": "color",
"type": "color",
"label": "My color"
}
]
}
}
Χαρακτηριστικά δεδομένων
Η συνάρτηση bs_render_attributes αποδίδει χαρακτηριστικά ως χαρακτηριστικά δεδομένων:
PHP
<h1 <?php bs_render_attributes($a); ?>>
<?php echo $a['message']; ?>
</h1>
Twig
<h1 {{ fn('bs_render_attributes', a) }}>
{{ a.message }}
</h1>
Αποτέλεσμα:
<h1 data-message="Hello" data-color="#7C3AED">
Hello
</h1>
Φιλτράρισμα χαρακτηριστικών
Περάστε μια δεύτερη παράμετρο για να ορίσετε ποια χαρακτηριστικά θα αποδοθούν:
PHP
<h1 <?php bs_render_attributes($a, ['color']); ?>>
<?php echo $a['message']; ?>
</h1>
Twig
<h1 {{ fn('bs_render_attributes', a, ['color']) }}>
{{ a.message }}
</h1>
Αποτέλεσμα:
<h1 data-color="#7C3AED">
Hello
</h1>
Επιστροφή χωρίς απόδοση
Χρησιμοποιήστε το bs_attributes για να λάβετε τη συμβολοσειρά χωρίς να την εκτυπώσετε:
<?php $attrs = bs_attributes($a); ?>
Μεταβλητές CSS
Η συνάρτηση bs_render_variables αποδίδει χαρακτηριστικά ως μεταβλητές CSS:
PHP
<h1 style="<?php bs_render_variables($a); ?>">
<?php echo $a['message']; ?>
</h1>
Twig
<h1 style="{{ fn('bs_render_variables', a) }}">
{{ a.message }}
</h1>
Αποτέλεσμα:
<h1 style="--message: Hello; --color: #7C3AED;">
Hello
</h1>
Φιλτράρισμα μεταβλητών
<h1 style="<?php bs_render_variables($a, ['color']); ?>">
Αποτέλεσμα:
<h1 style="--color: #7C3AED;">
Hello
</h1>
Επιστροφή χωρίς απόδοση
Χρησιμοποιήστε το bs_variables για να λάβετε τη συμβολοσειρά χωρίς να την εκτυπώσετε:
<?php $vars = bs_variables($a); ?>
Μετατροπή συμβολοσειρών
Και οι δύο συναρτήσεις μετατρέπουν τα αναγνωριστικά χαρακτηριστικών σε kebab-case:
| Είσοδος | Έξοδος |
|---|---|
myAttribute |
my-attribute |
my_attribute |
my-attribute |
backgroundColor |
background-color |
Χρήση σε CSS
.my-block h1 {
color: var(--color);
}
Χρήση σε JavaScript
const block = document.querySelector('.my-block h1');
const color = block.dataset.color;
const message = block.dataset.message;