MediaPlaceholder
Komponentti MediaPlaceholder tarjoaa paikkamerkin mediakohteiden lisäämiseen lohkoon. Samaa komponenttia käytetään lohkossa core/image. Se perustuu samannimiseen komponenttiin React .
Peruskäyttö
Jotta voit käyttää MediaPlaceholder-komponenttia yksinkertaisimmillaan, lisää sopiva attribuutti komponenttiisi block.json ja lisää lohkoosi komponentti 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 %}
Kun mediatiedosto on valittu, komponenttia MediaPlaceholder ei enää renderöidä.
Ominaisuudet
accept
FormFileUpload-komponentille välitettävä merkkijono, joka kertoo selaimelle, minkä tyyppiset tiedostot voidaan ladata selainikkunaan e.g.image/* tai video/*. Lisätietoja tästä merkkijonosta on MDN:n dokumentaatiossa.
allowedTypes
Taulukko mediatyypeistä, joita voi ladata tai valita mediakirjastosta. Kukin tyyppi on merkkijono, joka voi sisältää yleisen MIME-tyypin e.g: image, audio, text tai täydellisen MIME-tyypin e.g: audio/mpeg, image/gif. Jos allowedTypes-arvoa ei ole asetettu, kaikki MIME-tyypit sallitaan.
PHP
<MediaPlaceholder allowedTypes="<?php echo esc_attr(wp_json_encode(['image', 'video'])); ?>" />
Twig
<MediaPlaceholder allowedTypes="{{ ['image', 'video']|json_encode|escape('html_attr') }}" />
autoOpenMediaUpload
Jos arvo on true, MediaUpload-komponentti avaa automaattisesti kyseisen alustan valitsimen.
disableDropZone
Jos arvo on true, pudotusaluetta ei renderöidä. Käyttäjät eivät voi vetää ja pudottaa mediaa komponenttiin tai lohkoon. UI-ohjaimet median lataamiseen tiedostosta, URL-osoitteesta tai mediakirjastosta säilyvät käytettävissä.
dropZoneUIOnly
Jos arvo on true, renderöidään vain pudotusalue. Median lataamiseen tarkoitettuja UI-ohjaimia ei näytetä. Ominaisuus disableDropZone menee silti ominaisuuden dropZoneUIOnly edelle: jos molemmat ovat true, mitään ei renderöidä.
icon
Otsikon vasemmalla puolella näytettävä Dashicon-kuvake.
isAppender
Jos arvo on true, tämä ominaisuus muuttaa paikkamerkin ulkoasun tilanteisiin sopivaksi, joissa uusia tiedostoja lisätään jo olemassa olevaan tiedostokokoelmaan, e.g. kuten galleriaan. Jos arvo on false, käytetään paikkamerkin oletustyyliä.
disableMediaButtons
Jos arvo on true, renderöidään vain pudotusalue. Median lataamiseen tarkoitettuja UI-ohjaimia ei näytetä.
labels
Objekti, joka voi sisältää title- ja instructions-ominaisuudet.
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') }}" />
Toistinkentät
MediaPlaceholder toimii toistinkenttien sisällä. Käytä hakasuljenotaatiota ja silmukan indeksiä oikean rivin kohdistamiseen.
{
"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 %}
Arvo attribute noudattaa kaavaa repeaterId[index].fieldId, jossa index on silmukan nollasta alkava rivinumero.