كيفية تحويل Excel إلى HTML و JPG و PNG و PDF باستخدام GroupDocs.Viewer Java

تحويل Excel إلى HTML هو طلب شائع عندما تحتاج إلى عرض بيانات الجداول الإلكترونية على الويب مع الحفاظ على رؤوس الصفوف والأعمدة. في هذا الدرس ستتعلم كيف يبسط GroupDocs.Viewer for Java convert excel to html وكذلك كيفية تصيير نفس المصنف إلى صيغ JPG و PNG و PDF. سنستعرض المتطلبات المسبقة، إعداد المكتبة، وكل سيناريو تصيير مع مقتطفات شفرة واضحة جاهزة للإنتاج.

إجابات سريعة

  • هل يمكن لـ GroupDocs.Viewer تحويل Excel إلى صيغ متعددة؟ نعم – HTML، JPG، PNG، و PDF مدعومة مباشرة.
  • هل أحتاج إلى ترخيص للتطوير؟ النسخة التجريبية المجانية تعمل للاختبار؛ الترخيص الدائم مطلوب للإنتاج.
  • هل سيتم الاحتفاظ برؤوس الصفوف والأعمدة؟ اضبط setRenderHeadings(true) في خيارات العرض لتضمينها.
  • ما نسخة Java المطلوبة؟ Java 8 أو أعلى؛ المكتبة متوافقة مع Java 11، 17، وما بعده.
  • هل التحويل سريع للدفاتر الكبيرة؟ يمكن لـ GroupDocs.Viewer معالجة جداول بيانات مكوّنة من 200 صفحة في أقل من ثانية على خوادم عادية.

ما هو “convert excel to html”؟

Convert excel to html يعني تحويل مصنف Excel إلى مستند HTML جاهز للويب مع الحفاظ على التخطيط الأصلي، الصيغ، والرؤوس. يتيح ذلك تضمين الجداول بسهولة في صفحات الويب أو البوابات دون الحاجة إلى تثبيت Excel لدى المستخدم النهائي.

لماذا نستخدم GroupDocs.Viewer Java لتصيير Excel؟

GroupDocs.Viewer Java يدعم أكثر من 50 صيغة إدخال وإخراج، بما في ذلك DOCX، XLSX، PPTX، HTML، JPG، PNG، و PDF. يعالج المصنفات التي تتجاوز مئات الصفحات دون تحميل الملف بالكامل إلى الذاكرة، مما يحقق سرعات تحويل تصل إلى 10 × أسرع من العديد من البدائل المفتوحة المصدر. كما توفر المكتبة تحكمًا دقيقًا في خيارات التصيير مثل رؤية الرؤوس، حجم الصفحة، وجودة الصورة.

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

  • مجموعة تطوير جافا (JDK) 8+ مثبتة ومُكوَّنة في بيئة التطوير المتكاملة (IntelliJ IDEA، Eclipse، إلخ).
  • Maven لإدارة التبعيات.
  • إلمام أساسي بصياغة Java وملف pom.xml الخاص بـ Maven.
  • ترخيص فعال لـ GroupDocs.Viewer Java (تجريبي أو دائم).

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

أضف تبعية GroupDocs.Viewer Java إلى ملف 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>

إعداد البيئة

  • تحقق من أن الأمر java -version يُظهر 1.8 أو أحدث.
  • افتح بيئة التطوير المفضلة لديك وأنشئ مشروع Maven.

لنبدأ بالمتطلبات المسبقة اللازمة قبل الغوص في التنفيذ.

تحويل ملفات Excel إلى HTML و JPG و PNG و PDF باستخدام GroupDocs.Viewer للـ Java

إعداد GroupDocs.Viewer Java

معلومات التثبيت

قم بتضمين تبعية Maven المعروضة أعلاه في ملف pom.xml الخاص بمشروعك. بعد تشغيل mvn clean install، ستكون المكتبة متاحة على مسار الفئة الخاص بك.

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

  1. نسخة تجريبية مجانية: قم بتحميل النسخة التجريبية من GroupDocs Free Trial.
  2. ترخيص مؤقت: احصل على ترخيص مؤقت للاختبار الموسع من GroupDocs Temporary License.
  3. شراء: احصل على ترخيص كامل للاستخدام الإنتاجي عبر GroupDocs Purchase.

التهيئة الأساسية

فئة Viewer هي نقطة الدخول لجميع عمليات التصيير. تهيئتها بسيطة:

import com.groupdocs.viewer.Viewer;

public class ViewerSetup {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("Sample.xlsx")) {
            // Your code here to use the viewer
        }
    }
}

هذا ينشئ كائن Viewer مرتبط بملف ترخيص محلي، جاهز لمعالجة ملفات Excel.

دليل التنفيذ

أدناه نغطي كل هدف تصيير. لكل صيغة نستورد أولاً الفئات المطلوبة، ثم نحدد دليل الإخراج، وأخيرًا نضبط خيارات العرض باستخدام setRenderHeadings(true) للحفاظ على رؤوس الصفوف/الأعمدة.

