Representar HTML en árabe de derecha a izquierda

De un vistazo

Representar HTML de derecha a izquierda (RTL) en PDF con writeHtml(). Se debe establecer la propiedad CSS direction: rtl y registrar una fuente compatible con el árabe. El motor reordena el texto en orden visual mediante el Algoritmo Bidireccional de Unicode (UAX #9) y modela las letras árabes en formas contextuales. Esta receta muestra cómo representar una pequeña factura en árabe. RTL se aplica al árabe, el hebreo, el persa y el urdu. El hebreo se reordena, pero no se modela, lo cual es correcto para esa escritura.

Instalación

composer require nextpdf/core

También se necesita una fuente TrueType u OpenType compatible con el árabe. Su mapa de caracteres debe cubrir el bloque Arabic Presentation Forms-B. Noto Naskh Arabic y Amiri son tipos de letra adecuados con licencia abierta.

Descripción conceptual

Para representar contenido RTL se necesitan dos entradas: la propiedad CSS direction: rtl y una fuente árabe registrada.

direction: rtl indica al motor de maquetación que coloque el texto de derecha a izquierda. A continuación, el motor utiliza el Algoritmo Bidireccional de Unicode (UAX #9) para resolver el orden visual. El contenido mixto se ordena correctamente: las palabras latinas, las palabras árabes y los dígitos conservan su propia dirección. Un número que sigue a texto árabe conserva sus dígitos de izquierda a derecha.

El árabe es una escritura cursiva; por eso, cada letra usa un glifo diferente según sus vecinas. El motor selecciona la forma inicial, medial, final o aislada de cada letra y aplica la ligadura Lam-Alef. Este modelado contextual requiere una fuente cuyo mapa de caracteres cubra el bloque Arabic Presentation Forms-B. Una fuente solo latina, incluidos los tipos de letra standard-14, no puede dibujar árabe.

En las tablas, cada celda se reordena y se modela por separado, y las celdas se alinean al borde inicial: el borde derecho con direction: rtl. Los valores lógicos de text-align start y end se resuelven según la dirección, por lo que start se asigna al borde derecho para el contenido RTL.

Establecer la dirección con la propiedad CSS direction. El atributo HTML dir no se asigna a ella. Consultar RTL: limitaciones actuales para conocer los límites actuales de la implementación.

Superficie de la API

Símbolo	Ubicación	Función
Document::writeHtml(string $html): static	NextPDF\Core\Concerns\HasTextOutput	Representa el fragmento HTML en la posición actual del cursor.
FontRegistry::register(string $fontFile, string $alias = '', int $fontIndex = 0): FontInfo	NextPDF\Typography\FontRegistry	Registra el tipo de letra árabe bajo un alias.
DocumentFactory::create(): Document	NextPDF\Core\DocumentFactory	Crea un documento que lee el registro que ha rellenado.

El ejemplo usa estas propiedades CSS: direction, font-family, text-align. Se debe hacer referencia a la fuente registrada en la propiedad CSS font-family mediante su alias de registro.

Muestra de código — Inicio rápido

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

El encabezado se representa de derecha a izquierda, y los dígitos 380.00 se mantienen de izquierda a derecha dentro de la frase árabe.

Muestra de código — Producción

Este ejemplo autónomo representa una tabla de factura en árabe. Cada celda incluye direction: rtl y la fuente árabe registrada, de modo que el motor reordena y modela cada línea y, a continuación, alinea las celdas al borde derecho.

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