En küçük yararlı okuma yüzeyini seçin
Örnek yürüyüş uygulamasında kart, okuyucunun geçmiş bir kaynağı açıp açmamaya karar vermesini sağlamalıdır. Mevcut metin, kaynak bağlamı, tarih ve kullanılabilir bağlantıyla başlayın. API hazır kart modeli değil, düz kayıtlar döndürür ve seçilen her alanın bulunacağını garanti etmez. Bu kayıtlarla ekranınız arasına küçük bir uyarlayıcı kurun.
Kaynak kimliğini görünen metinden ayrı değerlendirin. Mevcutsa kayıt kimliği uygulamanın öğeyi izlemesini sağlar; başlık veya metin parçası kimliğin güvenilir karşılığı değildir. Aynı ifadeyi tartıştıkları için farklı kayıtları birleştirmeyin. Hizmet kimlik bilgilerini veya tanılama ayrıntılarını kartta göstermeden özgün veriyi uyarlayıcının kullanımında tutun.
Eksik tür veya başlığı tahmin etmeyin
Mevcut olduğunda geçerli kind değerini kullanın: post ve comment farklı etiketler gerektirir. Tür yoksa veya tanınmıyorsa nötr bir Arşiv kaydı etiketi seçin. Her bilinmeyen kaydı yorum kabul etmeyin ya da tek başına bir yorumun tüm üst tartışmayı temsil ettiğini ima etmeyin.
kind=comment, okunabilir metin, eksik başlık ve kullanılabilir kaynak bağlantısı olmayan önerilmiş bir test örneğini düşünün. Kartta Yorum ve Kaynak bağlantısı yok ifadelerinin ardından metin gösterilebilir. Üretilmiş bir başlığa veya uydurulmuş URL’ye ihtiyaç yoktur. Başka bir örnek uzun gönderi başlığı içerebilir; satır kaydırmaya veya açık bir genişletme eylemine izin verin. Bunlar test örnekleridir, arşivde bulunduğu iddia edilen kayıtlar değildir.
Metni güvenilmeyen içerik olarak işleyin
Güvenilmeyen metni arayüze eklemeden önce güvenli biçimde kaçışlayın. Anlamlı paragraf aralarını koruyun, fakat rastgele kayıt içeriğini HTML talimatları olarak değerlendirmeyin. Daha sonra Markdown desteği eklerseniz sınırlı bir görüntüleme politikası seçip test edin. Düz metin geçerli bir ilk sürümdür ve uygulanmamış biçimlendirme özelliği vaat etmez.
Kaynak bağlantısını tıklanabilir yapmadan doğrulayın; eksik veya kullanılamaz değeri eksik olarak ele alın. Dış bağlantının nereye gittiğini açıkça belirtin. Eylemler için okunabilir etiket, klavye erişimi ve mantıklı odak sırası sağlayın. Tek başına araç ipucu, eksik tarih veya bağlantıyı her okuyucuya açıklamaya yetmez.
Tarihleri ve konuşma bağlamını dürüst tutun
Kullanılabilir oluşturulma zamanı varsa anlamını ve biçimini tutarlı gösterin. Yoksa Tarih mevcut değil yazın. Üst gönderinin zamanını yoruma kopyalamayın; bu iki içerik birlikte oluşturulmuş olmak zorunda değildir. Uygulamanın kaydettiği alma tarihi, özgün tartışmanın yaşını değil verinin alınmasını anlatır.
parent_id veya link_id varsa yerel gruplama, sonuç kümenizde bulunan kayıtları bağlayabilir. Bunların varlığı eksik üst kayıtları getirmez, tam konuşmayı kurmaz veya yeni sorgu filtresi sağlamaz. Mevcut API parent_id ya da link_id filtresi sunmaz. Kart, gerçek olmayan konuşma kurmadan bağlamın eksik olduğunu belirtebilir.
Liste kontrollerini kart uyarlayıcısından ayrı tutun
Liste düzeyindeki sayfalama pagination.has_more değerini okumalı ve sayfa sınırına uymalıdır. Yalnızca pagination.relation eq veya gte diye Daha fazla göster’i açıp kapatmayın: bu ilişki devam kontrolünü değil toplamı açıklar. Alt sınır veya bilinmeyen toplam, görünen kayıtların kendisinin geçersiz olduğunu da kanıtlamaz.
Başarılı boş data dizisi hata kartına değil, listenin boş durumuna aittir; yine de bir veri alma kredisi tüketir. Önerilen test örneklerine uzun başlık, eksik metin, eksik tarih, kullanılamaz bağlantı ve bilinmeyen türü ekleyin; ardından dar ekranda düzenin davranışını inceleyin. Bunlar gelecekteki uygulamanız için kontrollerdir, rehberin yaptığı testler değildir. Kaynak yaşı ve durum tasarımı notları için /tr/#field-notes bölümüne dönün.
