Excel’de Metin Taşmasını Gizleme - GroupDocs.Viewer for Java

Bir elektronik tabloyu HTML’e dönüştürürken Excel’de metin taşmasını gizleme hücrelerini kullandığınızda, sonuç temiz ve profesyonel görünür. Bu öğreticide, GroupDocs.Viewer for Java’ı nasıl yapılandıracağınızı öğrenecek ve hücre sınırlarını aşan tüm hücre içeriğinin basitçe gizlenmesini sağlayacaksınız. Bu teknik, web portalları, raporlama panoları ve düzenli bir yerleşimin önemli olduğu her durum için idealdir.

Excel Elektronik Tablolarında Metin Taşmasını Ayarlama - GroupDocs.Viewer for Java

Excel Elektronik Tablolarında Metin Taşmasını Ayarlama - GroupDocs.Viewer for Java

Hızlı Cevaplar

  • “hide text overflow excel” ne yapar? HTML oluşturulması sırasında hücrenin genişliğini veya yüksekliğini aşan tüm hücre içeriğini bastırır.
  • Bu özelliği hangi kütüphane yönetir? GroupDocs.Viewer for Java, TextOverflowMode.HIDE_TEXT seçeneğini sunar.
  • Lisans gerekiyor mu? Değerlendirme için geçici bir lisans mevcuttur; üretim için tam lisans gereklidir.
  • Excel’i HTML’e dönüştürebilir miyim? Evet – aynı görüntüleyici, taşma ayarını uygulayarak Excel dosyalarını HTML’e dönüştürür.
  • Bu yaklaşım büyük çalışma kitapları için uygun mu? Kesinlikle, sadece “Performans Hususları” bölümündeki performans ipuçlarını izleyin.

Excel’de Metin Taşmasını Gizleme Nedir?

Hide text overflow Excel, bir Excel sayfası HTML’e dönüştürüldüğünde tanımlı hücre kenarlarının dışına taşabilecek metni kesmesini söyleyen bir render modudur. Bu, özellikle tarayıcılarda gösterilen panolar veya raporlar için yerleşimi düzenli tutar.

Excel’i HTML’e Dönüştürmek İçin GroupDocs.Viewer’ı Neden Kullanmalısınız?

GroupDocs.Viewer, 100+ belge formatını destekler ve tipik bir sunucuda 500 sayfalık bir Excel çalışma kitabını 8 saniyeden kısa sürede HTML’e render edebilir; Microsoft Office gerektirmez. Sunucu tarafı motoru, taşan metni gizleme gibi ince ayar kontrolü sağlar ve bellek kullanımını düşük tutar (çoğu büyük çalışma kitabı için 200 MB’den az).

Önkoşullar

  • Java Development Kit (JDK) – sürüm 8 veya daha yeni.
  • Maven – bağımlılık yönetimi için.
  • Temel Java bilgisi ve bir IDE (IntelliJ IDEA, Eclipse vb.).

GroupDocs.Viewer for Java’ı Kurma

Viewer kütüphanesini Maven projenize ekleyin.

Maven Bağımlılığı

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Lisans Alımı

Tüm özelliklerin kilidini açmak için geçici bir lisans edinin:

Java Kullanarak Excel’i HTML’e Nasıl Dönüştürülür

Viewer, bir belgeyi yükleyen ve istenen formata render eden GroupDocs.Viewer’ın ana sınıfıdır.
Excel çalışma kitabını GroupDocs.Viewer for Java ile HTML’e dönüştürmek için, .xlsx dosyasına işaret eden bir Viewer örneği oluşturun, HtmlViewOptions‘ı SpreadsheetOptions.setTextOverflowMode(TextOverflowMode.HIDE_TEXT) ile yapılandırın ve viewer.view(htmlOptions) metodunu çağırın. Görüntüleyici, her sayfa için HTML sayfaları oluşturur ve otomatik olarak taşma gizleme ayarını uygular.

Adım 1: Çıktı Dizinini Tanımla

