跳到主要内容
wechat-emojis

微信内置表情 · TypeScript

把 109 个微信表情,收进代码里。

微信内置表情的 PNG 整理,附类型安全的 API。按名字或分类找到它,复制路径,直接用在项目里。

表情
109
分类
5
总计
690.3 KB
尺寸
100×100

点一个表情,把它放到舞台中央。

全部 109 个表情

按分类浏览,搜索名字,点开就能复制名称、路径或下载 PNG。

点击任意表情查看详情

显示 109 / 109

人脸

75 个

手势

10 个

动物

4 个

祝福

7 个

其他

13 个

装进项目,一行就够

安装之后用 getEmojiUrl 直接拿图片地址,不用复制任何文件。想自托管时再复制 assets。

npm 页面 ↗

第一步 · 安装

终端
npm install wechat-emojis

第二步 · 直接用

TypeScript
import { getEmojiUrl } from 'wechat-emojis';

<img src={getEmojiUrl('旺柴')!} alt="旺柴" />

按名字或分类取用

所有函数都带类型,EmojiName 会拦住不存在的名字。

TypeScript
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,直接作为图片地址即可。

React + TypeScript
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。

wechat-emojis 2.2.0 的公开函数
函数 返回 说明
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 文件实际体积统计

人脸 391.9 KB 56.8% · 75 个
手势 85.3 KB 12.4% · 10 个
动物 43.8 KB 6.3% · 4 个
祝福 36.9 KB 5.3% · 7 个
其他 132.5 KB 19.2% · 13 个

条形长度按 PNG 体积等比换算,最长的分类为 100%。

格式PNG
尺寸100 × 100
平均体积6.33 KB
代码许可MIT

非官方项目,与腾讯及微信团队无关。表情图片版权归腾讯公司所有,仅供个人学习和非商业使用。