当前位置：首页 > news >正文

如何使用Hangul.js实现韩国语字符的音素分析

news 2026/7/26 14:12:29

如何使用Hangul.js实现韩国语字符的音素分析

【免费下载链接】Hangul.js한글 자음/모음 분리/조합 자바스크립트 라이브러리. 자바스크립트 한글 오토마타 구현체입니다.项目地址: https://gitcode.com/gh_mirrors/ha/Hangul.js

Hangul.js是一款强大的韩国语字符音素分析JavaScript库，能够轻松实现韩语音素的分离与组合功能，是处理韩国语文本的实用工具。无论是开发韩国语相关的应用还是进行韩语文本处理，Hangul.js都能为你提供便捷的音素分析解决方案。

快速入门：Hangul.js的安装步骤

1. Node.js环境安装

如果你使用Node.js开发项目，可以通过npm快速安装Hangul.js：

npm install hangul-js

安装完成后，在代码中引入即可使用：

const Hangul = require('hangul-js');

2. TypeScript环境安装

对于TypeScript项目，安装方式与Node.js类似：

npm install hangul-js

引入方式如下：

import * as Hangul from 'hangul-js';

3. 网页端直接使用

在普通网页中使用时，只需通过<script>标签引入hangul.js文件：

<script src="hangul.js" type="text/javascript"></script> <!-- 或者使用CDN --> <script src="https://unpkg.com/hangul-js" type="text/javascript"></script>

引入后，可通过全局对象Hangul访问库的功能：

Hangul // window.Hangul

核心功能：韩语音素的分离与组合

韩语音素分离：Hangul.disassemble方法

Hangul.disassemble(str:string, grouped:boolean = false)方法能将韩文字符串分离为音素数组，非韩文字符会保持原样。你也可以使用别名Hangul.d来调用该方法。

基本使用示例：

Hangul.disassemble('가나다'); // ['ㄱ','ㅏ','ㄴ','ㅏ','ㄷ','ㅏ'] Hangul.disassemble('ab가c'); // ['a','b','ㄱ','ㅏ','c']

当grouped参数设为true时，会按原字符分组返回音素：

Hangul.d('매드캣MK2', true); // [['ㅁ', 'ㅐ'], ['ㄷ', 'ㅡ'], ['ㅋ', 'ㅐ', 'ㅅ'], ['M'], ['K'], ['2']]

韩语音素组合：Hangul.assemble方法

Hangul.assemble(arr:string[])方法可以将音素数组组合成韩文字符串，同样非韩文字符会保持原样，别名Hangul.a也可使用。

使用示例：

Hangul.assemble(['ㄱ','ㅏ','ㄴ','ㅏ','ㄷ','ㅏ']); // '가나다' Hangul.assemble(['a','b','ㄱ','ㅏ','c']); // 'ab가c'

高级应用：韩语文本搜索功能

Hangul.search方法

Hangul.search(a:string, b:string)方法用于检查字符串a是否包含字符串b，这里的包含关系是基于韩语音素输入的。返回值大于等于0表示包含。

示例：

Hangul.search('달걀','닭'); // 0（表示包含） Hangul.search('달걀','알'); // -1（表示不包含）

与普通indexOf方法的区别：

let a = '도우미', b = '도움'; a.indexOf(b); // -1 Hangul.search(a, b); // 0

Hangul.Searcher类

当需要用一个关键词搜索多个字符串时，Hangul.Searcher类更为高效，它内部只需进行一次音素分离。

使用示例：

let searcher = new Hangul.Searcher('닭'); searcher.search('달걀'); // 0 searcher.search('달구지'); // 0 searcher.search('달무리'); // -1

实用工具：其他韩语文本处理函数

字符类型判断

Hangul.isComplete(c)：判断字符是否为完整韩文字符
Hangul.isConsonant(c)：判断字符是否为韩语音节中的辅音
Hangul.isVowel(c)：判断字符是否为韩语音节中的元音
Hangul.isCho(c)：判断字符是否可作为韩语音节的初声
Hangul.isJong(c)：判断字符是否可作为韩语音节的终声

文本结尾判断

Hangul.endsWithConsonant(c)：判断字符是否以辅音结尾，可用于“은/는”等助词选择
Hangul.endsWith(c, t)：判断字符是否以目标音素结尾，可用于“로/으로”等助词选择

实际案例：韩语音素转换应用

Hangul.js可以实现各种有趣的韩语音素转换功能，比如将普通韩语音素转换为“된소리”（紧音）。以下是一个简单示例：

let input = '아버지가 방에 들어가신다' function stronger(x){ if(x == 'ㄱ' || x == 'ㅋ') return 'ㄲ'; if(x == 'ㄷ' || x == 'ㅌ') return 'ㄸ'; if(x == 'ㅂ' || x == 'ㅍ') return 'ㅃ'; if(x == 'ㅅ') return 'ㅆ'; if(x == 'ㅈ' || x == 'ㅊ') return 'ㅉ'; return x; } console.log(Hangul.a(Hangul.d(input).map(stronger))); // 输出：아뻐찌까 빵에 뜰어까씬따

通过这个例子可以看到，利用Hangul.js的音素分离和组合功能，能够轻松实现韩语文本的各种音素级别的处理和转换。