تصيير جدول البيانات إلى HTML

كيف يمكنني تحويل مصنف Excel إلى HTML باستخدام GroupDocs.Viewer Java؟
لتحويل مصنف Excel إلى HTML، حمّل الملف باستخدام Viewer، أنشئ كائن HtmlViewOptions، فعّل تصيير الرؤوس، واستدعِ طريقة view. العملية تكتب كل ورقة عمل في ملفات HTML منفصلة، مع الحفاظ على تنسيق الخلايا، الصيغ، والتخطيط الأصلي لعرض ويب دقيق.

تنفيذ خطوة بخطوة

1. استيراد المكتبات المطلوبة
HtmlViewOptions يضبط كيفية تصيير المصنف إلى HTML، مع إمكانية تخصيص الرؤوس، الأنماط، وتخطيط الصفحة.

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

2. تحديد دليل الإخراج
حدد مجلدًا حيث سيتم كتابة صفحات HTML المُولدة.

Path outputDirectory = Paths.get("YOUR_DOCUMENT_DIRECTORY", "RenderRowAndColumnHeadings");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

3. تهيئة Viewer وتكوين الخيارات
أنشئ كائن Viewer، اضبط setRenderHeadings(true)، واستدعِ view.

try (Viewer viewer = new Viewer(Paths.get("Sample.xlsx"))) {
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
    
    // Enable rendering of row and column headings in the spreadsheet.
    options.getSpreadsheetOptions().setRenderHeadings(true);

    viewer.view(options, 1, 2, 3); // Render pages 1 to 3.
}

شرح: HtmlViewOptions يتحكم في مخرجات HTML. تمكين setRenderHeadings(true) يضمن ظهور الصف والعمود الأول (عادةً رؤوس) في HTML الناتج، مما يجعل البيانات مفهومة فورًا.

تصيير جدول البيانات إلى JPG

كيف يمكنني تصيير ورقة Excel كصورة JPG مع تضمين الرؤوس؟
يتضمن تصيير ورقة Excel كصورة JPG تهيئة Viewer بالمصنف، إنشاء كائن JpgViewOptions، ضبط renderHeadings إلى true، ثم استدعاء view. المكتبة ترسم كل صفحة بدقة DPI المحددة، وتنتج ملفات JPG عالية الدقة تحتفظ بالهيكل البصري للرسم البياني والرؤوس.

تنفيذ خطوة بخطوة

1. استيراد المكتبات المطلوبة
JpgViewOptions يحدد إعدادات تصيير الأوراق كصور JPG، بما في ذلك DPI، الجودة، ورؤية الرؤوس.

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;

2. تحديد دليل الإخراج
حدد مكان تخزين ملفات JPG.

Path outputDirectory = Paths.get("YOUR_DOCUMENT_DIRECTORY", "RenderRowAndColumnHeadings");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.jpg");

3. تهيئة Viewer وتكوين الخيارات
أنشئ الـ viewer، اضبط تصيير الرؤوس، ونفّذ التحويل.

try (Viewer viewer = new Viewer(Paths.get("Sample.xlsx"))) {
    JpgViewOptions options = new JpgViewOptions(pageFilePathFormat);
    
    // Enable rendering of row and column headings in the spreadsheet.
    options.getSpreadsheetOptions().setRenderHeadings(true);

    viewer.view(options, 1, 2, 3); // Render pages 1 to 3.
}

شرح: JpgViewOptions يتيح لك التحكم في DPI والجودة. مع setRenderHeadings(true)، تحتفظ الصور الناتجة برؤوس الصفوف والأعمدة، وهو أمر أساسي للتقارير والعروض التقديمية.

تصيير جدول البيانات إلى PNG

ما هي العملية لتحويل Excel إلى PNG مع الحفاظ على رؤوس الأعمدة؟
لإنشاء صور PNG من ملف Excel، استخدم Viewer لفتح المصنف، أنشئ كائن PngViewOptions، فعّل تصيير الرؤوس، ونفّذ view. مخرجات PNG توفر جودة غير مضغوطة، مع الحفاظ على جميع أنماط الخلايا ورؤوس الصفوف، ما يجعلها مثالية للأرشفة أو المعالجة اللاحقة للصور.

تنفيذ خطوة بخطوة

1. استيراد المكتبات المطلوبة
PngViewOptions يتحكم في تصيير الأوراق إلى صور PNG، مع ضغط غير مضغوط وخيارات الرؤوس.

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;

2. تحديد دليل الإخراج
اختر مجلدًا لإخراج PNG.

Path outputDirectory = Paths.get("YOUR_DOCUMENT_DIRECTORY", "RenderRowAndColumnHeadings");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.png");

3. تهيئة Viewer وتكوين الخيارات
أنشئ الـ viewer، فعّل تصيير الرؤوس، واستدعِ view.