Render edilen HTML dosyalarının nereye kaydedileceğini belirtin.

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");

Açıklama: Utils.getOutputDirectoryPath, projenin çıktı klasörünün içinde YOUR_OUTPUT_DIRECTORY adlı bir klasör oluşturur (veya yeniden kullanır).

Adım 2: Sayfa Dosya Yolunu Yapılandır

Oluşturulan her HTML sayfası için bir adlandırma deseni oluşturun.

Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

Açıklama: {0}, görüntüleyicinin sayfa numarasıyla değiştirdiği bir yer tutucudur ve size page_1.html, page_2.html gibi dosyalar verir.

Adım 3: HtmlViewOptions’ı Ayarla

HtmlViewOptions, görüntüleyicinin belgeleri HTML’e nasıl render edeceğini tanımlayan, kaynak yönetimi ve stil seçeneklerini içeren yapılandırma sınıfıdır.
Görüntüleyiciye kaynakları gömmesini ve taşan hücre metnini gizlemesini söyleyin.

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
viewOptions.getSpreadsheetOptions().setTextOverflowMode(TextOverflowMode.HIDE_TEXT);

Açıklama: TextOverflowMode.HIDE_TEXT, excel’de taşmayı önler ve excel’i html olarak render ederken hücrelerdeki taşmayı engelleyen ana ayardır.

Adım 4: Belgenizi Render Edin

Yapılandırılmış seçeneklerle görüntüleyiciyi çalıştırın.

Tanım referansı: Viewer, bir kaynak belgeyi okuyan ve istenen formatta çıktı üreten GroupDocs.Viewer’ın çekirdek sınıfıdır.

try (Viewer viewer = new Viewer(TestFiles.SAMPLE_XLSX_WITH_TEXT_OVERFLOW)) {
    viewer.view(viewOptions);
}

Açıklama: view metodu örnek çalışma kitabını okur, taşma kuralını uygular ve HTML dosyalarını daha önce tanımlanan klasöre yazar.

Excel’de Metin Taşmasını Önleme

HtmlViewOptions, görüntüleyicinin HTML render ayarlarını kontrol eden yapılandırma nesnesidir.
viewOptions.getSpreadsheetOptions().setTextOverflowMode(TextOverflowMode.HIDE_TEXT) ifadesi, viewer.view(...) çağrılmadan önce çalıştırılmalıdır; böylece her sayfa gizleme‑taşma kuralına uyar. Sayfa düzeyinde kontrol gerekirse bu bayrağı bireysel SpreadsheetOptions nesnelerine de ayarlayabilirsiniz. Aynı TextOverflowMode.HIDE_TEXT bayrağı sayfa seviyesinde de çalışır ve size hassas kontrol sağlar.

Excel’i HTML Olarak Render Etme

HtmlViewOptions, görüntüleyicinin belgeleri HTML’e nasıl render edeceğini tanımlayan, kaynak yönetimi ve stil seçeneklerini içeren yapılandırma sınıfıdır.
HtmlViewOptions‘ı, kaynakların gömülü mü yoksa harici mi olacağını belirtmek, setCustomCss ile özel bir CSS dizesi ayarlamak ve setImageResolution ile görüntü çözünürlüğünü ayarlamak için kullanın. Bu ayarları TextOverflowMode.HIDE_TEXT ile birleştirerek, marka yönergelerinize uyan ve sayfalar arasında tutarlı stil sağlayan şık bir HTML çıktısı elde edin.

Büyük Çalışma Kitaplarında Excel Taşmasını Gizleme

Her sayfayı ayrı ayrı render etmek için viewer.getDocumentInfo().getPages() üzerinde döngü yapın ve her sayfa için viewer.view çağırın, ardından sonuçları bir önbellekte saklayın. Bu, bellek baskısını azaltır ve aynı çalışma kitabı için tekrar eden istekleri hızlandırır. Yerel kaynakları hızlıca serbest bırakmak için Viewer örneğini her zaman try‑with‑resources ile kapatın.

