Bir belge görüntüleyici teknik olarak işlevsel olabilir ancak dar bir ekranda kullanılamaz hissi verebilir. Yoğun araç çubukları, çok küçük denetimler, aşırı büyük yan paneller ve sabit boyutlu kapsayıcılar, basit bir ön izlemeyi hızla sinir bozucu bir deneyime dönüştürür.

Windows tabanlı ASP.NET ve .NET uygulamaları için, Doconut iş belgeleri, PDF dosyaları, CAD çizimleri, e-posta dosyaları ve görseller için gömülü bir belge görüntüleme SDK'sı sunar. Uygulamanız hâlâ çevre düzenini, kimlik doğrulamayı, yetkilendirmeyi, depolamayı ve belge iş akışını kontrol eder.

Bu kılavuz, gömülü görüntüleyiciye yeterli alan sağlama, uygulama denetimlerini rahat kullanılabilir kılma, yönelim değişikliklerini yönetme ve doğrulanmamış SDK kaynak koduna güvenmeden gerçekçi belgeleri test etme konularına odaklanır.

Bir .NET sunucu tarafı bileşenine bağlanan duyarlı belge görüntüleme düzenleri

Görüntüleyicinin Dışında Duyarlı Tasarım Başlar

Görüntüleyici yalnızca ebeveyn düzeninin sağladığı alanı kullanabilir. Uygulama görüntüleyiciyi dar bir kartın içine yerleştirirse, sabit bir masaüstü genişliği verir veya birden çok kalıcı panelle çevrelerse, belge alanı sıkışık kalır.

Üç soruyla başlayın:

Bu sayfada birincil görev nedir?
Okurken hangi uygulama denetimleri görünür kalmalı?
Hangi ikincil paneller çökebilir veya bir düğmenin arkasına taşınabilir?

Özel bir belge sayfası için, görüntüleyici genellikle baskın öğe olmalıdır. Üst veri, yorumlar, onaylar ve iş akışı eylemleri, belgeye kalıcı alan ayırmadan kullanılabilir kalabilir.

Düzeni Mevcut Alana Göre Planlayın

Duyarlı davranış, bileşenin mevcut alanına göre şekillenmelidir; belirli bir cihaz adı varsayımına göre değil.

Geniş düzen

Geniş bir görünümde sayfa şu şekilde görünebilir:

Bir belge küçük resmi veya gezinme paneli
Ana belge kanvası
Yorumlar veya üst veri için ikincil iş akışı paneli
Tam bir uygulama eylem seti

İkincil panel bir çekmece haline geldiğinde, tasarım sisteminizin gerektirdiği iletişim kutusu davranışı, odak yönetimi ve erişilebilir etiketlemeyi ekleyin.

Uygulama Denetimlerini Dokunmatik Dostu Hale Getirin

Görüntüleyicinin etrafındaki denetimler, hassas işaretçi hareketi gerektirmeden rahatça etkinleştirilebilmelidir.

Pratik yönergeler şunları içerir:

Etkileşimli denetimlere yaklaşık 44 × 44 CSS piksel hedef alanı verin.
Yıkıcı ve sık kullanılan eylemler arasında yeterli boşluk bırakın.
Temel bilgileri ortaya çıkarmak için fareyle üzerine gelmeye (hover) güvenmeyin.
Klavye kullanıcıları için odak göstergelerini görünür tutun.
Yalnızca simge içeren düğmelere erişilebilir adlar sağlayın.
Kritik denetimleri tarayıcı veya sistem jest alanlarına yakın konumlandırmaktan kaçının.

Doconut’un dahili stillerini tahmini seçiciler veya belgelenmemiş CSS değişkenleriyle geçersiz kılmayın. Yüklü SDK sürümü için resmi kaynakları kullanın ve duyarlı kurallarınızı yalnızca uygulamaya ait kapsayıcılara ve denetimlere uygulayın.

Yan Panelleri İsteğe Bağlı Çalışma Alanı Olarak Davranın

Küçük resimler, arama sonuçları, açıklamalar, üst veri ve iş akışı geçmişi değerlidir, ancak hepsi aynı anda belgeyle rekabet etmemelidir.

