Merender HTML Arab kanan-ke-kiri

Sekilas

Render HTML kanan-ke-kiri (RTL) menjadi PDF dengan writeHtml(). Tetapkan properti CSS direction: rtl dan daftarkan font yang mendukung Arab. Mesin menata ulang teks ke urutan visual dengan Unicode Bidirectional Algorithm (UAX #9) dan membentuk huruf Arab ke bentuk kontekstualnya. Resep ini merender faktur kecil berbahasa Arab. RTL berlaku untuk bahasa Arab, Ibrani, Persia, dan Urdu. Teks Ibrani ditata ulang tetapi tidak dibentuk, dan hal itu memang tepat untuk aksara tersebut.

Pemasangan

composer require nextpdf/core

Anda juga memerlukan font TrueType atau OpenType yang mendukung Arab. Peta karakter font tersebut harus mencakup blok Arabic Presentation Forms-B. Noto Naskh Arabic dan Amiri adalah jenis huruf berlisensi terbuka yang cocok.

Tinjauan konseptual

Untuk rendering RTL, Anda memerlukan dua masukan: properti CSS direction: rtl dan font Arab yang terdaftar.

direction: rtl memberi tahu tata letak agar menempatkan teks dari kanan ke kiri. Mesin kemudian menggunakan Unicode Bidirectional Algorithm (UAX #9) untuk menyelesaikan urutan visual. Konten campuran tersusun dengan benar: kata Latin, kata Arab, dan angka masing-masing mempertahankan arahnya sendiri. Sebuah angka yang mengikuti teks Arab tetap mempertahankan urutan digit dari kiri ke kanan.

Aksara Arab adalah aksara kursif, sehingga setiap huruf memakai glif yang berbeda berdasarkan huruf-huruf di sekitarnya. Mesin memilih bentuk awal, tengah, akhir, atau terpisah untuk setiap huruf dan menerapkan ligatur Lam-Alef. Pembentukan kontekstual ini memerlukan font yang peta karakternya mencakup blok Arabic Presentation Forms-B. Font yang hanya berisi Latin, termasuk jenis huruf standard-14, tidak dapat menggambar Arab.

Di dalam tabel, setiap sel ditata ulang dan dibentuk secara terpisah, lalu sel-sel disejajarkan ke tepi awal: tepi kanan di bawah direction: rtl. Nilai logis text-align start dan end diselesaikan terhadap arah, sehingga start dipetakan ke tepi kanan untuk konten RTL.

Tetapkan arah dengan properti CSS direction. Atribut HTML dir tidak dipetakan ke properti tersebut. Lihat RTL — batasan saat ini untuk mengetahui batas implementasi saat ini.

Permukaan API

Simbol	Lokasi	Peran
Document::writeHtml(string $html): static	NextPDF\Core\Concerns\HasTextOutput	Merender fragmen HTML di posisi kursor saat ini.
FontRegistry::register(string $fontFile, string $alias = '', int $fontIndex = 0): FontInfo	NextPDF\Typography\FontRegistry	Mendaftarkan jenis huruf Arab dengan sebuah alias.
DocumentFactory::create(): Document	NextPDF\Core\DocumentFactory	Membuat dokumen yang membaca registry yang telah Anda isi.

Contoh ini menggunakan properti CSS berikut: direction, font-family, text-align. Rujuk font yang sudah terdaftar di CSS font-family melalui alias registry-nya.

Contoh kode — Mulai cepat

<?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');

Judul dirender dari kanan ke kiri, sementara digit 380.00 tetap dari kiri ke kanan di dalam kalimat Arab.

Contoh kode — Produksi

Contoh mandiri ini merender tabel faktur berbahasa Arab. Setiap sel memiliki direction: rtl dan font Arab yang terdaftar, sehingga mesin menata ulang serta membentuk setiap baris, lalu menyejajarkan sel ke tepi kanan.

<?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";">