- 内置字库,零依赖,支持任何运行环境。
- 支持
3077+
常用简体字 和4919+
繁体字/异体字。 - 支持
3577+
简体短语转繁体的特殊情况。 - 支持
117+
繁体短语/异体短语 转简体的特殊情况。
内置字库 < 30kb
,短语库 约 374kb
。为了避免加载资源过多,你需要手动加载短语库。
v2
相比于 v1
版本,提供了更多的字库支持!更精确的繁简体转换!更少的转换耗时!
[!IMPORTANT]
v2
版本仅支持 ESM 导入,不再支持 CommonJS 和 IIFE。如果你想使用 CommonJS 或 IIFE 导入,请使用
v1
版本。
访问 在线演示 查看。
# npm
npm install chinese-simple2traditional
# yarn
yarn add chinese-simple2traditional
# pnpm
pnpm add chinese-simple2traditional
也可以使用 JSR ,但包名重命名为 @raise/han-convert
:
# npm
npx jsr add @raise/han-convert
# yarn
yarn dlx jsr add @raise/han-convert
# pnpm
pnpm dlx jsr add @raise/han-convert
# bun
bunx jsr add @raise/han-convert
# deno
deno add @raise/han-convert
import { toSimplified, toTraditional } from 'chinese-simple2traditional'
toTraditional('主人何为言少钱,径须酤取对君酌。') // 主人何爲言少錢,徑須酤取對君酌
toSimplified('主人何爲言少錢,徑須酤取對君酌') // 主人何为言少钱,径须酤取对君酌。
默认情况下,繁简体转换仅是逐个对字符进行处理,因此获取的结果可能并不是精确的。
优势是加载的包体积 <30kb
。
你还可以额外引入 短语库,获取更为精确的转换结果,但需要额外加载 374kb+
的短语库。
import { toSimplified, toTraditional } from 'chinese-simple2traditional'
import { setupEnhance } from 'chinese-simple2traditional/enhance'
setupEnhance() // 注入短语库
// 默认情况下,王后 被错误转为 王後
toSimplified('王妃后来成为了王后') // 王妃後來成爲了王後
// 传入第二个参数 `true` 以获取精确结果
toSimplified('王妃后来成为了王后', true) // 王妃後來成爲了王后
如果是使用 JSR 安装,请使用以下语句导入:
import { toSimplified, toTraditional } from '@raise/han-convert'
import { setupEnhance } from '@raise/han-convert/enhance'
-
text
:string
, 待转换的文本 -
enhance
:boolean
, 是否启用短语库,只有在 注入短语库 后有效
将文本简体转换为繁体。
-
text
:string
, 待转换的文本 -
enhance
:boolean
, 是否启用短语库,只有在 注入短语库 后有效
将文本繁体转换为简体。
注入短语库。
import { setupEnhance } from 'chinese-simple2traditional/enhance'
// or JSR
import { setupEnhance } from '@raise/han-convert/enhance'
添加 自定义 简体转繁体 短语集合。
-
phrases
:[string, string][]
, 短语集合集合的每个元素为
['简体短语', '繁体短语']
的元组,表示简体短语
转换为繁体短语
import { customS2TPhrases, toTraditional } from 'chinese-simple2traditional'
customS2TPhrases([
['双台子区', '雙臺子區'],
// ...
])
toTraditional('双台子区', true) // 雙臺子區
添加 自定义 繁体转简体 短语集合。
-
phrases
:[string, string][]
, 短语集合集合的每个元素为
['繁体短语', '简体短语']
的元组, 表示繁体短语
转换为简体短语
import { customT2SPhrases, toSimplified } from 'chinese-simple2traditional'
customT2SPhrases([
['雖覆能復', '虽覆能复']
// ...
])
toSimplified('雖覆能復', true) // 虽覆能复