全部 109 个表情
按分类浏览,搜索名字,点开就能复制名称、路径或下载 PNG。
点击任意表情查看详情
人脸
75 个手势
10 个动物
4 个祝福
7 个其他
13 个没有找到「」。
装进项目,一行就够
安装之后用 getEmojiUrl 直接拿图片地址,不用复制任何文件。想自托管时再复制 assets。
第一步 · 安装
npm install wechat-emojis
第二步 · 直接用
import { getEmojiUrl } from 'wechat-emojis';
<img src={getEmojiUrl('旺柴')!} alt="旺柴" />
按名字或分类取用
所有函数都带类型,EmojiName 会拦住不存在的名字。
import {
EmojiCategory,
getEmojiUrl,
getEmojisByCategory,
searchEmojis,
} from 'wechat-emojis';
const url = getEmojiUrl('旺柴');
// 'https://cdn.jsdelivr.net/npm/wechat-emojis@2/assets/face/旺柴.png'
const faces = getEmojisByCategory(EmojiCategory.FACE);
// 75 个
const laugh = searchEmojis('笑');
// 微笑、偷笑、坏笑……
在 React 里铺一面表情墙
getEmojisByCategory 返回的每一项都带有 path,直接作为图片地址即可。
import {
EmojiCategory,
getEmojisByCategory,
} from 'wechat-emojis';
export function EmojiPicker() {
return (
<div className="emoji-grid">
{getEmojisByCategory(EmojiCategory.FACE).map((emoji) => (
<img
key={emoji.name}
src={emoji.path}
alt={emoji.name}
width={48}
height={48}
/>
))}
</div>
);
}
API 速查
完整签名见仓库里的 docs/API.md。
| 函数 | 返回 | 说明 |
|---|---|---|
getEmojiPath(name) | string | null | 取包内相对路径(自托管时用) |
getEmojiUrl(name) | string | null | 取可直接渲染的图片 URL |
getEmojiInfo(name) | EmojiInfo | null | 取名称、分类和路径 |
getEmojisByCategory(category) | EmojiInfo[] | 按分类取列表 |
getAllEmojis() | EmojiInfo[] | 取全部 109 个 |
searchEmojis(keyword) | EmojiInfo[] | 按名称子串搜索 |
hasEmoji(name) | boolean | 检查名字是否存在 |
getEmojiNames(category?) | string[] | 取名称列表 |
getRandomEmoji(category?) | EmojiInfo | 随机取一个 |
这套表情有多大
109 个文件,共 690.3 KB。人脸表情占了大半,单个文件从 3.1 KB 到 14.6 KB 不等。
按 PNG 文件实际体积统计
格式PNG
尺寸100 × 100
平均体积6.33 KB
代码许可MIT
非官方项目,与腾讯及微信团队无关。表情图片版权归腾讯公司所有,仅供个人学习和非商业使用。