تحويل Excel إلى HTML وعرض الصفوف والأعمدة المخفية في جداول بيانات Java باستخدام GroupDocs.Viewer

هل تواجه صعوبة في convert Excel to HTML وتصور الصفوف والأعمدة المخفية داخل جدول البيانات عند تحويله إلى HTML باستخدام Java؟ لست وحدك! يواجه العديد من المطورين هذا التحدي أثناء محاولة الحفاظ على سلامة تصور البيانات عبر صيغ مختلفة. سيوجهك هذا الدرس خطوة بخطوة حول كيفية عرض الصفوف والأعمدة المخفية بفعالية في جداول البيانات باستخدام GroupDocs.Viewer لـ Java، مما يضمن عدم فقدان أي معلومات حيوية أثناء التحويل.

Render Hidden Rows & Columns with GroupDocs.Viewer for Java

Render Hidden Rows & Columns with GroupDocs.Viewer for Java

إجابات سريعة

  • Can GroupDocs.Viewer convert Excel to HTML? نعم، يوفر دعمًا جاهزًا لتحويل ملفات XLSX إلى HTML.
  • Will hidden rows and columns be visible in the HTML output? عند تمكين الخيارات المناسبة، يتم عرض البيانات المخفية كما هي الخلايا الظاهرة.
  • Which Maven artifact is required? com.groupdocs:groupdocs-viewer (يوصى بأحدث نسخة).
  • Do I need a license for production use? يتطلب الإنتاج رخصة دائمة؛ تتوفر نسخة تجريبية مجانية أو رخصة مؤقتة للتقييم.
  • Is this approach compatible with Java 8 and newer? بالطبع – يعمل مع JDK 8+.

ما هو “convert Excel to HTML”؟

تحويل Excel إلى HTML يحول مصنف .xlsx إلى صفحات HTML جاهزة للويب مع الحفاظ على التخطيط الأصلي، أنماط الخلايا، الصيغ، والبيانات. يمكن عرض HTML الناتج في أي متصفح حديث دون الحاجة إلى تثبيت Microsoft Office، مما يجعله مثاليًا للبوابات الإلكترونية، لوحات تقارير، ومنصات التعاون.

لماذا عرض بيانات جدول البيانات المخفية؟

يضمن عرض الصفوف والأعمدة المخفية أن كل قطعة من المعلومات المخزنة في المصنف تصبح مرئية في مخرجات HTML، وهو أمر حاسم للمراجعة، تحليل البيانات، والسيناريوهات التعليمية. من خلال كشف الخلايا المخفية، تتجنب فقدان البيانات عن طريق الخطأ وتضمن أن المستهلكين النهائيين يرون مجموعة البيانات الكاملة كما هي في الملف الأصلي.

المتطلبات المسبقة

المكتبات والاعتمادات المطلوبة

لتنفيذ هذه الميزة، ستحتاج إلى GroupDocs.Viewer لـ Java كاعتماد Maven. تتعامل هذه المكتبة مع عرض المستندات إلى HTML، PDF، وصور.

متطلبات إعداد البيئة

  • Java Development Kit (JDK): الإصدار 8 أو أحدث
  • Integrated Development Environment (IDE): IntelliJ IDEA أو Eclipse أو أي بيئة تطوير متوافقة مع Java
  • Maven: لإدارة الاعتمادات

متطلبات المعرفة

سيساعدك فهم أساسي لأساسيات Java واستخدام Maven الأساسي على متابعة الخطوات بسلاسة.

إعداد GroupDocs.Viewer لـ Java

لبدء استخدام GroupDocs.Viewer في تطبيق Java الخاص بك، ستحتاج إلى إضافة المكتبة عبر Maven.

Maven
أضف التكوين التالي إلى ملف pom.xml الخاص بك:

<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>

خطوات الحصول على الترخيص

  • Free trial – تحميل نسخة تجريبية لتقييم جميع الميزات.
  • Temporary license – طلب رخصة محدودة الوقت للوصول الكامل إلى الميزات أثناء التطوير.
  • Purchase – الحصول على رخصة دائمة للاستخدام الإنتاجي غير المحدود.

