RichText
Οι αλλαγές του RichText αποθηκεύονται αμέσως στα γνωρίσματα του μπλοκ και καταγράφονται στο ιστορικό αναίρεσης και επαναφοράς του Gutenberg, ακόμη και όταν το RichText βρίσκεται σε γραμμές επαναλήπτη. Η αποθήκευση ενώ είναι επιλεγμένα πολλά μπλοκ διατηρεί το περιεχόμενο και τα γνωρίσματα κάθε μπλοκ ξεχωριστά.
Το στοιχείο RichText επιτρέπει την απόδοση ενός επεξεργάσιμου πεδίου εισαγωγής μέσα στον επεξεργαστή και ενός στατικού στοιχείου HTML στο frontend. Βασίζεται στο στοιχείο RichText που παρέχει το WordPress.
Βασική χρήση
Για να χρησιμοποιήσετε το RichText στη βασικότερη μορφή του, πρέπει να προσθέσετε το κατάλληλο γνώρισμα στο block.json σας και το στοιχείο RichText στο μπλοκ σας.
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/rich-text",
"title": "Native Block",
"category": "text",
"icon": "star-filled",
"description": "Native Blockstudio RichText block.",
"blockstudio": {
"attributes": [
{
"id": "myRichText",
"type": "richtext"
}
]
}
}
<RichText attribute="myRichText" />
Μπορείτε να χρησιμοποιήσετε απεριόριστο αριθμό στοιχείων RichText στο μπλοκ σας.
Ιδιότητες
allowedFormats
Μπορείτε να περιορίσετε τις μορφές που επιτρέπονται στο στοιχείο RichText χρησιμοποιώντας την ιδιότητα allowedFormats.
PHP
<RichText attribute="myRichText" allowedFormats="<?php echo esc_attr(wp_json_encode(['core/bold', 'core/italic'])); ?>" />
Twig
<RichText attribute="myRichText" allowedFormats="{{ ['core/bold', 'core/italic']|json_encode|escape('html_attr') }}" />
Υπόδειγμα
Μπορείτε να ορίσετε σύμβολο κράτησης θέσης για το στοιχείο RichText χρησιμοποιώντας την ιδιότητα placeholder.
<RichText attribute="myRichText" placeholder="Enter some text" />
preserveWhiteSpace
Αν θα διατηρούνται οι χαρακτήρες κενού διαστήματος στην τιμή. Συνήθως, οι χαρακτήρες στηλοθέτη, νέας γραμμής και διαστήματος συγχωνεύονται σε ένα διάστημα. Αν ενεργοποιηθεί, οι ήπιες αλλαγές γραμμής αποθηκεύονται ως χαρακτήρες νέας γραμμής και όχι ως στοιχεία αλλαγής γραμμής.
<RichText attribute="myRichText" preserveWhiteSpace="true" />
ετικέτα
Από προεπιλογή, το περιεχόμενο RichText αποδίδεται μέσα σε στοιχείο p. Μπορείτε να το αλλάξετε αυτό χρησιμοποιώντας την ιδιότητα tag.
<RichText attribute="myRichText" tag="h1" />
withoutInteractiveFormatting
Από προεπιλογή, υπάρχουν όλα τα στοιχεία ελέγχου μορφοποίησης. Αυτή η ρύθμιση μπορεί να χρησιμοποιηθεί για την αφαίρεση στοιχείων ελέγχου μορφοποίησης που θα έκαναν το περιεχόμενο διαδραστικό.
<RichText attribute="myRichText" withoutInteractiveFormatting="true" />
Πεδία επαναλήπτη
Το RichText λειτουργεί μέσα σε πεδία επαναλήπτη. Χρησιμοποιήστε σημειογραφία αγκυλών με τον δείκτη του βρόχου για να στοχεύσετε τη σωστή γραμμή.
{
"blockstudio": {
"attributes": [
{
"id": "items",
"type": "repeater",
"attributes": [
{
"id": "heading",
"type": "richtext"
}
]
}
]
}
}
<?php foreach ($a['items'] as $index => $item) : ?>
<RichText tag="h2" attribute="items[<?php echo $index; ?>].heading" placeholder="Enter heading" />
<?php endforeach; ?>
{% for item in a.items %}
<RichText tag="h2" attribute="items[{{ loop.index0 }}].heading" placeholder="Enter heading" />
{% endfor %}
Η τιμή attribute ακολουθεί το μοτίβο repeaterId[index].fieldId, όπου το index είναι ο αριθμός της γραμμής στον βρόχο, με αρίθμηση από το μηδέν.