Multivide
Tēmas attēli atrodas ārpus multivides bibliotēkas, tāpēc WordPress nezina to izmērus un katrs neformatētais attēls ielādes laikā izkustina izkārtojumu. Blockstudio novērš šo problēmu ar ģenerētu metadatu manifestu, veidnes palīgfunkciju, kas vienmēr norāda faktiskos izmērus, un neobligātu slinko ielādētāju.
Attēlu renderēšana
bs_media_image() renderē tēmas resursus ar faktisko platumu un augstumu, kā arī rezervētu malu attiecību:
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'class' => 'hero-media',
'sources' => [
['srcset' => '/hero-small.webp', 'media' => '(max-width: 640px)'],
],
]);
?>
Rezultāts ir figure.blockstudio-media ar iekļautu aspect-ratio ap img, kam norādītas faktiskās width, height, loading un decoding vērtības.
src pieņem ar tēmu saistītu relatīvu ceļu, absolūtu ceļu vai pilnu URL, bet attachmentId — multivides bibliotēkas attēlus. eager atspējo slinko ielādi virs pirmā ekrāna, savukārt sources izvada <picture> elementu ar norādītajiem alternatīvajiem variantiem.
Ja metadati ir pieejami, palīgfunkcija vienmēr izvada zināmās platuma, augstuma un malu attiecības vērtības. Slinkās ielādes režīmā tiek izmantotas tikai blockstudio-* klases, atribūti, identifikatori un globālie objekti.
Metadatu manifests
Izmēri tiek iegūti no assets/media.json, ko būvēšanas darbībā ieraksta Blockstudio\Media_Metadata_Builder vai pievieno manuāli:
use Blockstudio\Media_Metadata_Builder;
(new Media_Metadata_Builder())->write(
get_stylesheet_directory(),
true
);
Tiek ierakstīti noteikti tēmas resursu metadati un, ja norādīts otrais arguments, arī izvēles WordPress pielikumu metadati. Ģenerējiet tos no jauna ikreiz, kad tiek mainīti faili zem assets/.
Media_Metadata_Builder::build( string $root ) atgriež manifestu, to neierakstot; write() ir variants, kas to saglabā. Blockstudio\Media_Metadata::reset() pēc atkārtotas ģenerēšanas iztīra procesa kešatmiņu. Ilgstoši darbojošos būvēšanas procesiem tas jādara pirms renderēšanas ar atjauninātiem metadatiem.
Slinkā ielāde
performance.media iestatījumi vada priekšgala ielādētāju:
{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}
Ja ir ieslēgts lazy, īstais URL tiek pārvietots uz data-src aiz pareiza izmēra viettura, un krustpunkta noteikšanā balstītais Blockstudio ielādētājs to ievieto, kad attēls tuvojas skatvietai, savukārt rootMargin tas tiek sagatavots iepriekš. skeleton parāda iebūvēto ielādes vietturi, un metadata norāda, ka tiek izmantots assets/media.json.
Profili speed un strict veiktspējas profili pēc noklusējuma iespējo ielādētāju; compat to atstāj izslēgtu. Katra bērnelementa vērtība var pārrakstīt profila noklusējumu.
Pilna
performance.mediaopciju tabula.
Statiskā iepriekšējā renderēšana
Multivides metadati ir otrais solis produkcijas vides ieviešanas secībā.