media_gallery
Bir görsel ızgarası veya karusel.
Görseller, yanıtın kendisi görseller olduğunda kullanılır. media_gallery, bir ila on iki https görseli alır ve bunları bir ızgara veya karusel olarak yerleştirir.
Izgara, bir görselin bulunması gereken yerde boşluk bırakmak yerine son satırını doldurur; böylece beş görsel, üç artı iki yerine bütünlüklü tek bir blok olarak görünür.
Bir görsel, altında bir caption ve bir video_url taşıyabilir (Flutter 0.44.0, Web 0.21.0).
Ekran görüntüsü değildir; tarayıcınızda SDK'nın kendi boyut ve renkleriyle canlı olarak çizilir.
Flutter SDK ve Web SDK ile, her ikisi de 0.1.0 sürümünden itibaren yerel olarak render edilir.
Ne zaman kullanılmamalı
Fiyatı olan tek bir ürün çekimi için bunu kullanmayın. Görseli bir bağlama oturtan bileşen product_cards bileşenidir.
Ayrıntıların üzerinde bir hero görseli olarak da kullanmayın. Altında bir başlık, saat ve konum bulunan bir görsel booking_card bileşenidir.
Props
Her blok ayrıca type ve 1 ila 300 karakterden oluşan zorunlu bir fallback_text taşır.
| Prop | Tür | Zorunlu | Kısıtlamalar |
|---|---|---|---|
images | array | Evet | 1 ila 12 öğe. |
images[].url | string | Evet | Yalnızca https. Bunun dışındaki her şey sunucu tarafında doğrulamadan geçemez. |
images[].alt | string | Hayır | En fazla 160 karakter. Bunu sağlayın. |
images[].caption | string | Hayır | En fazla 120 karakter. |
images[].video_url | string | Hayır | Yalnızca https. Rendel dışında oynatılır; görsel, posteridir. |
layout | grid | carousel | Hayır | Varsayılan olarak grid değerini alır. |
Ağ üzerinde
{
"id": "blk_16",
"type": "media_gallery",
"fallback_text": "Five photographs of the Aero Glide 2.",
"props": {
"layout": "grid",
"images": [
{
"url": "https://cdn.example.com/aero-side.jpg",
"alt": "Aero Glide 2 from the side"
},
{
"url": "https://cdn.example.com/aero-sole.jpg",
"alt": "The outsole tread pattern"
},
{
"url": "https://cdn.example.com/aero-heel.jpg",
"alt": "Reflective heel counter"
}
]
}
}Etkileşim
video_url içeren bir görsel, o videonun posteridir: dokunulduğunda Rendel dışında, platformun oynatıcısında veya yeni bir sekmede oynatılır. Web'de diğer tüm görseller yeni bir sekmede tam boyutta açılır; Flutter SDK'da ise dokunulabilir değildir. Lightbox yoktur. Karusel yatay olarak kayar.
Durumlar
| Durum | SDK'nın çizdiği |
|---|---|
| Yükleniyor | Görseller çözümlenirken nefes alan kutucuk biçimli yer tutucular; ardından her kare sert bir kesinti yerine yavaşça belirir. |
| Boş | Boş bir images dizisi, fallback_text değerini bir plaka olmadan, yalın halde render eder. |
| Bozuk görsel | İlgili kutucuk, bozuk görsel simgesi içeren içe gömük bir dikdörtgen barındırır. Galerinin geri kalanı bundan etkilenmez. |
Erişilebilirlik
alt, görselin erişilebilir adıdır ve doğrudan ekran okuyucuya ulaşır. Bu değer olmadan bir görsel, açıklama yerine bir konum belirten “Image 3 of 5” ifadesine döner. alt değerini sağlayın.
fallback_text, setin ne gösterdiğini ve kaç adet olduğunu belirtmelidir.




