إخفاء تجاوز النص في Excel باستخدام GroupDocs.Viewer للغة Java

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

ضبط تجاوز النص في جداول Excel باستخدام GroupDocs.Viewer للغة Java

ضبط تجاوز النص في جداول Excel باستخدام GroupDocs.Viewer للغة Java

إجابات سريعة

  • ماذا يفعل “hide text overflow excel”? إنه يقمع أي محتوى خلية يتجاوز عرض أو ارتفاع الخلية أثناء عرض HTML.
  • أي مكتبة تتعامل مع هذا؟ توفر GroupDocs.Viewer للغة Java الخيار TextOverflowMode.HIDE_TEXT.
  • هل أحتاج إلى ترخيص؟ يتوفر ترخيص مؤقت للتقييم؛ ويتطلب الترخيص الكامل للإنتاج.
  • هل يمكنني أيضًا تحويل Excel إلى HTML؟ نعم – يقوم نفس العارض بتحويل ملفات Excel إلى HTML مع تطبيق إعداد التجاوز.
  • هل هذا النهج مناسب لدفاتر العمل الكبيرة؟ بالطبع، فقط اتبع نصائح الأداء في قسم “Performance considerations”.

ما هو إخفاء تجاوز النص في Excel؟

Hide text overflow Excel هو وضع عرض يخبر العارض بقطع أي نص قد يخرج خارج حدود الخلية المحددة عندما يتم تحويل ورقة Excel إلى HTML. هذا يحافظ على ترتيب التخطيط، خاصةً في لوحات التحكم أو التقارير المعروضة في المتصفحات.

لماذا تستخدم GroupDocs.Viewer لتحويل Excel إلى HTML؟

يدعم GroupDocs.Viewer أكثر من 100 تنسيق مستند ويمكنه عرض دفتر عمل Excel مكوّن من 500 صفحة إلى HTML في أقل من 8 ثوانٍ على خادم عادي، كل ذلك دون الحاجة إلى Microsoft Office. يوفر محركه على جانب الخادم تحكمًا دقيقًا—مثل إخفاء النص المتجاوز—مع الحفاظ على استهلاك الذاكرة منخفضًا (أقل من 200 ميغابايت لمعظم دفاتر العمل الكبيرة).

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

  • Java Development Kit (JDK) – الإصدار 8 أو أحدث.
  • Maven – لإدارة التبعيات.
  • معرفة أساسية بـ Java وبيئة تطوير متكاملة (IntelliJ IDEA، Eclipse، إلخ).

إعداد GroupDocs.Viewer للغة Java

أضف مكتبة العارض إلى مشروع Maven الخاص بك.

اعتماد Maven

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

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

احصل على ترخيص مؤقت لفتح جميع الميزات:

كيفية تحويل Excel إلى HTML باستخدام Java

Viewer هو الفئة الرئيسية في GroupDocs.Viewer التي تقوم بتحميل المستند وعرضه بالتنسيق المطلوب.
لتحويل دفتر عمل Excel إلى HTML باستخدام GroupDocs.Viewer للغة Java، أنشئ مثيلًا من Viewer يشير إلى ملف .xlsx، وقم بتكوين HtmlViewOptions باستخدام SpreadsheetOptions.setTextOverflowMode(TextOverflowMode.HIDE_TEXT)، ثم استدعِ viewer.view(htmlOptions). سيولد العارض صفحات HTML لكل ورقة، مع تطبيق إعداد إخفاء التجاوز تلقائيًا.

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

حدد المكان الذي سيتم حفظ ملفات HTML المعروضة فيه.

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

شرح: Utils.getOutputDirectoryPath ينشئ (أو يعيد استخدام) مجلدًا باسم YOUR_OUTPUT_DIRECTORY داخل مجلد إخراج المشروع.

الخطوة 2: تكوين مسار ملف الصفحة

أنشئ نمط تسمية لكل صفحة HTML تم إنشاؤها.

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

شرح: {0} هو عنصر نائب يستبدله العارض برقم الصفحة، مما يمنحك ملفات مثل page_1.html, page_2.html, إلخ.

الخطوة 3: إعداد HtmlViewOptions

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

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

شرح: TextOverflowMode.HIDE_TEXT هو الإعداد الرئيسي الذي يمنع التجاوز في خلايا Excel أثناء عملية render excel as html.

الخطوة 4: عرض المستند الخاص بك

شغّل العارض باستخدام الخيارات المكوّنة.

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

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

شرح: طريقة view تقرأ دفتر العمل النموذجي، وتطبق قاعدة التجاوز، وتكتب ملفات HTML إلى المجلد المحدد سابقًا.

كيفية منع تجاوز النص في Excel

HtmlViewOptions هو كائن التكوين الذي يتحكم في إعدادات عرض HTML للعارض.
viewOptions.getSpreadsheetOptions().setTextOverflowMode(TextOverflowMode.HIDE_TEXT) يجب استدعاؤه قبل استدعاء viewer.view(...) لضمان أن كل ورقة تحترم قاعدة إخفاء التجاوز. يمكنك أيضًا تعيين هذه العلامة على كائنات SpreadsheetOptions الفردية إذا كنت بحاجة إلى تحكم على مستوى الورقة. العلامة نفسها TextOverflowMode.HIDE_TEXT تعمل على مستوى الورقة، مما يمنحك تحكمًا دقيقًا.

