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.
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.
| Prop | Tür | Zorunlu | Kısıtlamalar |
|---|---|---|---|
icon | string | Hayır | En fazla 40 karakter. Aşağıda listelenen 32 addan oluşan kapalı kümeden biri. Bilinmeyen bir ad hiçbir glif çizmez. |
title | string | Evet | 1 ila 120 karakter. |
body | string | Hayır | En fazla 600 karakter. |
cta | object | Hayır | Yok |
cta.label | string | Evet | 1 ila 60 karakter. |
cta.action | action | Evet | { 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_url | string | Hayır | Yok |
meta | string | Hayır | En fazla 80 karakter. |
file_type | pdf | csv | image | doc | Hayır | Yok |
actions | array | Hayır | 1 ila 3 öğe. |
actions[].label | string | Evet | 1 ila 40 karakter. |
actions[].icon | string | Hayır | En fazla 40 karakter. |
actions[].action | action | Evet | { 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
| Durum | SDK'nın çizdiği içerik |
|---|---|
| Yükleniyor | Kartı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 yok | Başlık sol kenara kayar. Gelmeyecek bir glif için hiçbir yer ayrılmaz. |
| Bilinmeyen ikon | Glif 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