Об этом проекте

Twemoji — это библиотека и коллекция emoji-изображений, предназначенная для единообразного отображения стандартных символов Unicode на разных платформах. Версия 14.0 соответствует Unicode 14.0 и Emoji 14.0, охватывая рекомендованные для общего обмена emoji, определённые Unicode; она не поддерживает пользовательские emoji. JavaScript-библиотеку можно загрузить с CDN, например unpkg, или скачать из репозитория в виде готовых активов. Основной API — twemoji.parse, который может обрабатывать HTMLElement или строку. Рекомендуется разбор DOM, так как он заменяет emoji только в текстовых узлах, сохраняет окружающие элементы и слушатели, а также избегает использования innerHTML. Разбор строк задокументирован как устаревший и не выполняет санитизацию входных данных. Разбор настраивается с помощью опций для обратного вызова URL изображения, базового пути, расширения файла, CSS-класса, размера и папки с активами. По умолчанию используются PNG-изображения, а SVG-активы можно выбрать, задав соответствующую папку и расширение. Сгенерированные изображения включают доступный альтернативный текст, содержащий исходный emoji. Библиотека также предоставляет вспомогательные функции для преобразования между шестнадцатеричными кодовыми точками и UTF-16 суррогатными парами. Документация включает рекомендации по CSS для масштабирования emoji относительно окружающего текста, напоминает разработчикам о необходимости объявления UTF-8 и показывает, как с помощью обратного вызова можно исключить определённые символы, такие как знаки авторского права или товарного знака. Код выпущен под лицензией MIT, а графика — под CC-BY 4.0 с указанием авторства, которое может быть размещено, например, в README, разделе «О проекте», нижнем колонтитуле сайта или исходном коде. В README также перечислены связанные интеграции сообщества для Ruby, PHP, .NET, Vue, JavaFX, LaTeX, шрифтов и других сред.