ReferansBileşenler

info_card

İkon, başlık, gövde ve isteğe bağlı bir aksiyon.

İşin yükünü çeken temel bileşen. info_card, üzerinde bir başlık taşıyan tek bir bilgidir: bir ilke, bir durum, bir yönlendirme parçası; isteğe bağlı olarak bununla ilgili yapılabilecek tek bir aksiyonla birlikte.

Cevap bir liste yerine tek bir fikir olduğunda ve bu fikir düz metin içinde durmak yerine çerçevelenmiş bir alanı hak ettiğinde bunu tercih edin.

30 gün içinde ücretsiz iadeOrijinal kutusundaki kullanılmamış ayakkabılar herhangi bir teslim noktasından iade edilebilir.
İade başlat

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ılmaz

Üç tanesini üst üste dizmeyin. Arka arkaya üç bilgi kartı, parçalara ayrılmış bir item_list demektir.

Durumla ilgili geçici bir bildirim için (“promosyon uygulandı”, “stok az”) bunu kullanmayın; bu tür durumlar için status_banner kullanılır: banner araya girer, kart ise kaydeder. Bir kart, actions içinde en fazla üç buton taşıyabilir; bunlardan herhangi biri olduğunda cta çizilmez. Tek bir kart yerine cevabın geneline yönelik butonlar ise bir actions bloğudur.

Kişiler ve belgeler

avatar_url, ikon yerine bir kişiyi (bir kurye, bir doktor) yuvarlak olarak çizer. file_type (pdf, csv, image, doc), ikonun yerine bir belge rozeti çizer. meta, başlığın altında göze çarpmayan tek bir satırdır: “PDF · 120 KB · Eylül 2026”, “Beyaz Egea · 34 ABC 123”. Flutter 0.40.0 ve Web 0.17.0 sürümlerinden beri.

Props

Her blok ayrıca type ve 1 ila 300 karakterden oluşan zorunlu bir fallback_text taşır.

PropTürZorunluKısıtlamalar
iconstringHayırEn fazla 40 karakter. Aşağıda listelenen 32 addan oluşan kapalı kümeden biri. Bilinmeyen bir ad hiçbir glif çizmez.
titlestringEvet1 ila 120 karakter.
bodystringHayırEn fazla 600 karakter.
ctaobjectHayırYok
cta.labelstringEvet1 ila 60 karakter.
cta.actionactionEvet{ kind: "reply", text } veya { kind: "open_url", url } veya { kind: "navigate", route } veya { kind: "call", phone } veya { kind: "copy", text } veya { kind: "add_to_calendar", title, starts_at }. Bkz. Actions.
avatar_urlstringHayırYok
metastringHayırEn fazla 80 karakter.
file_typepdf | csv | image | docHayırYok
actionsarrayHayır1 ila 3 öğe.
actions[].labelstringEvet1 ila 40 karakter.
actions[].iconstringHayırEn fazla 40 karakter.
actions[].actionactionEvet{ kind: "reply", text } veya { kind: "open_url", url } veya { kind: "navigate", route } veya { kind: "call", phone } veya { kind: "copy", text } veya { kind: "add_to_calendar", title, starts_at }. Bkz. Actions.

Ağ formatı

{
  "id": "blk_02",
  "type": "info_card",
  "fallback_text": "Free returns within 30 days.",
  "props": {
    "icon": "truck",
    "title": "Free returns within 30 days",
    "body": "Unworn shoes in the original box can go back at any pickup point. Refunds land 3 to 5 days after the parcel is scanned.",
    "cta": {
      "label": "Start a return",
      "action": {
        "kind": "reply",
        "text": "Start a return for order 1042"
      }
    }
  }
}

Etkileşim

CTA veya actions içindeki her bir öge, yapının tanımladığı herhangi bir türde olabilecek aksiyonunu tetikler (reply, open_url, navigate, call, copy, add_to_calendar); bkz. Actions. Kartın kendisine dokunulamaz; bu nedenle cta içermeyen bir kart, ekran okuyucuya yapamayacağı hiçbir şeyi duyurmaz.

Durumlar

DurumSDK'nın çizdiği içerik
YükleniyorKartın kendi oranlarında bir glif yer tutucusu, bir başlık çubuğu ve iki gövde satırına sahip bir plaka.
İkon yokBaşlık sol kenara kayar. Gelmeyecek bir glif için hiçbir yer ayrılmaz.
Bilinmeyen ikonGlif atlanır ve kart normal şekilde render edilir. Asla genel bir kareye dönüşmez.

Erişilebilirlik

fallback_text, başlık ya da başlıkla birlikte gövdenin ilk cümlesi olmalıdır. İkon dekoratiftir ve seslendirilmez; CTA kendi etiketini seslendirir.

İkon adları

icon yalnızca bunları kabul eder, başka hiçbir şeyi kabul etmez. Küme bilerek kapalı tutulmuştur: açık bir küme, modelin bir isim tahmin etmesi ve kartın glifini sessizce kaybetmesi anlamına gelir.

info · check · warning · error · order · package · truck · calendar · clock · card
wallet · tag · gift · star · heart · user · settings · search · location · phone
mail · lock · refresh · download · link · bag · ticket · chart · document · person
map_pin · search_off