Μετάβαση στο περιεχόμενο

MediaPlaceholder

Το στοιχείο MediaPlaceholder παρέχει ένα σύμβολο κράτησης θέσης για την προσθήκη στοιχείων πολυμέσων σε ένα μπλοκ. Το ίδιο στοιχείο χρησιμοποιείται και στο μπλοκ core/image. Βασίζεται στο στοιχείο React με το ίδιο όνομα.

Βασική χρήση

Για να χρησιμοποιήσετε το MediaPlaceholder στη βασικότερη μορφή του, πρέπει να προσθέσετε το κατάλληλο γνώρισμα στο block.json σας και το στοιχείο MediaPlaceholder στο μπλοκ σας.

JSON
{
  "$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

PHP
<MediaPlaceholder attribute="media" />
<?php foreach ($a['media'] as $file) {
  echo wp_get_attachment_image($file['ID']);
} ?>

Twig

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

PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />

Twig

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

PHP
<MediaPlaceholder labels="<?php echo esc_attr(wp_json_encode(['title' => 'Custom title', 'instructions' => 'Custom instructions'])); ?>" />

Twig

Twig
<MediaPlaceholder labels="{{ {title: 'Custom title', instructions: 'Custom instructions'}|json_encode|escape('html_attr') }}" />

Πεδία επαναλήπτη

Το MediaPlaceholder λειτουργεί μέσα σε πεδία επαναλήπτη. Χρησιμοποιήστε σημειογραφία αγκυλών με τον δείκτη του βρόχου για να στοχεύσετε τη σωστή γραμμή.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "items",
        "type": "repeater",
        "attributes": [
          {
            "id": "image",
            "type": "files"
          }
        ]
      }
    ]
  }
}
PHP
<?php foreach ($a['items'] as $index => $item) : ?>
  <MediaPlaceholder attribute="items[<?php echo $index; ?>].image" />
<?php endforeach; ?>
Twig
{% for item in a.items %}
  <MediaPlaceholder attribute="items[{{ loop.index0 }}].image" />
{% endfor %}

Η τιμή attribute ακολουθεί το μοτίβο repeaterId[index].fieldId, όπου το index είναι ο αριθμός της γραμμής στον βρόχο, με αρίθμηση από το μηδέν.