Appearance
实现 繁简转换 工具
分类:developer | 标签:繁简、OpenCC、中文 简繁中文互转(OpenCC)
2.1 功能说明
简繁中文互转(OpenCC)
核心能力
- 转换方向
- 简体 → 繁体(台湾)
- 繁体(台湾) → 简体
- 简体 → 繁体(香港)
- 繁体(香港) → 简体
2.1.1 使用指南
基于 OpenCC 的简繁中文互转,支持台湾 / 香港两套繁体用词。
- 字典已内置,无需联网。
- 转换为逐字符映射,适合文档与术语统一。
2.2 代码实现
2.2.1 组件结构
本工具是一个基于 Vue 3 <script setup> 语法的单文件组件(SFC),统一包裹在 ToolPageShell 组件内,由它提供页面标题、工具 ID、分类与「使用指南」插槽等通用外壳;核心业务逻辑(响应式状态、计算属性、事件处理函数)全部写在 <script setup> 中,输入/输出通过 el-input、el-button 等 Element Plus 组件与用户交互,所有数据均在浏览器本地处理,不会上传服务器。
2.2.2 核心逻辑概览
<script setup> 中定义的主要函数/方法:
ensure()convert()copyOut()
2.2.3 关键实现代码
以下是该工具的完整 <script setup> 实现(核心代码)。模板(<template>)与样式(<style>)已省略。
vue
import { ref } from 'vue'
import { ElMessage } from 'element-plus'
import ToolPageShell from '@/components/ToolPageShell.vue'
import OpenCC from 'opencc-js'
const map = {
'cn-tw': ['cn', 'tw'],
'tw-cn': ['tw', 'cn'],
'cn-hk': ['cn', 'hk'],
'hk-cn': ['hk', 'cn']
}
const source = ref('')
const output = ref('')
const dir = ref('cn-tw')
const error = ref('')
let converter = null
function ensure() {
const [from, to] = map[dir.value]
converter = OpenCC.Converter({ from, to })
}
function convert() {
error.value = ''
const txt = source.value
if (!txt || !txt.trim()) {
error.value = '请输入需要转换的文本'
return
}
try {
ensure()
output.value = converter(txt)
} catch (e) {
error.value = '转换失败:' + (e && e.message ? e.message : String(e))
}
}
function copyOut() {
if (!output.value) return
navigator.clipboard?.writeText(output.value).then(
() => ElMessage.success('已复制'),
() => ElMessage.warning('复制失败,请手动选择')
)
}2.3 效果截图
