Διαδραστικότητα
Το Blockstudio υποστηρίζει το WordPress Interactivity API, που παρέχει έναν τυπικό τρόπο προσθήκης αντιδραστικής συμπεριφοράς στην πλευρά του πελάτη στα μπλοκ σας. Ορίστε το interactivity στο block.json σας και το Blockstudio αναλαμβάνει τη φόρτωση του API τόσο στο frontend όσο και στον επεξεργαστή.
Διαμόρφωση
Ενεργοποιήστε το Interactivity API προσθέτοντας το interactivity στο κλειδί blockstudio του block.json σας:
{
"name": "my-theme/interactive-block",
"title": "Interactive Block",
"category": "text",
"icon": "star-filled",
"description": "A block with interactive behavior.",
"blockstudio": {
"interactivity": true
}
}
Μπορείτε επίσης να χρησιμοποιήσετε τη μορφή αντικειμένου:
{
"blockstudio": {
"interactivity": {
"enqueue": true
}
}
}
Και οι δύο μορφές είναι ισοδύναμες.
Πρότυπο
Προσθέστε οδηγίες Interactivity API στο πρότυπο μπλοκ σας. Το χαρακτηριστικό data-wp-interactive ορίζει τον χώρο ονομάτων της αποθήκης και τα υπόλοιπα χαρακτηριστικά data-wp-* ελέγχουν την αντιδραστική συμπεριφορά.
<div useBlockProps
data-wp-interactive="myBlock"
data-wp-context='{ "isOpen": false }'>
<button data-wp-on--click="actions.toggle"
data-wp-bind--aria-expanded="context.isOpen">
Toggle
</button>
<div data-wp-bind--hidden="!context.isOpen">
This content is toggled by the button.
</div>
</div>
Σενάριο
Δημιουργήστε ένα αρχείο script.js στον φάκελο του μπλοκ σας, το οποίο εισάγει στοιχεία από το @wordpress/interactivity και αρχικοποιεί την αποθήκη σας. Καλέστε το store() στο ανώτατο επίπεδο της μονάδας:
import { store, getContext } from '@wordpress/interactivity';
store('myBlock', {
actions: {
toggle: () => {
const context = getContext();
context.isOpen = !context.isOpen;
},
},
});
Το Blockstudio φορτώνει το script.js ως μονάδα ES και δημιουργεί αυτόματα τον χάρτη εισαγωγών που απαιτείται για την επίλυση του @wordpress/interactivity.
Ένα script.js χρειάζεται μόνο αν το block σας ορίζει προσαρμοσμένες ενέργειες ή callbacks. Τα blocks που χρησιμοποιούν μόνο δηλωτικές οδηγίες με data-wp-context (όπως τα data-wp-bind--hidden ή data-wp-text) λειτουργούν χωρίς JavaScript.
Κατάσταση διακομιστή
Μπορείτε να χρησιμοποιήσετε το wp_interactivity_state() στο πρότυπό σας για να αρχικοποιήσετε την κατάσταση από το PHP:
<?php
wp_interactivity_state( 'myBlock', array(
'message' => 'Hello from the server',
'count' => get_comments_number(),
) );
?>
<div useBlockProps
data-wp-interactive="myBlock">
<p data-wp-text="state.message">loading...</p>
<p data-wp-text="state.count">0</p>
</div>
Η κατάσταση διακομιστή είναι διαθέσιμη μόνο στο frontend. Το WordPress σειριοποιεί την κατάσταση σε ένα script tag JSON στην έξοδο της σελίδας, το οποίο διαβάζει το API κατά την ενυδάτωση. Στον επεξεργαστή, τα blocks αποδίδονται μέσω του REST API, επομένως τα δεδομένα κατάστασης δεν περιλαμβάνονται στην απόκριση. Χρησιμοποιήστε το data-wp-context για κατάσταση που πρέπει να λειτουργεί τόσο στον επεξεργαστή όσο και στο frontend.
Callbacks έναντι ενεργειών
Οι ενέργειες ενεργοποιούνται από αλληλεπιδράσεις του χρήστη (όπως το data-wp-on--click). Τα callbacks ενεργοποιούνται αντιδραστικά όταν αλλάζει η κατάσταση ή το περιβάλλον, μέσω της οδηγίας data-wp-watch. Μέσα στα callbacks, μπορείτε να καλέσετε το getElement() για να αποκτήσετε πρόσβαση στο υποκείμενο στοιχείο DOM:
import { store, getContext, getElement } from '@wordpress/interactivity';
store('myBlock', {
callbacks: {
updateWidth: () => {
const { ref } = getElement();
const { isOpen } = getContext();
ref.style.width = isOpen ? '100%' : '0';
},
},
});
Υποστήριξη επεξεργαστή
Το API φορτώνεται μέσα στο iframe του επεξεργαστή block, επομένως οι διαδραστικές οδηγίες λειτουργούν στις προεπισκοπήσεις του επεξεργαστή. Σε αυτές περιλαμβάνονται τα data-wp-context, data-wp-bind--*, data-wp-on--*, data-wp-text και οι προσαρμοσμένες ενέργειες store που ορίζονται στο script.js.
Δημιουργία διαδραστικών στοιχείων
Πλήρη παραδείγματα με ακορντεόν, καρτέλες, παράθυρα διαλόγου και κουμπιά «Μου αρέσει».