Kompakt düzenlerde:

Yan paneli yalnızca kullanıcı talep ettiğinde açın.
Kapatıldıktan sonra odağı paneli açan düğmeye geri gönderin.
Gerektiğinde modal panellerde odağı yakalayın.
Panele net bir başlık ve kapatma eylemi verin.
Panel açıldığında veya kapandığında belgenin mevcut konumunu koruyun.

Görüntüleyici kendi panellerini sağlıyorsa, ikinci bir uygulama‑seviyesi gezinme sistemi eklemeden önce belgelenmiş duyarlı davranışlarını test edin.

Belge Çalışma Alanını Hızlı Tutun

Duyarlı tasarım sadece görsel değildir. Büyük belgeler, özellikle sayfa aynı zamanda karmaşık panolar veya animasyonlar içeriyorsa, bellek, bant genişliği ve render kısıtlamalarını ortaya çıkarabilir.

Rekabet eden işleri azaltın

Kullanıcı okurken süsleme animasyonlarını duraklatın, görüntüleyici etrafında maliyetli efektlerden kaçının ve gereksiz gözlemcileri veya olay dinleyicileri kaldırın.

Düzen alanını ayırın

Görüntüleyicinin barındırıldığı kapsayıcıya, yüklemeden önce sabit bir yükseklik verin. Bu, büyük düzen kaymalarını önler ve kullanıcıların yanlış denetime dokunma olasılığını azaltır.

İkincil özellikleri bilinçli yükleyin

Yorumlar, denetim geçmişi ve büyük üst veri panelleri her zaman ilk belge sayfasıyla birlikte yüklenmemelidir. Kullanıcı ilgili paneli açana kadar bunları erteleyin; bu, iş akışınıza uygun bir yaklaşımdır.

Temsilci dosyaları test edin

Uzun PDF’ler, geniş elektronik tablolar, ayrıntılı CAD çizimleri, büyük görseller ve alışılmadık yazı tiplerine sahip belgeler kullanın. Küçük bir örnek dosya, üretim deneyiminin sınırlarını gösteremez.

Erişim Kontrolünü Sunucuda Tutun

Duyarlı sunum, uygulamanın güvenlik sorumluluklarını değiştirmez. Her belge isteği hâlâ kimlik doğrulama ve belge‑özel yetkilendirme üzerinden geçmelidir.

ASP.NET Core uygulamaları için, kimlik doğrulama ara katmanı, politikalar, talepler, [Authorize] özniteliği ve kaynak‑tabanlı yetkilendirme gibi standart mekanizmalar, belgeyi çözen sunucu yolunu koruyabilir.

Uygulama şunları yapmalıdır:

Sunucu tarafından oluşturulan belge tanımlayıcılarını kullanın.
Mevcut kullanıcının istenen belgeye erişebileceğini doğrulayın.
Depolama kimlik bilgilerini ve sınırsız yolları istemciden uzak tutun.
Görüntüleyici sayfasında gösterilen hataları temizleyin.
Orijinal ve geçici dosyalar için açık saklama kuralları uygulayın.
Belge içeriğini, gizli anahtarları veya hassas erişim URL’lerini loglamaktan kaçının.

İndirme, yazdırma veya bağlam menüsü eylemlerini gizlemek, amaçlanan iş akışını destekleyebilir, ancak sunucu‑tarafı yetkilendirmeyi yerine geçmez ve içeriğin görünür olduğu anda her türlü yakalamayı önleyemez.

Doconut’u Duyarlı Deneyime Entegre Etmek

Doconut gömülü belge görüntüleme katmanını sağlar, uygulama ise duyarlı kabuk ve iş akışını sunar.

Mantıklı bir uygulama sırası şunlardır:

Gerekli formatları ve görüntüleyici özelliklerini doğrulayın.
.NET uygulamanız için desteklenen Doconut paketini entegre edin.
Belge çözümlemesini sunucu‑tarafı yetkilendirme ile koruyun.
Görüntüleyiciyi akışkan, uygulamaya ait bir barındırıcı kapsayıcıya yerleştirin.
Uygulama araç çubukları ve ikincil paneller için kompakt durumlar tasarlayın.
Yeniden boyutlandırma, yönelim, odak, yükleme ve hata davranışlarını test edin.
Sonucu üretim‑benzeri belgeler ve eşzamanlı oturumlarla doğrulayın.

