useBlockProps
Από προεπιλογή, το Gutenberg δημιουργεί περίβλημα γύρω από τα μπλοκ, ώστε να είναι διαδραστικά μέσα στον επεξεργαστή. Αυτό μπορεί να δημιουργήσει προβλήματα σε ορισμένους τύπους μπλοκ, όπως οι περιέκτες ή οι στήλες, επειδή η σήμανση διαφέρει μεταξύ επεξεργαστή και frontend. Το hook useBlockProps επιτρέπει να ορίσετε ένα στοιχείο μέσα στο πρότυπο του μπλοκ ως ριζικό στοιχείο, διατηρώντας έτσι την ίδια σήμανση στον επεξεργαστή και στο frontend.
Χρήση
Προσθέστε απλώς το γνώρισμα useBlockProps στο ριζικό στοιχείο του μπλοκ σας.
<div useBlockProps class="my-class">
<!--
This element will be rendered
as the root element of your block
in Gutenberg.
-->
</div>
Το Blockstudio συνδυάζει αυτόματα τις κλάσεις και τα γνωρίσματα του επεξεργαστή (όπως οι κλάσεις στοίχισης) με όσα έχουν οριστεί στα πρότυπα των μπλοκ. Για τον σκοπό αυτό χρησιμοποιείται στο παρασκήνιο το get_block_wrapper_attributes.
Το φίλτρο blockstudio/blocks/components/use_block_props/render εφαρμόζεται στο περίβλημα τόσο στη διαδρομή απόδοσης του frontend όσο και του επεξεργαστή. Έτσι, οι κλάσεις που προστίθενται από ένα θέμα ή μια ενσωμάτωση ανά στιγμιότυπο εμφανίζονται τόσο στον καμβά του επεξεργαστή όσο και στη σήμανση που αποθηκεύεται για το frontend.
Αποτέλεσμα:
<div class="my-class wp-block-your-block-name alignright">
</div>
Σημεία που πρέπει να λάβετε υπόψη
Σύνδεσμοι στον επεξεργαστή
Το Blockstudio αποτρέπει την πλοήγηση μέσω συνδέσμων μέσα στον επεξεργαστή block, συμπεριλαμβανομένων των target="_blank", των κλικ με τροποποιητικό πλήκτρο, των μεσαίων κλικ και της ενεργοποίησης μέσω πληκτρολογίου.
Τα συμβάντα κλικ εξακολουθούν να φτάνουν στο Gutenberg, επομένως τα συνηθισμένα κλικ επιλέγουν το block.
Το RichText παραμένει επεξεργάσιμο. Αυτό ισχύει είτε υπάρχει είτε όχι useBlockProps, ακόμη κι αν χρησιμοποιείται άγκυρα ως ριζικό στοιχείο του block.
Οι σύνδεσμοι στο frontend και οι εντολές του μενού περιβάλλοντος του προγράμματος περιήγησης παραμένουν ως έχουν. Δεν χρειάζεται να αφαιρέσετε συνδέσμους από τα πρότυπα ή να κάνετε διακλάδωση με βάση το $isEditor.
Ριζικό στοιχείο
Καθώς ένα πρότυπο μπλοκ μπορεί να έχει μόνο ένα ριζικό στοιχείο, όταν χρησιμοποιείτε το useBlockProps το πρότυπο πρέπει να έχει ένα μόνο ριζικό στοιχείο. Για παράδειγμα, το παρακάτω δεν θα λειτουργήσει και το Gutenberg θα δημιουργήσει περίβλημα γύρω από το πρότυπο.
<div useBlockProps>
First root element.
</div>
<span>
Second root element.
</span>
Το useBlockProps μπορεί επίσης να χρησιμοποιηθεί μόνο μία φορά ανά πρότυπο μπλοκ.
Το σύμβολο @
Το Blockstudio μετατρέπει το πρότυπο του μπλοκ σε έγκυρο κώδικα React μέσα στο Gutenberg, χρησιμοποιώντας το html-react-parser. Αυτός ο περιορισμός σημαίνει ότι ο χαρακτήρας @ δεν μπορεί να χρησιμοποιηθεί μέσα σε όνομα γνωρίσματος HTML.
Βιβλιοθήκες όπως η Alpine.js χρησιμοποιούν τον χαρακτήρα @ για να ορίζουν οδηγίες σε στοιχεία HTML.
<button useBlockProps @click="console.log('hi')">
Click me
</button>
Μέσα στο Gutenberg, αυτό το γνώρισμα @click αφαιρείται από το στοιχείο (φυσικά, εξακολουθεί να λειτουργεί στο frontend).
Για να αντιμετωπίσετε αυτό το πρόβλημα, μπορείτε να χρησιμοποιήσετε την εναλλακτική σύνταξη που παρέχει το Alpine.js.
<button useBlockProps x-on:click="console.log('hi')">
Click me
</button>
Το παραπάνω θα λειτουργήσει μέσα στο Gutenberg και στο frontend.
Κλάσεις body στον καμβά
Όταν είναι ενεργό το assets.reset.enabled, το Blockstudio αντιγράφει επίσης στον καμβά του επεξεργαστή τις απολυμασμένες κλάσεις που επιστρέφει το φίλτρο body_class του WordPress. Έτσι, οι επιλογείς του θέματος, όπως το .brand-a .site-card, λειτουργούν και στα δύο σημεία.
Φιλτράρετε την τελική λίστα κλάσεων όταν ο επεξεργαστής χρειάζεται ένα πιο περιορισμένο σύνολο:
add_filter('blockstudio/editor/canvas/body_class', function(array $classes) {
return array_values(array_diff($classes, ['logged-in']));
});
Αυτό το φίλτρο ελέγχει μόνο τις κλάσεις που αντιγράφονται στον καμβά του επεξεργαστή. Δεν αλλάζει τις κλάσεις body του frontend.