Kết xuất HTML tiếng Ả Rập từ phải sang trái

Tổng quan nhanh

Kết xuất HTML từ phải sang trái (RTL) thành PDF bằng writeHtml(). Đặt thuộc tính CSS direction: rtl và đăng ký phông chữ hỗ trợ tiếng Ả Rập. Engine sắp xếp lại văn bản theo thứ tự hiển thị bằng thuật toán hai chiều Unicode (UAX #9) và tạo hình các chữ cái tiếng Ả Rập thành các dạng theo ngữ cảnh. Công thức này kết xuất một hóa đơn tiếng Ả Rập nhỏ. RTL áp dụng cho tiếng Ả Rập, tiếng Hebrew, tiếng Ba Tư và tiếng Urdu. Tiếng Hebrew được sắp xếp lại nhưng không cần tạo hình; điều này phù hợp với hệ chữ đó.

Cài đặt

composer require nextpdf/core

Bạn cũng cần một phông chữ TrueType hoặc OpenType hỗ trợ tiếng Ả Rập. Bản đồ ký tự của phông chữ đó phải bao phủ khối Arabic Presentation Forms-B. Noto Naskh Arabic và Amiri là các phông chữ có giấy phép mở phù hợp.

Tổng quan khái niệm

Để kết xuất RTL, bạn cần hai đầu vào: thuộc tính CSS direction: rtl và một phông chữ tiếng Ả Rập đã đăng ký.

direction: rtl cho hệ thống bố cục biết cần đặt văn bản từ phải sang trái. Sau đó engine dùng thuật toán hai chiều Unicode (UAX #9) để xác định thứ tự hiển thị. Nội dung hỗn hợp được sắp xếp đúng thứ tự: các từ Latin, các từ tiếng Ả Rập và các chữ số đều giữ hướng riêng của mình. Một số đứng sau văn bản tiếng Ả Rập vẫn giữ thứ tự chữ số từ trái sang phải.

Tiếng Ả Rập là hệ chữ nối nét, nên mỗi chữ cái dùng một glyph khác nhau tùy vào các chữ cái lân cận. Engine chọn dạng đầu, dạng giữa, dạng cuối hoặc dạng độc lập cho mỗi chữ cái và áp dụng chữ ghép Lam-Alef. Việc tạo hình theo ngữ cảnh này cần một phông chữ có bản đồ ký tự bao phủ khối Arabic Presentation Forms-B. Một phông chữ chỉ có Latin, kể cả các bộ chữ standard-14, không thể vẽ chữ Ả Rập.

Trong bảng, mỗi ô được sắp xếp lại và tạo hình riêng, rồi được căn về cạnh bắt đầu, tức cạnh phải khi dùng direction: rtl. Các giá trị text-align theo logic là start và end được xác định dựa trên hướng, nên start ánh xạ tới cạnh phải đối với nội dung RTL.

Đặt hướng bằng thuộc tính CSS direction. Thuộc tính HTML dir không được ánh xạ sang thuộc tính này. Xem RTL — các giới hạn hiện tại để biết các ranh giới của bản triển khai hiện tại.

Bề mặt API

Ký hiệu	Vị trí	Vai trò
Document::writeHtml(string $html): static	NextPDF\Core\Concerns\HasTextOutput	Kết xuất đoạn HTML tại vị trí con trỏ hiện tại.
FontRegistry::register(string $fontFile, string $alias = '', int $fontIndex = 0): FontInfo	NextPDF\Typography\FontRegistry	Đăng ký bộ chữ tiếng Ả Rập dưới một bí danh.
DocumentFactory::create(): Document	NextPDF\Core\DocumentFactory	Tạo một tài liệu đọc registry mà bạn đã điền.

Ví dụ này dùng các thuộc tính CSS sau: direction, font-family, text-align. Trong CSS font-family, hãy tham chiếu phông chữ đã đăng ký bằng bí danh registry của nó.

Mẫu mã — khởi đầu nhanh

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

Tiêu đề được kết xuất từ phải sang trái, còn các chữ số 380.00 vẫn giữ thứ tự từ trái sang phải bên trong câu tiếng Ả Rập.

Mẫu mã — sản phẩm

Ví dụ độc lập này kết xuất một bảng hóa đơn tiếng Ả Rập. Mỗi ô có direction: rtl và phông chữ tiếng Ả Rập đã đăng ký, nên engine sắp xếp lại và tạo hình mọi dòng, rồi căn các ô về cạnh phải.

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