كيفية عرض Excel كـ HTML

HtmlViewOptions هي فئة التكوين التي تحدد كيفية عرض العارض للمستندات إلى HTML، بما في ذلك معالجة الموارد وخيارات التنسيق.
استخدم HtmlViewOptions لتحديد ما إذا كانت الموارد مدمجة أو خارجية، واضبط سلسلة CSS مخصصة باستخدام setCustomCss، وعدّل دقة الصورة عبر setImageResolution. اجمع هذه الإعدادات مع TextOverflowMode.HIDE_TEXT لإنتاج مخرجات HTML مصقولة تتوافق مع إرشادات علامتك التجارية وتضمن تنسيقًا ثابتًا عبر الصفحات.

كيفية إخفاء تجاوز النص في Excel في دفاتر العمل الكبيرة

اعرض كل ورقة على حدة عن طريق التكرار عبر viewer.getDocumentInfo().getPages() واستدعاء viewer.view لكل صفحة، ثم احفظ النتائج في ذاكرة مؤقتة. يقلل ذلك من ضغط الذاكرة ويسرّع الطلبات المتكررة لنفس دفتر العمل. احرص دائمًا على إغلاق مثيل Viewer باستخدام try‑with‑resources لتحرير الموارد الأصلية بسرعة.

حالات الاستخدام الشائعة والفوائد

  • بوابات الويب – عرض الجداول المالية دون أن تتسبب السلاسل الطويلة في كسر التخطيط.
  • لوحات تحليلات البيانات – الحفاظ على قابلية قراءة مجموعات البيانات الكبيرة عن طريق إخفاء النص الزائد.
  • تقارير العملاء – تقديم تقارير HTML نظيفة ومناسبة للطباعة.

باستخدام hide text overflow Excel، تضمن بقاء العرض البصري متسقًا عبر المتصفحات والأجهزة.

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

  • إدارة الذاكرة – حرّر مثيل Viewer على الفور (كما هو موضح باستخدام try‑with‑resources).
  • الموارد المدمجة – دمج الصور والأنماط يقلل عدد طلبات HTTP لكنه يزيد حجم HTML؛ اختر الوضع الذي يناسب قيود عرض النطاق الترددي لديك.
  • التخزين المؤقت – احفظ HTML المعروض لدفاتر العمل التي يتم الوصول إليها بشكل متكرر لتجنب إعادة المعالجة.

يعالج GroupDocs.Viewer دفتر عمل مكوّن من 300 ورقة في أقل من 12 ثانية مع الحفاظ على الذاكرة القصوى أقل من 250 ميغابايت، بفضل بنية البث الخاصة به.

المشكلات الشائعة والحلول

  • العارض لا يحرّر الذاكرة – تأكد من أنك تستخدم نمط try‑with‑resources؛ فـ Viewer يطبق AutoCloseable.
  • التجاوز لا يزال يظهر – تحقق مرة أخرى من أن viewOptions.getSpreadsheetOptions().setTextOverflowMode(TextOverflowMode.HIDE_TEXT); تم استدعاؤه قبل viewer.view(viewOptions).
  • الأنماط مفقودة – إذا قمت بالتبديل من الموارد المدمجة إلى الخارجية، تأكد من أن صفحة HTML الخاصة بك ترتبط بملف CSS المُولد.

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

س: ما هو GroupDocs.Viewer للغة Java؟
إنه مكتبة Java تقوم بعرض أكثر من 100 تنسيق مستند — بما في ذلك Excel — إلى HTML، PDF، PNG، وأكثر، دون الحاجة إلى Microsoft Office على الخادم.

س: كيف أتعامل مع ملفات Excel الكبيرة التي تحتوي على تجاوز النص؟
استخدم TextOverflowMode.HIDE_TEXT كما هو موضح، وفعل التخزين المؤقت أو عالج الملف ورقةً تلو الأخرى للحفاظ على انخفاض استهلاك الذاكرة.

س: هل يمكنني تخصيص مخرجات HTML أكثر؟
نعم. توفر HtmlViewOptions العديد من الإعدادات — مثل CSS مخصص، ومعالجة الصور، والتحكم في حجم الصفحة — بحيث يمكنك تعديل HTML وفقًا لعلامتك التجارية.

س: ما هي الأخطاء الشائعة عند استخدام هذه الميزة؟
نسيان تحرير مثيل Viewer، أو استدعاء إعداد التجاوز بعد viewer.view، سيتسبب في تسرب الذاكرة أو عدم فعالية الإخفاء.

س: أين يمكنني الحصول على مزيد من المساعدة أو الأمثلة؟
قم بزيارة GroupDocs Support Forum للحصول على مساعدة المجتمع والوثائق الرسمية.

الخلاصة

باتباع الخطوات المذكورة أعلاه، يمكنك hide text overflow Excel الخلايا عند convert excel to html باستخدام GroupDocs.Viewer للغة Java. هذه الإعدادات البسيطة تحسن بشكل كبير قابلية قراءة جداول البيانات المعروضة وتندمج بسلاسة في حلول التقارير القائمة على الويب.

الموارد

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

الدروس ذات الصلة