Bir belge görüntüleyici teknik olarak işlevsel olabilir ve yine de dar bir ekranda kullanılamaz hissi verebilir. Yoğun araç çubukları, minik kontroller, 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üzeni, kimlik doğrulama, yetkilendirme, depolama ve belge iş akışını kontrol eder.

Bu kılavuz, o çevre deneyimine odaklanır: gömülü bir görüntüleyiciye yeterli alan nasıl sağlanır, uygulama kontrolleri nasıl rahat kullanılabilir hâle getirilir, yönelim değişiklikleri nasıl ele alınır ve doğrulanmamış SDK kaynak koduna güvenmeden gerçekçi belgeler nasıl test edilir.

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

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

Görüntüleyici yalnızca üst düzeninin sağladığı alanı kullanabilir. Uygulama onu 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 sayfadaki birincil görev nedir?
Okuma sırasında hangi uygulama kontrolleri görünür kalmalı?
Hangi ikincil paneller çökebilir veya bir düğmenin arkasına taşınabilir?

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

Mevcut Alana Göre Düzeni Planlayın

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

Geniş düzen

Geniş bir görünüm alanında, sayfa şunları gösterebilir:

Bir belge küçük resmi veya gezinme paneli
Ana belge tuvali
Yorumlar veya meta veriler için ikincil iş akışı paneli
Uygulama eylemlerinin tam seti

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

Uygulama Kontrollerini Dokunmatik Dostu Hale Getirin

Görüntüleyicinin etrafındaki kontroller, hassas işaretçi hareketi olmadan etkinleştirilebilecek kadar rahat olmalıdır.

Pratik yönergeler şunları içerir:

Etkileşimli kontroller için yaklaşık 44x44 CSS piksel hedef alanı sağlayın.
Yıkıcı ve sık kullanılan eylemler arasında yeterli boşluk bırakın.
Temel bilgileri göstermek için fareyle üzerine gelmeye (hover) güvenmeyin.
Klavye kullanıcıları için odak göstergelerini görünür tutun.
Sadece simge içeren düğmeler için erişilebilir adlar sağlayın.
Kritik kontrolleri 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üklenen SDK sürümü için resmi kaynakları kullanın ve duyarlı kurallarınızı yalnızca uygulama sahipliğindeki kapsayıcılara ve kontrollere uygulayın.

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

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

Kompakt düzenlerde:

Bir yan paneli yalnızca kullanıcı talep ettiğinde açın.
Kapatıldıktan sonra odağı onu açan düğmeye geri döndürün.
Uygun olduğunda odaklamayı modal paneller içinde tutun.
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ğlarsa, 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 yalnızca görsel değildir. Büyük belgeler, özellikle sayfa karmaşık panolar veya animasyonlar da içeriyorsa, bellek, bant genişliği ve render kısıtlamalarını ortaya çıkarabilir.

Rekabet Eden Çalışmayı Azaltın

Kullanıcı okurken süslü animasyonları duraklatın, görüntüleyicinin etrafındaki pahalı efektlerden kaçının ve gereksiz gözlemcileri veya olay dinleyicilerini kaldırın.

Düzen Alanını Ayırın

Görüntüleyicinin ana bilgisayarına yüklemeden önce sabit bir yükseklik verin. Bu, büyük düzen kaymalarını önler ve kullanıcıların yanlış kontrolü dokunma ihtimalini azaltır.

İkincil Özellikleri Bilinçli Yükleyin

Yorumlar, denetim geçmişi ve büyük meta veri panelleri her zaman ilk belge sayfasıyla birlikte yüklenmek zorunda değildir. İş akışınıza uygun olduğunda, kullanıcı ilgili paneli açana kadar bunları erteleyin.

Temsilci Dosyaları Test Edin

Uzun PDF'ler, geniş elektronik tablolar, detaylı 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ı ortaya koyamaz.

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 dosyalara açık saklama kuralları uygulayın.
Belge içeriklerini, gizli bilgileri veya hassas erişim URL'lerini kaydetmekten 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çerik görünür hâle geldikten sonra her türlü yakalama biçimini engelleyemez.

Doconut'u Duyarlı Deneyime Entegre Etmek

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

Mantıklı bir uygulama sırası şudur:

Gerekli formatları ve görüntüleyici özelliklerini doğrulayın.
Desteklenen Doconut paketini .NET uygulamanıza entegre edin.
Belge çözünürlüğünü sunucu tarafı yetkilendirme ile koruyun.
Görüntüleyiciyi akışkan, uygulama sahipliğindeki bir ana konteynerde konumlandırın.
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.

Mevcut ürün bilgileri için doğrulanmış Doconut Görüntüleyici ürün sayfasını inceleyin. Sürüm‑özel kurulum ve entegrasyon talimatları için resmi indirme ve dokümantasyon sayfasını kullanın; üçüncü‑taraf gönderilerindeki 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ı payını alır.
Sabit genişlikler yatay kaydırmayı zorlamaz.
İkincil paneller temiz bir şekilde çökebilir.
Görünüm alanı 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 kontrolleri rahat hedef boyutlarına sahiptir.
Temel eylemler fareyle üzerine gelmeye (hover) bağlı değildir.
Sadece simge içeren kontroller erişilebilir adlara sahiptir.
Odak görünür kalır ve mantıklı bir sırayı izler.
Çekmeceler ve iletişim kutuları odaklamayı doğru şekilde geri verir.

Belgeler

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

Güvenlik ve Operasyonlar

Sunucu her belge isteğini yetkilendirir.
Depolama detayları gizli kalır.
Dosya ve geçici veri saklama belgelenir.
Hatalar ve günlükler hassas bilgileri içermez.
Kaynak limitleri ve eşzamanlı oturum davranışı test edilir.

Sık Sorulan Sorular

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

Genellikle hayır. Tek bir duyarlı sayfa bakımı daha kolaydır. Düzeni mevcut alana göre değiştirin ve ikincil kontrolleri aşamalı 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. Ana konteyneri ve kendi uygulama kontrollerinizi stilize edin. Dağıttığınız Doconut sürümü için belgelenen özelleştirme noktalarını yalnızca kullanın.

Kompakt düzenlerde indirme ve yazdırma düğmeleri gizlenmeli mi?

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

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

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 konteyner, belge‑öncelikli bir düzen, rahat kontroller, 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 daha sonra duyarlı uygulama kabuğuna, güvenlik kurallarına ve görüntüleyiciyi ürünün doğal bir parçası gibi hissettiren iş akışına odaklanabilir.