article_card
Kaynağı belirtilmiş şekilde getirilen bir pasaj.
Yanıt politikanın kendisidir. article_card, Rendel'in getirdiği pasajı gösterir ve nereden geldiğini belirtir.
Düz metinde temellendirilmiş bir yanıt ile kendinden emin bir yanıt tamamen aynı göründüğü için vardır. Aradaki fark kaynak satırıdır ve modelin iyi niyetinde kalmak yerine ekranda yer almalıdır.
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ı
Bir özetin daha iyi hizmet ettiği durumlarda kullanmayın: kelimesi kelimesine ifade önem taşımıyorsa, text ile yanıt verin ve sırayı kısa tutun.
Getirmediğiniz bir şey için kullanmayın. Hiç okunmamış adı geçen bir kaynak, hiç kaynak olmamasından daha kötüdür; çünkü bir tahmini alıntıya dönüştürür.
Props
Her blok ayrıca type ve 1 ila 300 karakter uzunluğunda zorunlu bir fallback_text taşır.
| Prop | Tür | Zorunlu | Kısıtlamalar |
|---|---|---|---|
title | string | Evet | 1 ila 120 karakter. |
excerpt | string | Evet | 1 ila 400 karakter. |
source | string | Evet | 1 ila 80 karakter. Geldiği Knowledge kaynağı. |
updated | string | Hayır | En fazla 40 karakter. |
cta | object | Hayır | Genellikle belgenin tamamına yönlendiren bir open_url. |
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. |
Ağ aktarımı
{
"id": "blk_23",
"type": "article_card",
"fallback_text": "Unworn shoes can be returned within 30 days, from the shipping and returns FAQ.",
"props": {
"title": "Returns policy",
"excerpt": "Unworn shoes can be returned within 30 days for a full refund. Refunds land within 5 business days after the return is received.",
"source": "Shipping & returns FAQ",
"updated": "Updated 4 Aug"
}
}Etkileşim
Yalnızca isteğe bağlı cta. Kartın kendisi salt göstergedir.
Durumlar
| Durum | SDK'nın çizdiği içerik |
|---|---|
| Loading | Gerçek yüksekliklerinde bir başlık satırı, iki alıntı satırı ve CTA buton şekli. |
| Long excerpt | Tamamen alt satıra kayar; kart bir politikayı cümlenin ortasında kesmek yerine genişler. |
| No source | Doğrulamadan geçemez. source, tam da bu bloğun kaynaksız kalamaması için zorunludur. |
Erişilebilirlik
Kaynak, ince bir çizginin ardında yer alır ve alıntıdan sonra seslendirilir; böylece bir ekran okuyucu önce iddiayı, ardından nereden geldiğini duyar. Açık renkli bir yüzeyde vurgu rengindeki gövde metni kontrastı 3,3:1 olduğundan, vurgu rengi yerine etiket font kalınlığında ayarlanmıştır.
fallback_text hem yanıtı hem de kaynağı taşımalıdır.