بعد إعداد Maven والحصول على الترخيص، يمكنك البدء بتهيئة GroupDocs.Viewer. إليك الطريقة:

import com.groupdocs.viewer.Viewer;

public class ViewerInitialization {
    public static void main(String[] args) {
        // Initialize the viewer with your license file if available.
        try (Viewer viewer = new Viewer("path/to/your/document.xlsx")) {
            // Your code here...
        }
    }
}

كيفية تحويل Excel إلى HTML مع البيانات المخفية

لتحويل مصنف Excel إلى HTML مع ضمان ظهور الصفوف والأعمدة المخفية، تقوم بتحميل الملف باستخدام GroupDocs.Viewer، وتكوين SpreadsheetOptions لعرض العناصر المخفية، وإعداد HtmlViewOptions للصيغة المطلوبة، ثم تستدعي الـ viewer لتوليد ملفات HTML. اتبع الخطوات أدناه لتحقيق ذلك.

الخطوة 1: تحديد مسار دليل الإخراج

حدد المجلد الذي سيتم حفظ ملفات HTML المولدة فيه:

import java.nio.file.Path;
import java.nio.file.Paths;

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY", "RenderHiddenRowsAndColumns");

الخطوة 2: تكوين خيارات عرض HTML

HtmlViewOptions يتحكم في كيفية إنتاج ملفات HTML، بما في ذلك ما إذا كانت الموارد مدمجة أو محفوظة كملفات منفصلة.
فئة HtmlViewOptions هي كائن التكوين المركزي لعرض HTML في GroupDocs.Viewer.

الخطوة 3: تمكين عرض الأعمدة والصفوف المخفية

SpreadsheetOptions يتيح لك تبديل رؤية الصفوف والأعمدة المخفية أثناء التحويل.
SpreadsheetOptions هو حاوية الإعدادات التي تحدد كيفية معالجة الميزات الخاصة بجداول البيانات—مثل الخلايا المخفية، خطوط الشبكة، واختيار ورقة العمل.

الخطوة 4: تهيئة Viewer بالمستند وعرضه

فئة Viewer هي المكوّن الأساسي المستخدم لعرض المستندات في GroupDocs.Viewer.
أنشئ مثيلًا من Viewer، مرّر مسار ملف Excel، واستدعِ طريقة view مع الخيارات المُعدّة.
فئة Viewer هي نقطة الدخول في GroupDocs.Viewer؛ فهي تقرأ المستند المصدر وتنتج الصيغة المطلوبة.

import com.groupdocs.viewer.options.HtmlViewOptions;

// Create a file path format for rendering each page.
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

التطبيقات العملية

  1. Financial reporting – ضمان أن تشمل سجلات التدقيق كل المؤشرات المخفية للامتثال.
  2. Data analysis – الحفاظ على مجموعة البيانات الكاملة عند التصدير إلى لوحات التحكم القائمة على الويب.
  3. Educational tools – توفير محتوى جدول البيانات الكامل للطلاب لتعلم الصيغ والهياكل البيانية.

اعتبارات الأداء

  • يدعم GroupDocs.Viewer تحويل أكثر من 50 تنسيق مستند ويمكنه معالجة مصنفات مئات الصفحات دون تحميل الملف بالكامل في الذاكرة، مما يحافظ على استهلاك منخفض للذاكرة.
  • راقب حجم heap في JVM للملفات Excel الكبيرة؛ زد -Xmx إذا لزم الأمر.
  • احفظ ملفات الإخراج على تخزين SSD سريع لتقليل زمن I/O.
  • حافظ على تحديث المكتبة؛ كل إصدار يتضمن تحسينات أداء وإصلاحات أخطاء.

الخلاصة

في هذا الدرس، تعلمت كيفية convert Excel to HTML وتكوين GroupDocs.Viewer لـ Java لعرض الصفوف والأعمدة المخفية في جداول البيانات. باتباع الخطوات أعلاه، يمكنك ضمان تمثيل كل خلية—مرئية أو مخفية—في مخرجات HTML، مما يوفر رؤية كاملة للبيانات عبر المنصات. جرّب خيارات إضافية مثل CSS مخصص أو إخراج صفحة واحدة لتخصيص النتيجة وفقًا لاحتياجات تطبيقك.