try (Viewer viewer = new Viewer(Paths.get("Sample.xlsx"))) {
    PngViewOptions options = new PngViewOptions(pageFilePathFormat);
    
    // Enable rendering of row and column headings in the spreadsheet.
    options.getSpreadsheetOptions().setRenderHeadings(true);

    viewer.view(options, 1, 2, 3); // Render pages 1 to 3.
}

شرح: باستدعاء setRenderHeadings(true)، تتضمن ملفات PNG صفوف وأعمدة الرؤوس الأصلية للمصنف، مما يحافظ على السياق للمستقبلين.

تصيير جدول البيانات إلى PDF

كيف يمكنني تحويل ملف Excel إلى PDF مع ظهور رؤوس الصفوف والأعمدة؟
تحويل Excel إلى PDF سهل: أنشئ Viewer مع ملف المصدر، اضبط كائن PdfViewOptions لتصير الرؤوس، ثم استدعِ view. الـ PDF الناتج يعكس تخطيط المصنف، بما في ذلك رؤوس الصفوف والأعمدة، ويدعم الرسومات المتجهة للطباعة الواضحة والتوزيع.

تنفيذ خطوة بخطوة

1. استيراد المكتبات المطلوبة
PdfViewOptions يحدد معلمات إنشاء PDF مثل حجم الصفحة، الهوامش، وتصير الرؤوس.

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;

2. تحديد دليل الإخراج
حدد المجلد الوجهة لمستند PDF.

Path outputDirectory = Paths.get("YOUR_DOCUMENT_DIRECTORY", "RenderRowAndColumnHeadings");
Path pageFilePathFormat = outputDirectory.resolve("output.pdf");

3. تهيئة Viewer وتكوين الخيارات
أنشئ كائن Viewer، فعّل تصيير الرؤوس، ونفّذ التحويل.

try (Viewer viewer = new Viewer(Paths.get("Sample.xlsx"))) {
    PdfViewOptions options = new PdfViewOptions(pageFilePathFormat);
    
    // Enable rendering of row and column headings in the spreadsheet.
    options.getSpreadsheetOptions().setRenderHeadings(true);

    viewer.view(options, 1, 2, 3); // Render pages 1 to 3.
}

شرح: ضبط setRenderHeadings(true) على PdfViewOptions يضمن ظهور الصف/العمود الأول في PDF النهائي، مما يجعل المستند جاهزًا للطباعة أو الأرشفة.

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

سيناريوهات واقعية حيث convert excel to html، excel to pdf java، أو convert spreadsheet to image تكون ذات قيمة كبيرة:

  1. تقارير الأعمال: إنشاء لوحات تحكم HTML أو تقارير PDF من نماذج مالية دون نسخ يدوي.
  2. تصوير البيانات: تضمين لقطات JPG/PNG للجداول في عروض الشرائح، مع ضمان أن الرؤوس توفر سياقًا فوريًا للمشاهدين.
  3. أرشفة المستندات: حفظ مصنفات Excel كملفات PDF للامتثال، مع الحفاظ على التخطيط والرؤوس الأصلية.
  4. بوابات الويب: تقديم إصدارات HTML من الجداول مباشرة في المتصفحات، مع تمكين التصفية التفاعلية باستخدام JavaScript.

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

س: هل يمكنني تحويل ملفات Excel المحمية بكلمة مرور؟
ج: نعم. مرّر كلمة المرور إلى مُنشئ Viewer، وستقوم المكتبة بفك تشفير المصنف قبل التصيير.

س: هل يدعم GroupDocs.Viewer المصنفات التي تحتوي على ماكرو (.xlsm)؟
ج: بالتأكيد. يعامل العارض الماكرو كبيانات؛ يتم تجاهلها أثناء التصيير، مما يضمن تحويلًا آمنًا.

س: ما هو الحد الأقصى لحجم الملف المدعوم؟
ج: يمكن للمكتبة معالجة ملفات تصل إلى 2 GB دون تحميل المستند بالكامل إلى الذاكرة، بفضل بنية البث.

س: هل يمكن تصيير ورقة عمل محددة فقط؟
ج: نعم. استخدم ViewOptions.setPageNumber(pageIndex) لاستهداف ورقة واحدة عند إنشاء HTML أو JPG أو PNG أو PDF.

س: كيف أتحكم في جودة الصورة لإخراج JPG؟
ج: اضبط JpgViewOptions.setQuality(90) (القيمة من 0‑100) لتحقيق توازن بين حجم الملف والوضوح البصري.

الخلاصة

الآن لديك دليل كامل وجاهز للإنتاج حول convert excel to html، excel to pdf java، و convert spreadsheet to image باستخدام GroupDocs.Viewer Java. باتباع الخطوات أعلاه يمكنك دمج تصيير الجداول في أي خلفية Java، وتقديم تقارير HTML، صور عالية الدقة، أو ملفات PDF أرشيفية مع الحفاظ على الرؤوس تلقائيًا.

آخر تحديث: 2026-06-05
تم الاختبار مع: GroupDocs.Viewer Java 23.12
المؤلف: GroupDocs

دروس ذات صلة