简体繁体转换

使用说明

本工具使用 opencc-js(开放中文转换 JavaScript 版)进行简繁转换,纯客户端、无后端请求。

简介

opencc-js 是 Open Chinese Convert (OpenCC) 的 JavaScript 实现,支持按地域在简体与繁体之间转换(大陆简体、台湾繁体、香港繁体等),并支持自定义词表与整页 DOM 转换。

API 概览

API 说明
OpenCC.Converter({ from, to }) 按地域转换。from / to 为地域码(见下表)。返回一个函数,传入字符串即返回转换结果。
OpenCC.CustomConverter([]) 自定义词表。参数为 [['词1','替换1'], ['词2','替换2'], …],或字符串 '词1 替换1|词2 替换2'(空格与竖线分隔)。
OpenCC.ConverterFactory(Locale.from.xx, Locale.to.xx, [customDict]) 底层接口,可叠加多段转换与自定义词表。Locale.from / Locale.to 为预设字典。
OpenCC.HTMLConverter(converter, rootNode, langAttrInitial, langAttrNew) 对 DOM 从 rootNode 起转换所有文本,并将 lang 属性从 langAttrInitial 改为 langAttrNew。含 ignore-opencc 类的元素不转换。

地域码

说明
cn简体中文(中国大陆)
tw繁体中文(台湾)
twp繁体中文(台湾)+ 词汇转换(如:自行车 → 脚踏车)
hk繁体中文(香港)
jp日本新字体
t繁体中文(OpenCC 标准,一般勿用)

基本示例

// 香港繁体 → 大陆简体
const cvt = OpenCC.Converter({ from: 'hk', to: 'cn' });
console.log(cvt('漢語')); // 汉语

// 大陆简体 → 台湾繁体
const toTw = OpenCC.Converter({ from: 'cn', to: 'tw' });
console.log(toTw('汉语')); // 漢語

// 大陆简体 → 香港繁体
const toHk = OpenCC.Converter({ from: 'cn', to: 'hk' });
console.log(toHk('软件')); // 軟件

打包优化

使用 ES Modules 打包时,可仅引入所需字典以减小体积:

import * as OpenCC from 'opencc-js/core';
import * as Locale from 'opencc-js/preset';
const converter = OpenCC.ConverterFactory(Locale.from.hk, Locale.to.cn);

此模式下无 Converter,需直接使用 ConverterFactory

更多信息

详见 opencc-js 官方仓库简体说明