Smoji — 现代化开源表情库与轻量 Web 表情选择器

产品简介

Smoji 是一套现代化开源图片表情解决方案，由表情库工作台和轻量选择器 SDK 两大部分组成。工作台面向博主与个人用户，在浏览器中自由浏览高清静态/动态表情、灵活管理自选分组、实时预览多格式数据，一键导出为 Artalk、Twikoo、OwO、Ecoku 等主流博客评论系统的配置文件。选择器 SDK 则面向前端开发者，采用原生 TypeScript 编写、零运行时依赖，核心压缩体积小于 1.6 KB（Gzip）。

核心功能

• 双导出模式：支持整包一键导出和自选分组精细导出两种模式
• 自选分组管理：自由创建最多 32 个自定义分组，支持跨组拖拽投放、调序与精准筛选
• 优异的浏览预览体验：缩略图列表节省加载流量；详情弹窗支持原图与动图播放，提供透明棋盘格、浅色纯白、深色纯黑 3 种背景预览模式
• 多格式快捷复制：内置复制控制台，一键复制 Markdown、图片 URL、HTML 标签与 BBCode
• 隐私保护与本地持久化：无需注册账号，分组配置、勾选状态、最近使用记录、主题与视图密度均存储在浏览器本地（localStorage），支持 JSON 导入与导出备份
• 全键盘与无障碍支持：严格遵循 WAI-ARIA 规范，支持键盘方向键无缝漫游、焦点捕获与丰富快捷键
• 零运行时依赖选择器：原生纯 JavaScript/TypeScript 编写，完全与框架无关
• 极致羽量级体积：Core JS 压缩后约 3 KB（Gzip 约 1.5 KB），Core CSS 压缩后约 1.9 KB（Gzip 约 800 B）
• 智能浮层定位：结合 visualViewport 与边界碰撞检测，在复杂移动端和滚动页面中精准浮层定位，不越界、不溢出
• 严格防注入渲染：富文本渲染器纯 DOM 节点组装，绝不使用 innerHTML，强制校验图片同源性与 URL 协议，杜绝 XSS 注入
• 多平台导出适配：支持导出为 Smoji v1（Ecoku/Smoji Picker）、Artalk、Twikoo、OwO（Valine/Waline）、Markdown、URL/HTML/BBCode 等多种格式

特色优势

相比现有的博客表情方案，Smoji 的最大差异化在于同时提供了高质量的图库生态和极轻量的嵌入式选择器。图库由社区维护，原图托管于 S3 CDN，导出的 Markdown 使用绝对图片链接，历史内容永续性有保障。选择器 SDK 零框架依赖，可以嵌入任何前端项目中，体积远小于主流 emoji picker 库。

应用场景

• 个人博主为博客评论系统配置表情
• 论坛管理员统一管理论坛 emoji 资源
• 前端开发者为自建网站或 Web 应用集成表情选择器
• 文档或知识库系统嵌入轻量表情输入组件
• 社交平台或社区产品集成表情选择功能

适用人群

• 独立博主与自建网站站长
• 论坛与社区运营者
• 前端开发者（需要集成表情选择器的任何 Web 项目）
• 开源社区维护者

官方链接

• 在线体验：https://smoji.zsh.moe/
• 源代码：https://github.com/DejavuMoe/Smoji
• 问题反馈：https://github.com/DejavuMoe/Smoji/issues
• JSON Schema 规范：https://github.com/DejavuMoe/Smoji/blob/master/packages/smoji/data.schema.json