عرض HTML عربي من اليمين إلى اليسار

لمحة سريعة

اعرض HTML من اليمين إلى اليسار (RTL) في PDF باستخدام writeHtml(). اضبط خاصية CSS‏ direction: rtl وسجّل خطًا يدعم العربية. يعيد المحرك ترتيب النص بصريًا باستخدام خوارزمية Unicode ثنائية الاتجاه ‏(UAX #9)، ويشكّل الحروف العربية بحسب مواضعها السياقية. تعرض هذه الوصفة فاتورة عربية صغيرة. ينطبق RTL على العربية والعبرية والفارسية والأردية. أما العبرية فتُعاد ترتيبها فقط دون تشكيل، وهذا هو السلوك الصحيح لهذه الكتابة.

التثبيت

composer require nextpdf/core

تحتاج أيضًا إلى خط TrueType أو OpenType يدعم العربية. يجب أن يغطي جدول رموزه كتلة Arabic Presentation Forms-B. ويُعد Noto Naskh Arabic وAmiri خطين مناسبين ومفتوحي الترخيص.

نظرة مفاهيمية عامة

لتمكين عرض RTL، تحتاج إلى مدخلين: خاصية CSS‏ direction: rtl وخط عربي مُسجَّل.

توجّه direction: rtl التخطيط إلى وضع النص من اليمين إلى اليسار. ثم يستخدم المحرك خوارزمية Unicode ثنائية الاتجاه ‏(UAX #9) لحل الترتيب البصري. يُرتَّب المحتوى المختلط ترتيبًا صحيحًا: تحتفظ الكلمات اللاتينية والكلمات العربية والأرقام باتجاهاتها الخاصة. والرقم الذي يلي نصًا عربيًا يحتفظ بترتيب أرقامه من اليسار إلى اليمين.

العربية كتابة متصلة، لذلك يتخذ كل حرف شكلًا رسوميًا مختلفًا بحسب الأحرف المجاورة له. يختار المحرك الشكل الابتدائي أو الوسطي أو الختامي أو المنفرد لكل حرف، ويطبّق رابطة Lam-Alef. يتطلب هذا التشكيل السياقي خطًا يغطي جدول رموزه كتلة Arabic Presentation Forms-B. ولا يستطيع خط لاتيني فقط، بما في ذلك وجوه الخطوط الأربعة عشر القياسية، رسم العربية.

داخل الجدول، يُعاد ترتيب محتوى كل خلية ويُشكَّل مستقلًا، وتُحاذى الخلايا إلى حافة البداية: الحافة اليمنى تحت direction: rtl. وتُحلّ قيمتا text-align المنطقيتان start وend وفق الاتجاه، فتشير start إلى الحافة اليمنى لمحتوى RTL.

اضبط الاتجاه بخاصية CSS‏ direction. ولا تُترجَم سمة HTML‏ dir إليها. راجع RTL — القيود الحالية لمعرفة حدود التنفيذ الحالية.

واجهة API

الرمز	الموضع	الدور
Document::writeHtml(string $html): static	NextPDF\Core\Concerns\HasTextOutput	اعرض مقطع HTML عند موضع المؤشر الحالي.
FontRegistry::register(string $fontFile, string $alias = '', int $fontIndex = 0): FontInfo	NextPDF\Typography\FontRegistry	سجّل وجه الخط العربي باسم مستعار.
DocumentFactory::create(): Document	NextPDF\Core\DocumentFactory	أنشئ مستندًا يقرأ السجل الذي ملأته.

يستخدم المثال خصائص CSS التالية: direction وfont-family وtext-align. أشِر في CSS‏ font-family إلى الخط المُسجَّل باستخدام اسمه المستعار في السجل.

نموذج الكود — البدء السريع

<?php

declare(strict_types=1);

require_once __DIR__ . '/vendor/autoload.php';

use NextPDF\Core\DocumentFactory;
use NextPDF\Graphics\ImageRegistry;
use NextPDF\Typography\FontRegistry;

$fontRegistry = new FontRegistry();
$fontRegistry->register(__DIR__ . '/NotoNaskhArabic-Regular.ttf', alias: 'ArabicFont');

$documentFactory = new DocumentFactory($fontRegistry, new ImageRegistry(maxCacheBytes: 0));
$doc = $documentFactory->create();
$doc->addPage();

$doc->writeHtml(
    '<div style="direction: rtl; font-family: \'ArabicFont\';">'
    . '<h1>فاتورة</h1>'
    . '<p>المبلغ الإجمالي 380.00</p>'
    . '</div>'
);

$doc->save(__DIR__ . '/rtl-arabic.pdf');

يظهر العنوان من اليمين إلى اليسار، وتبقى الأرقام 380.00 من اليسار إلى اليمين داخل الجملة العربية.

نموذج الكود — للإنتاج

يعرض هذا المثال المستقل جدول فاتورة عربية. تستخدم كل خلية direction: rtl والخط العربي المُسجَّل، فيعيد المحرك ترتيب كل سطر ويُشكّله، ثم يحاذي الخلايا إلى الحافة اليمنى.

<?php

declare(strict_types=1);

require_once __DIR__ . '/vendor/autoload.php';

use NextPDF\Core\DocumentFactory;
use NextPDF\Graphics\ImageRegistry;
use NextPDF\Typography\FontRegistry;

// Supply an Arabic-capable face whose cmap covers Arabic Presentation Forms-B.
// Embed only fonts you are licensed to embed.
$fontPath = __DIR__ . '/NotoNaskhArabic-Regular.ttf';
if (!is_file($fontPath)) {
    fwrite(STDERR, "Arabic font not found at {$fontPath}\n");
    exit(1);
}

$fontRegistry = new FontRegistry();
$fontRegistry->register($fontPath, alias: 'ArabicFont');

$documentFactory = new DocumentFactory($fontRegistry, new ImageRegistry(maxCacheBytes: 0));
$doc = $documentFactory->create();
$doc->setTitle('Arabic invoice');
$doc->addPage();

$html = <<<'HTML'
<div style="direction: rtl; font-family: 'ArabicFont'; font-size: 12pt;">
  <h1>فاتورة</h1>
  <table style="width: 100%; border-collapse: collapse;">
    <tr>
      <th style="border: 1px solid #333; padding: 6px;">الوصف</th>
      <th style="border: 1px solid #333; padding: 6px;">المبلغ</th>
    </tr>
    <tr>
      <td style="border: 1px solid #333; padding: 6px;">خدمات استشارية</td>
      <td style="border: 1px solid #333; padding: 6px;">380.00</td>
    </tr>
    <tr>
      <td style="border: 1px solid #333; padding: 6px;">الإجمالي</td>
      <td style="border: 1px solid #333; padding: 6px;">380.00</td>
    </tr>
  </table>
</div>
HTML;

$doc->writeHtml($html);

$out = getenv('NEXTPDF_OUT');
$doc->save($out !== false ? $out : __DIR__ . '/render-rtl-arabic-html.pdf');

echo "Wrote the Arabic invoice PDF\n";

  الوصف المبلغ   خدمات استشارية 380.00   الإجمالي 380.00  

HTML;$doc->writeHtml($html);$out = getenv('NEXTPDF_OUT');$doc->save($out !== false ? $out : __DIR__ . '/render-rtl-arabic-html.pdf');echo "Wrote the Arabic invoice PDF\n";">