https://github.com/mingtianyihou33/wechat-emoji-parser
微信表情转换，可用于公众号接收用户表情消息，将表情转换为相应的图片
https://github.com/mingtianyihou33/wechat-emoji-parser
Last synced: 2 months ago
JSON representation
微信表情转换，可用于公众号接收用户表情消息，将表情转换为相应的图片
- Host: GitHub
- URL: https://github.com/mingtianyihou33/wechat-emoji-parser
- Owner: mingtianyihou33
- License: mit
- Created: 2020-01-14T09:19:35.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-01-22T05:48:53.000Z (5 months ago)
- Last Synced: 2025-03-31T06:06:09.832Z (3 months ago)
- Language: JavaScript
- Size: 3.15 MB
- Stars: 42
- Watchers: 2
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# wechat-emoji-parser
微信表情解析工具，可以实现表情解析和表情发送功能
- 可用于公众号接收用户表情消息，将表情码转换为对应的表情 html 内容
- 还可以获取聊天表情，可以应用于聊天应用的表情
## install（安装）
npm:
```bash
npm install wechat-emoji-parser
```
pnpm:
```bash
pnpm add wechat-emoji-parser
```
## How to use（使用）
#### getEmojis(option)：获取表情
```js
import { getEmojis } from 'wechat-emoji-parser'
let emojis = getEmojis({ size: 24 })
/*emojis
[
{
cn: "[右哼哼]"
code: "/:@>"
style:{
background: "url(...) no-repeat"
background-size: "24px"
display: "inline-block"
height: "24px"
width: "24px"
}
....
]
*/
```
1. 输入：option: {size: number}
| 属性名 | 类型 | 默认值 | 说明 |
| -------------- | ------ | --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| size | number | 64 | emoji 大小，单位 px |
2. 输出 emojis:
```js
[
{
code: string,
cn: string,
style: {
display: string,
background: string,
width: string,
height: string,
'background-size': string,
}
}]
```
| 属性名 | 类型 | 默认值 | 说明 |
| ------ | ------ | ------ | -------------------------- |
| code | string | | emoji 对应的编码，如：/:@> |
| cn | string | | 中文显示，如：[右哼哼] |
| style | Object | | |
#### parseEmoji(str) 解析表情
```js
import { parseEmoji, configParseEmoji } from 'wechat-emoji-parser'
configParseEmoji({ size: 30 }) // 设置一些参数
const res = parseEmoji('哈哈[西瓜]') // 解析文本
```
- configParseEmoji(option: object) 配置解析规则
| 属性名 | 类型 | 默认值 | 说明 |
| -------------- | ------ | --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| size | number | 64 | emoji 大小，单位 px |
| tag | string | 'a' | 解析后的 html 标签 |
- parseEmoji(str: string)
输入：待解析的文本
输出：解析后的内容
## Example
- [vue 项目使用案例](./examples/vue-example)
## Contribution（贡献）
1. 添加表情
在src/assets/emojis里面加上表情图片
2. 添加表情配置
然后在emoji.json里面加上表情的编码规则，src字段对应表情图片的位置