هل أنت مستعد للغوص أعمق؟ نفّذ هذه الميزة في مشاريعك وشاهد كيف تعزز من وظائف تطبيقك!

قسم الأسئلة المتكررة

س1: هل يمكنني استخدام GroupDocs.Viewer مجانًا؟
ج1: نعم، يمكنك تنزيل نسخة تجريبية من الموقع الرسمي لاستكشاف الميزات. للحصول على وصول كامل دون قيود، فكر في الحصول على رخصة مؤقتة أو دائمة.

س2: ما هي صيغ الملفات التي يدعمها GroupDocs.Viewer؟
ج2: يدعم أكثر من 50 صيغة مستند مختلفة، بما في ذلك PDF، Word، Excel، PowerPoint، وأنواع الصور الشائعة.

س3: كيف أتعامل مع المستندات الكبيرة باستخدام GroupDocs.Viewer؟
ج3: حسّن إدارة الذاكرة عن طريق ضبط إعدادات heap في Java، وإذا لزم الأمر، قسّم المصنفات الكبيرة إلى أجزاء أصغر قبل العرض.

س4: هل يمكن تخصيص صيغة مخرجات HTML؟
ج4: نعم، يمكنك تكوين خيارات متعددة باستخدام HtmlViewOptions لتخصيص المظهر، دمج الموارد، أو إنشاء ملف HTML صفحة واحدة.

س5: ما هي أفضل طريقة لاستكشاف مشكلات GroupDocs.Viewer؟
ج5: راجع الوثائق الرسمية ومنتديات المجتمع، تأكد من تطابق جميع اعتمادات Maven مع نسخة المكتبة، وفعل تسجيل الأخطاء التفصيلي للحصول على معلومات دقيقة عن الأخطاء.

الأسئلة المتكررة

س: هل يؤثر تمكين setRenderHiddenColumns(true) على الأداء؟
ج: إضافة عرض الأعمدة المخفية يضيف عبئًا بسيطًا، لكن التأثير ضئيل بالنسبة للمصنفات العادية. بالنسبة للأوراق الكبيرة جدًا، راقب استهلاك الذاكرة وفكر في زيادة حجم heap في JVM.

س: هل يمكنني تحويل ملف XLSX إلى صفحة HTML واحدة بدلاً من عدة صفحات؟
ج: نعم، حدد اسم ملف مخصص في HtmlViewOptions بدون المتغيّر {0} لتوليد ملف HTML واحد يحتوي على جميع أوراق العمل.

س: كيف أعرض بيانات جدول البيانات المخفية فقط لأوراق عمل محددة؟
ج: استخدم viewOptions.getSpreadsheetOptions().setWorksheetIndexes(...) لتحديد الأوراق المستهدفة قبل تمكين عرض المخفي.

س: هل هناك طريقة لإخفاء شريط الأدوات أو التنقل بعد التحويل؟
ج: مخرجات HTML التي يولدها GroupDocs.Viewer ثابتة؛ يمكنك إزالة عناصر التنقل يدويًا عبر تعديل القالب المولد أو تطبيق CSS مخصص.

س: أي نسخة من GroupDocs.Viewer مطلوبة لعرض الصفوف/الأعمدة المخفية؟
ج: الميزة متوفرة بدءًا من النسخة 22.0؛ نوصي باستخدام أحدث إصدار مستقر (حاليًا 25.2) للحصول على أفضل أداء ودعم.

الموارد

آخر تحديث: 2026-09-20
تم الاختبار مع: GroupDocs.Viewer 25.2 for Java
المؤلف: GroupDocs

// Enable rendering of hidden columns and rows.
viewOptions.getSpreadsheetOptions().setRenderHiddenColumns(true);
viewOptions.getSpreadsheetOptions().setRenderHiddenRows(true);

import com.groupdocs.viewer.Viewer;

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX_WITH_HIDDEN_ROW_AND_COLUMN")) {
    // Render the document to HTML using the specified view options.
    viewer.view(viewOptions);
} catch (Exception e) {
    System.out.println("Error rendering document: " + e.getMessage());
}

دروس ذات صلة