Phông chữ

@textjs/font phân tích tệp FIGfont 2 (.flf) và bố trí chúng giống hệt chương trình figlet. Mỗi phông chữ là một ES module, nên chỉ những phông chữ bạn import mới đi kèm ứng dụng.

import { FigletText } from "@textjs/font/react";import { slant } from "@textjs/font/slant";export default function Page() {  return <FigletText font={slant} color="accent">Text.js</FigletText>;}

#Cài đặt

bun add @textjs/font

#Cách dùng

<FigletText> nhận một phông chữ và một chuỗi. Hàng được đo bằng ô, nên chữ nằm trong layout flexbox như mọi <Text> khác.

import { FigletText } from "@textjs/font/react";import { big } from "@textjs/font/big";<FigletText font={big} layout="fitted" columns={60} align="center" color="muted">  Deployed</FigletText>

<AsciiFont> nhận cùng các phông chữ này, đồng thời giữ kiểu chữ block và compact tích hợp sẵn:

<AsciiFont text="Text.js" font={slant} color="accent" />

Ngoài React, renderFiglet trả về một chuỗi cho mỗi hàng:

import { renderFiglet } from "@textjs/font";import { standard } from "@textjs/font/standard";renderFiglet(standard, "Hello", { layout: "full" });// ["  _   _          _   _         ", " | | | |   ___  | | | |   ___  ", …]

#Layout

Layout ngang tuân theo các cờ của FIGlet.

Thư viện triển khai đủ sáu quy tắc ghép chồng ngang: ký tự giống nhau, gạch dưới, phân cấp, cặp đối nhau, chữ X lớn và khoảng trắng cứng.

verticalLayout áp dụng cho văn bản nhiều dòng. FIGlet 2.2.5 không bao giờ xếp các dòng sát lại, nên mặc định là "full"; "fitted", "smushed" và "universal" triển khai năm quy tắc dọc, bao gồm ghép chồng tăng cường nét dọc, còn "default" dùng quy tắc của phông chữ.

#Ngắt dòng và căn lề

columns (hoặc width trong renderFiglet) ngắt dòng giữa các từ, rồi đến giữa từ, đúng tại vị trí mà figlet -w sẽ ngắt. align là "left", "center" hoặc "right"; khi không có chiều rộng, các hàng căn theo hàng rộng nhất. Phông chữ từ phải sang trái như ivrit in từ phải sang trái và căn phải; dùng direction để ghi đè.

#Phông chữ đi kèm

Mỗi hình chữ gồm ký tự ASCII in được hoặc Latin-1, nên mỗi ký tự thành phần chiếm đúng một ô trong Menlo của DevTools. @textjs/font/all xuất tất cả phông chữ, cùng BUNDLED_FONTS cho bộ sưu tập xem trước. Phông chữ được phân tích ở lần render đầu tiên, không phải lúc import.

#Phông chữ tùy chỉnh

Mọi FIGfont đều dùng được. Tải về, rồi phân tích:

import { parseFont } from "@textjs/font";const doom = parseFont(await (await fetch("/fonts/doom.flf")).text(), "Doom");

Bộ phân tích đọc phần đầu, các dòng chú thích, khoảng trắng cứng, dấu kết thúc, 102 ký tự bắt buộc và ký tự gắn mã ở hệ thập phân, bát phân hoặc thập lục phân. Phông chữ TOIlet .tlf render dưới dạng văn bản thuần. Ưu tiên phông chữ vẽ bằng ASCII hoặc ký tự vẽ khung; braille và emoji không có chiều rộng một ô trong Menlo.

#Giấy phép

Các phông chữ đi kèm là phông chữ trong bản phân phối FIGlet 2.2.5, giữ nguyên từng byte, theo giấy phép BSD 3-Clause của FIGlet. Mỗi phông chữ giữ thông tin ghi công trong các dòng chú thích, có thể truy cập lúc chạy qua font.comment. Những phông chữ phổ biến không có quyền phân phối lại, như Doom, Larry 3D, ANSI Shadow và Calvin S, không đi kèm.

#Đã kiểm chứng với figlet

Bộ kiểm thử tái hiện 273 đầu ra đã ghi lại từ tệp nhị phân figlet 2.2.5 thực: mọi phông chữ đi kèm ở mọi chế độ layout, ngắt dòng, căn lề, văn bản từ phải sang trái, chế độ đoạn văn và đầu vào kiểm thử hồi quy của chính FIGlet. Tất cả đều khớp hoàn toàn.