npm 包 arabica 使用教程

什么是 arabica?

Arabica 是一个 JavaScript 库，用于将 HTML 文本转换为可打印的 Unicode 字符串。它可以用于带有非拉丁文本的 Web 浏览器，例如阿拉伯语、波斯语、希伯来语、印地语等。Arabica 通过提供一系列 JavaScript 函数，将 HTML 转换为类似于 LaTeX 或 Word 文档的 Unicode 字符串文本。

安装

使用 npm 安装 arabica：

npm install arabica

API

转换 HTML 为 Unicode 字符串

使用 toUnicode(html: string, options?: Options): string 函数将 HTML 文本转换为 Unicode 字符串。其中，html 是要转换的 HTML 文本，options 包含以下可选参数：

• direction: 可选的，用来指定文本方向，默认为 ltr
• removeFormatting: 可选的，用于指示是否删除 HTML 中的所有样式和脚本，默认为 false
• escapeHTML: 可选的，用于指示是否将 HTML 转义为实体，默认为 true
• decimal: 可选的，用于指示是否将 10 进制转换为 Unicode 字符，默认为 true
• extendedEscape: 可选的，用于指示是否将扩展 Unicode 转义符转换为 Unicode 字符，默认为 false

import { toUnicode, Options } from "arabica";

const html = '<p>مرحبا بالعالم</p>';
const options: Options = { direction: "rtl" };

const unicode = toUnicode(html, options);
console.log(unicode);   // '\u202B<p>\u0645\u0631\u062D\u0628\u0627 \u0628\u0627\u0644\u0639\u0627\u0644\u0645</p>\u202C'

解码 HTML 实体

使用 decodeHTMLEntities(str: string): string 函数将 HTML 实体解码为 Unicode 字符串。

import { decodeHTMLEntities } from "arabica";

const htmlEntity = "&lt;p&gt;&#x645;&#x631;&#x62D;&#x628;&#x627; &#x628;&#x627;&#x644;&#x639;&#x627;&#x644;&#x645;</p>";
const unicode = decodeHTMLEntities(htmlEntity);
console.log(unicode);   // '<p>مرحبا بالعالم</p>'

编码 HTML 实体

使用 encodeHTMLEntities(str: string): string 函数将字符串编码为 HTML 实体。

import { encodeHTMLEntities } from "arabica";

const unicode = '<p>مرحبا بالعالم</p>';
const htmlEntity = encodeHTMLEntities(unicode);
console.log(htmlEntity);   // '&lt;p&gt;&#1605;&#1585;&#1587;&#1576;&#1575;&#1578;&#1575; &#1576;&#1575;&#1604;&#1593;&#1575;&#1604;&#1605;&lt;/p&gt;'

转换数字为阿拉伯数字字符串

使用 toArabicNumerals(str: string): string 函数将字符串中的所有数字转换为阿拉伯数字。

import { toArabicNumerals } from "arabica";

const str = '1234 ثواني حتى نصل إلى المنتصف';
const arabicNumerals = toArabicNumerals(str);
console.log(arabicNumerals);   // '١٢٣٤ ثواني حتى نصل إلى المنتصف'

转换阿拉伯数字为字符串

使用 toArabicWords(str: string): string 函数将包含阿拉伯数字的字符串转换为文本形式。

import { toArabicWords } from "arabica";

const arabicNumerals = '١٢٣٤';
const str = toArabicWords(arabicNumerals);
console.log(str);   // 'ألف ومائة وأربعة وثلاثون'

示例

以下示例演示了如何将给定的 HTML 文本中的所有数字转换为阿拉伯数字。

import { toUnicode, decodeHTMLEntities, toArabicNumerals } from "arabica";

const html = '<p>أهلاً، هذا هو الكتاب ١٢٣٤</p>';
const decoded = decodeHTMLEntities(html);
const unicode = toUnicode(decoded);
const arabicNumerals = toArabicNumerals(unicode);

console.log(arabicNumerals);   // 'أهلاً، هذا هو الكتاب 1234'

结语

Arabica 提供了一种简单的方法来处理在 Web 上显示非拉丁文本的问题。使用 Arabica，开发人员可以轻松地将 HTML 文本转换为 Unicode 字符串，以便正确显示文本，并可以轻松地添加有用的功能，例如将数字转换为阿拉伯数字。希望本教程能够帮助您更好地了解 Arabica 并学会如何使用它。

来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/78587