MediaPlaceholder
Το στοιχείο MediaPlaceholder παρέχει ένα σύμβολο κράτησης θέσης για την προσθήκη στοιχείων πολυμέσων σε ένα μπλοκ. Το ίδιο στοιχείο χρησιμοποιείται και στο μπλοκ core/image. Βασίζεται στο στοιχείο React με το ίδιο όνομα.
Βασική χρήση
Για να χρησιμοποιήσετε το MediaPlaceholder στη βασικότερη μορφή του, πρέπει να προσθέσετε το κατάλληλο γνώρισμα στο block.json σας και το στοιχείο MediaPlaceholder στο μπλοκ σας.
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/media-placeholder",
"title": "Native Block",
"category": "text",
"icon": "star-filled",
"description": "Native Blockstudio MediaPlaceholder block.",
"blockstudio": {
"attributes": [
{
"id": "media",
"type": "files"
}
]
}
}
PHP
<MediaPlaceholder attribute="media" />
<?php foreach ($a['media'] as $file) {
echo wp_get_attachment_image($file['ID']);
} ?>
Twig
<MediaPlaceholder attribute="media" />
{% for file in a.media %}
{{ fn('wp_get_attachment_image', file.ID) }}
{% endfor %}
Μόλις επιλεγεί ένα αρχείο πολυμέσων, το στοιχείο MediaPlaceholder δεν θα αποδίδεται πλέον.
Ιδιότητες
αποδοχή
Συμβολοσειρά που περνά στο FormFileUpload και ενημερώνει το πρόγραμμα περιήγησης ποιοι τύποι αρχείων μπορούν να μεταφορτωθούν στο παράθυρο μεταφόρτωσης που χρησιμοποιεί το πρόγραμμα περιήγησης e.g.: image/* ή video/*. Περισσότερες πληροφορίες για αυτή τη συμβολοσειρά υπάρχουν στην τεκμηρίωση του MDN.
allowedTypes
Πίνακας με τους τύπους πολυμέσων που μπορούν να μεταφορτωθούν ή να επιλεγούν από τη βιβλιοθήκη πολυμέσων. Κάθε τύπος είναι συμβολοσειρά που μπορεί να περιέχει τον γενικό τύπο MIME e.g.: image, audio, text ή τον πλήρη τύπο MIME e.g.: audio/mpeg, image/gif. Αν δεν έχει οριστεί το allowedTypes, επιτρέπονται όλοι οι τύποι MIME.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Αν είναι true, το στοιχείο MediaUpload ανοίγει αυτόματα το εργαλείο επιλογής της αντίστοιχης πλατφόρμας.
disableDropZone
Αν είναι true, η ζώνη απόθεσης δεν θα αποδίδεται. Οι χρήστες δεν θα μπορούν να σύρουν και να αποθέσουν πολυμέσα στο στοιχείο ή στο μπλοκ. Τα στοιχεία ελέγχου UI για μεταφόρτωση πολυμέσων από αρχείο, URL ή τη βιβλιοθήκη πολυμέσων θα παραμείνουν διαθέσιμα.
dropZoneUIOnly
Αν είναι true, θα αποδίδεται μόνο η ζώνη απόθεσης. Δεν θα εμφανίζονται στοιχεία ελέγχου UI για τη μεταφόρτωση πολυμέσων. Η ιδιότητα disableDropZone υπερισχύει της dropZoneUIOnly — αν ορίσετε και τις δύο ως true, δεν θα αποδοθεί τίποτα.
εικονίδιο
Dashicon που θα εμφανίζεται αριστερά από τον τίτλο.
isAppender
Αν είναι true, η ιδιότητα αλλάζει την εμφάνιση του συμβόλου κράτησης θέσης ώστε να είναι κατάλληλη για περιπτώσεις όπου προστίθενται νέα αρχεία σε ένα υπάρχον σύνολο αρχείων, e.g., όπως κατά την προσθήκη αρχείων σε μια συλλογή. Αν είναι false, χρησιμοποιείται το προεπιλεγμένο στυλ συμβόλου κράτησης θέσης.
disableMediaButtons
Αν είναι true, θα αποδίδεται μόνο η ζώνη απόθεσης. Δεν θα εμφανίζονται στοιχεία ελέγχου UI για τη μεταφόρτωση πολυμέσων.
ετικέτες
Αντικείμενο που μπορεί να περιέχει ιδιότητες τίτλου και οδηγιών.
PHP
<MediaPlaceholder labels="<?php echo esc_attr(wp_json_encode(['title' => 'Custom title', 'instructions' => 'Custom instructions'])); ?>" />
Twig
<MediaPlaceholder labels="{{ {title: 'Custom title', instructions: 'Custom instructions'}|json_encode|escape('html_attr') }}" />
Πεδία επαναλήπτη
Το MediaPlaceholder λειτουργεί μέσα σε πεδία επαναλήπτη. Χρησιμοποιήστε σημειογραφία αγκυλών με τον δείκτη του βρόχου για να στοχεύσετε τη σωστή γραμμή.
{
"blockstudio": {
"attributes": [
{
"id": "items",
"type": "repeater",
"attributes": [
{
"id": "image",
"type": "files"
}
]
}
]
}
}
<?php foreach ($a['items'] as $index => $item) : ?>
<MediaPlaceholder attribute="items[<?php echo $index; ?>].image" />
<?php endforeach; ?>
{% for item in a.items %}
<MediaPlaceholder attribute="items[{{ loop.index0 }}].image" />
{% endfor %}
Η τιμή attribute ακολουθεί το μοτίβο repeaterId[index].fieldId, όπου το index είναι ο αριθμός της γραμμής στον βρόχο, με αρίθμηση από το μηδέν.