Eseguire il rendering di HTML arabo da destra a sinistra

In sintesi

Eseguire il rendering in PDF di HTML da destra a sinistra (RTL) con writeHtml(). Impostare la proprietà CSS direction: rtl e registrare un font con copertura per l’arabo. Il motore riordina il testo nell’ordine visivo tramite l’algoritmo bidirezionale Unicode (UAX #9) e sagoma le lettere arabe nelle loro forme contestuali. Questa ricetta mostra il rendering di una piccola fattura araba. L’RTL si applica ad arabo, ebraico, persiano e urdu. L’ebraico viene riordinato ma non sagomato; per questa scrittura è il comportamento corretto.

Installazione

composer require nextpdf/core

Serve inoltre un font TrueType o OpenType con copertura per l’arabo. La sua mappa dei caratteri deve coprire il blocco Arabic Presentation Forms-B. Noto Naskh Arabic e Amiri sono font adatti, distribuiti con licenza aperta.

Panoramica concettuale

Per il rendering RTL sono necessari due input: la proprietà CSS direction: rtl e un font registrato per l’arabo.

direction: rtl indica all’impaginazione di disporre il testo da destra a sinistra. Il motore usa quindi l’algoritmo bidirezionale Unicode (UAX #9) per risolvere l’ordine visivo. Il contenuto misto viene ordinato correttamente: parole latine, parole arabe e cifre mantengono ciascuna la propria direzione. Un numero dopo testo arabo mantiene le cifre da sinistra a destra.

L’arabo è una scrittura corsiva, quindi ogni lettera usa un glifo diverso a seconda dei caratteri vicini. Il motore seleziona la forma iniziale, mediana, finale o isolata per ciascuna lettera e applica la legatura Lam-Alef. Questa sagomatura contestuale richiede un font la cui mappa dei caratteri copra il blocco Arabic Presentation Forms-B. Un font soltanto latino, inclusi i tipi di carattere standard-14, non può disegnare l’arabo.

In una tabella, il contenuto di ogni cella viene riordinato e sagomato separatamente, e le celle si allineano al bordo iniziale: il bordo destro con direction: rtl. I valori logici di text-align start e end si risolvono rispetto alla direzione, quindi start corrisponde al bordo destro per il contenuto RTL.

Impostare la direzione con la proprietà CSS direction. L’attributo HTML dir non è equivalente. Vedere RTL — limiti attuali per i limiti attuali dell’implementazione.

Superficie dell’API

Simbolo	Posizione	Ruolo
Document::writeHtml(string $html): static	NextPDF\Core\Concerns\HasTextOutput	Esegue il rendering del frammento HTML alla posizione corrente del cursore.
FontRegistry::register(string $fontFile, string $alias = '', int $fontIndex = 0): FontInfo	NextPDF\Typography\FontRegistry	Registra il font arabo sotto un alias.
DocumentFactory::create(): Document	NextPDF\Core\DocumentFactory	Crea un documento che legge il registro già popolato.

L’esempio usa queste proprietà CSS: direction, font-family, text-align. Nel CSS font-family, fare riferimento al font registrato tramite il suo alias di registro.

Esempio di codice — Avvio rapido

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

Il titolo viene reso da destra a sinistra e le cifre 380.00 restano da sinistra a destra all’interno della frase araba.

Esempio di codice — Produzione

Questo esempio autonomo esegue il rendering di una tabella di fattura araba. Ogni cella include direction: rtl e il font arabo registrato, così il motore riordina e sagoma ogni riga, quindi allinea le celle al bordo destro.

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