Ortak Kullanım Senaryoları ve Faydalar

  • Web portalları – Uzun dizelerin yerleşimi bozmadığı finansal tabloları gösterin.
  • Veri analitiği panoları – Fazla metni gizleyerek büyük veri setlerini okunabilir tutun.
  • Müşteri raporlaması – Temiz, yazıcı dostu HTML raporları sunun.

hide text overflow Excel kullanarak, görsel sunumun tarayıcılar ve cihazlar arasında tutarlı kalmasını sağlarsınız.

Performans Hususları

  • Bellek yönetimi – Viewer örneğini hızlıca serbest bırakın (try‑with‑resources ile gösterildiği gibi).
  • Gömülü kaynaklar – Görüntü ve stilleri gömmek HTTP istek sayısını azaltır ancak HTML boyutunu artırır; bant genişliği sınırlamalarınıza uygun modu seçin.
  • Önbellekleme – Sık erişilen çalışma kitapları için render edilmiş HTML’yi saklayarak yeniden işleme ihtiyacını ortadan kaldırın.

GroupDocs.Viewer, akış mimarisi sayesinde 300 sayfalık bir çalışma kitabını 12 saniyeden kısa sürede işler ve en yüksek bellek kullanımını 250 MB’nin altında tutar.

Ortak Sorunlar ve Çözümler

  • Viewer belleği serbest bırakmıyor – try‑with‑resources desenini kullandığınızdan emin olun; Viewer, AutoCloseable uygular.
  • Taşma hâlâ görünüyor – viewOptions.getSpreadsheetOptions().setTextOverflowMode(TextOverflowMode.HIDE_TEXT); ifadesinin viewer.view(viewOptions)‘dan önce çağrıldığını iki kez kontrol edin.
  • Stiller eksik – Gömülü kaynaklardan harici kaynaklara geçiş yapıyorsanız, HTML sayfanızın oluşturulan CSS dosyasına bağlandığından emin olun.

Sıkça Sorulan Sorular

Q: GroupDocs.Viewer for Java nedir?
A: Sunucuda Microsoft Office gerektirmeden, Excel dahil 100’den fazla belge formatını HTML, PDF, PNG ve daha fazlasına render eden bir Java kütüphanesidir.

Q: Metin taşmasıyla büyük Excel dosyalarını nasıl yönetirim?
A: Gösterildiği gibi TextOverflowMode.HIDE_TEXT kullanın ve belleği düşük tutmak için önbellekleme etkinleştirin veya dosyayı sayfa‑sayfa işleyin.

Q: HTML çıktısını daha da özelleştirebilir miyim?
A: Evet. HtmlViewOptions, özel CSS, görüntü işleme ve sayfa‑boyutu kontrolü gibi birçok ayar sunar; böylece HTML’yi markanıza göre özelleştirebilirsiniz.

Q: Bu özelliği kullanırken yaygın hatalar nelerdir?
A: Viewer örneğini serbest bırakmayı unutmak veya taşma ayarını viewer.view‘den sonra çağırmak, bellek sızıntılarına veya gizlemenin etkisiz kalmasına yol açar.

Q: Daha fazla yardım veya örnek nereden alabilirim?
A: Topluluk desteği ve resmi dokümantasyon için GroupDocs Support Forum adresini ziyaret edin.

Sonuç

Yukarıdaki adımları izleyerek, GroupDocs.Viewer for Java ile excel’i html’e dönüştürürken Excel’de metin taşmasını gizleme hücrelerini uygulayabilirsiniz. Bu basit yapılandırma, render edilen elektronik tabloların okunabilirliğini büyük ölçüde artırır ve web tabanlı raporlama çözümlerine sorunsuz bir şekilde entegre olur.

Kaynaklar

Son güncelleme: 2026-09-05
Test edildiği sürüm: GroupDocs.Viewer 25.2 for Java
Yazar: GroupDocs

İlgili Öğreticiler