ReferansBileşenler

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.

PropTürZorunluKısıtlamalar
imagesarrayEvet1 ila 12 öğe.
images[].urlstringEvetYalnızca https. Bunun dışındaki her şey sunucu tarafında doğrulamadan geçemez.
images[].altstringHayırEn fazla 160 karakter. Bunu sağlayın.
images[].captionstringHayırEn fazla 120 karakter.
images[].video_urlstringHayırYalnızca https. Rendel dışında oynatılır; görsel, posteridir.
layoutgrid | carouselHayırVarsayı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

DurumSDK'nın çizdiği
YükleniyorGö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.