Güncel ürün bilgileri için doğrulanmış Doconut Viewer ürün sayfası adresine bakın. Sürüm‑özel kurulum ve entegrasyon talimatları için resmi indirme ve dokümantasyon sayfası kullanılmalı; üçüncü‑taraf gönderilerinden belgelenmemiş SDK örneklerini kopyalamaktan kaçının.

Duyarlı Görüntüleyici İnceleme Kontrol Listesi

Düzen

Görüntüleyici, sayfanın en büyük faydalı kısmını alır.
Sabit genişlikler yatay kaydırmayı zorlamaz.
İkincil paneller sorunsuz çökebilir.
Görünüm yüksekliği sınırlı olduğunda düzen kullanılabilir kalır.
Yükleme ve hata durumları uygun alanı ayırır.

Etkileşim

Uygulama denetimlerinin rahat hedef boyutları vardır.
Temel eylemler fareyle üzerine gelmeye (hover) dayanmaz.
Yalnızca simge denetimlerinin erişilebilir adları vardır.
Odak görünür kalır ve mantıklı bir sırayı izler.
Çekmeceler ve iletişim kutuları odaklamayı doğru geri verir.

Belgeler

Büyük PDF’ler gezilebilir kalır.
Geniş elektronik tablolar sayfa düzenini bozmadan incelenebilir.
Ayrıntılı çizimler kullanılabilir yakınlaştırma ve kaydırma alanını korur.
Uzun dosya adları ve hata mesajları taşmaz.
Düzen boyutu değişikliği belgeyi gereksiz yere yeniden başlatmaz.

Güvenlik ve operasyonlar

Sunucu her belge isteğini yetkilendirir.
Depolama ayrıntıları gizli kalır.
Dosya ve geçici veri saklama politikaları belgelenir.
Hatalar ve loglar hassas bilgi içermez.
Kaynak sınırları ve eşzamanlı oturum davranışları test edilir.

Yaygın Sorular

Uygulama, telefonlar ve masaüstü için ayrı görüntüleyici sayfaları tutmalı mı?

Genellikle hayır. Tek bir duyarlı sayfa bakımı daha kolaydır. Mevcut alana göre düzeni değiştirin ve ikincil denetimleri kademeli olarak ortaya çıkarın.

Uygulama, görüntüleyicinin dahili CSS’ini geçersiz kılabilir mi?

Belgelenmemiş seçiciler ve değişkenlerden kaçının. Barındırıcı kapsayıcıyı ve kendi uygulama denetimlerinizi stillendirin. Yalnızca dağıttığınız Doconut sürümü için belgelenen özelleştirme noktalarını kullanın.

İndirme ve yazdırma düğmeleri kompakt düzenlerde gizlenmeli mi?

Bu bir ürün kararıdır, güvenlik sınırı değildir. Bir eylem izinli ama alana sığmıyorsa, erişilebilir bir taşma menüsüne koyun. İzinli değilse, bu politikayı sunucuda zorlayın.

Büyük belgeler nasıl test edilmeli?

Gerçek sayfa sayısı, dosya boyutu, yazı tipleri, çizimler ve elektronik tabloları yansıtan temizlenmiş bir test koleksiyonu oluşturun. SDK, .NET, Windows Server veya düzen değişikliklerinden sonra paketi tekrarlayın.

Sonuç

Güçlü bir mobil belge deneyimi, akışkan bir kapsayıcı, belge‑öncelikli bir düzen, rahat denetimler, isteğe bağlı yan paneller, öngörülebilir yeniden boyutlandırma davranışı ve sunucu‑tarafı yetkilendirme ile başlar.

Doconut Windows tabanlı .NET uygulamanız içinde görüntüleme yeteneği sağlayabilir. Ekibiniz ardından duyarlı uygulama kabuğu, güvenlik kuralları ve iş akışına odaklanarak görüntüleyicinin ürünün doğal bir parçası gibi hissettirilmesini sağlayabilir.