emoji data
1.0.0
Этот проект предоставляет простые в полевых данных об эмодзи, а также изображения в стиле Spritesheet для использования в Интернете.
Текущая версия поддерживает Emoji версию 15.1 (сентябрь 2023 г.)
Вы можете увидеть каталог данных Emoji здесь: http://projects.iamcal.com/emoji-data/table.htm
Git Repo довольно большой (почти 4 ГБ), но содержит все. Если вы хотите использовать npm , вы можете:
npm install emoji-datasource
Это только установит полные сприте 32PX (с резервными изображениями). Если вам нужны листы разных размеров (16, 20 или 64px), квантованные листы (128 или 256 цвет), листы без фальки (чистый) или отдельные изображения (при 64px), вам нужно будет установить дополнительные модули NPM:
npm install emoji-datasource-apple
npm install emoji-datasource-google
npm install emoji-datasource-twitter
npm install emoji-datasource-facebookВы также можете использовать его без загрузки через JSDelivr CDN (разные размеры здесь).
Файл, который вы хотите, это emoji.json . Он содержит множество записей для смайликов, которые выглядят так:
[
{
"name" : " WHITE UP POINTING INDEX " ,
"unified" : " 261D-FE0F " ,
"non_qualified" : " 261D " ,
"docomo" : null ,
"au" : " E4F6 " ,
"softbank" : " E00F " ,
"google" : " FEB98 " ,
"image" : " 261d.png " ,
"sheet_x" : 1 ,
"sheet_y" : 2 ,
"short_name" : " point_up " ,
"short_names" : [
" point_up "
],
"text" : null ,
"texts" : null ,
"category" : " People & Body " ,
"subcategory" : " hand-single-finger " ,
"sort_order" : 170 ,
"added_in" : " 1.4 " ,
"has_img_apple" : true ,
"has_img_google" : true ,
"has_img_twitter" : true ,
"has_img_facebook" : false ,
"skin_variations" : {
"1F3FB" : {
"unified" : " 261D-1F3FB " ,
"image" : " 261d-1f3fb.png " ,
"sheet_x" : 1 ,
"sheet_y" : 3 ,
"added_in" : " 6.0 " ,
"has_img_apple" : true ,
"has_img_google" : false ,
"has_img_twitter" : false ,
"has_img_facebook" : false ,
}
...
"1F3FB-1F3FC" : {
...
}
},
"obsoletes" : " ABCD-1234 " ,
"obsoleted_by" : " 5678-90EF "
},
...
]Смысл каждого поля заключается в следующем:
| Поля | Описание |
|---|---|
name | Официальное имя Unicode, в кричании. |
unified | Unicode Codepoint, как 4-5 шестигранных цифр. Там, где эмодзи нужно 2 или более кодепоинтов, они указаны как 1F1EA-1F1F8. Для смайликов, который должен определить селектор вариаций (-FE0F), который включен здесь. |
non_qualified | Для смайликов, которые также имеют использование без селектора вариаций, эта версия включена здесь (в противном случае нулевая). |
docomo , au ,softbank , google | Наследие коды Unicode Codepoints, используемые различными мобильными поставщиками. |
image | Имя файла изображения. |
sheet_x , sheet_y | Положение изображения в сприте -таблицах. |
short_name | Обычно оценивается на короткое название для изображения, как подтверждается в кострах, GitHub и т. Д. С помощью: Colon-Syntax: |
short_names | Массив всех известных коротких имен. |
text | ASCII версия смайликов (например :) ), или NULL там, где их нет. |
texts | Множество эмодзи ASCII, которые должны превратиться в этот смайлик. Каждый эмодзи ASCII появится только против одной записи смайликов. |
category , subcategory | Категория и имена групп категории и подкатегорий. |
sort_order | Глобальный индекс сортировки для всех смайликов, основанный на упорядочении CLDR Unicode. |
added_in | Версия эмоджи, в которой была добавлена эта последовательность CodePoint/(ранее версия Unicode). |
has_img_* | Флаг для того, имеет ли доступный набор изображений (названным изображением). |
skin_variations | Для смайликов с множественными изменениями тона кожи, список альтернативных глифов, ключи от тона кожи. Для смайликов, которые поддерживают несколько тонов кожи в пределах одного смайлика, каждый тон кожи отделяется характером Dash. |
obsoletes , obsoleted_by | Эмодзи, которые больше не используются, в предпочтении гендерных версий. |
Для каждого набора изображений (Apple, Google и т. Д.) Мы генерируем несколько различных «спрайтных листов» - больших изображений всех смайликов, сшитых вместе.
Каждое изображение эмоджи в листе имеет прозрачную границу с 1 пикселем, поэтому лист 64PX действительно состоит из 66px квадратов, в то время как лист 16px действительно состоит из 18px квадратов и т. Д. Вы можете найти положение любого данного изображения На листе, используя свойства sheet_x и sheet_y , следующим образом:
x = (sheet_x * (sheet_size + 2)) + 1;
y = (sheet_y * (sheet_size + 2)) + 1;
Внутри git Repo вы найдете некоторые простыни в корневом каталоге, а некоторые в sheets-indexed-128 , sheets-indexed-256 и sheets-clean . В пакетах NPM вы найдете их в соответствии с img/{$set}/sheets* paths. Например:
| Git Repo | Пакеты NPM |
|---|---|
| /sheet_apple_16.png | /iimg/apple/sheets/16.png |
| /sheets-indexed-128/sheet_apple_16_indexed_128.png | /img/apple/sheets-128/16.png |
| /sheets-clean/sheet_apple_16_clean.png | /iimg/apple/sheets-clean/16.png |
В этих примерах набор изображений от Apple, а изображения - 16px на стороне. Листы на верхнем ряду имеют 24 -битный цвет, а листы в среднем ряду используют индексированную цветовую палитру с 128 цветами. Это делает изображение намного меньше, но жертвует большим качеством. Оба 128 цветных и 256 цветных листов предоставляются. Листы в нижнем ряду не содержат запасных отступлений для пропущенных изображений, поэтому лист Google содержит только изображения Google (и без Apple Sharkback). Это означает, что некоторые изображения заменяются запасным персонажем (знак вопроса), но права на использование проще.
См. Изменения.md
Изображения извлекаются из их источников, и эта библиотека пытается отслеживать последние доступные версии. Если вы ищете старые версии изображений Apple или Android (например, волосатое сердце), вам нужно будет посмотреть на предыдущие изменения.
| Набор изображений | Исходная версия | Поддерживается эмодзи | Отсутствуют изображения |
|---|---|---|---|
| Яблоко | iOS 17.4 Бета | Эмодзи 15.1 | 3 |
| Noto Emoji, v2.042 | Эмодзи 15.1 | 0 | |
| Twemoji (вилка), v15.0.3 | Эмодзи 15.0 | 118 | |
| V9, получен 2024-02-05 | Эмодзи 15.0 | 142 |
Если вы используете изображения SpriteShip и обеспокоены правами на использование, используйте версии «Чистых», которые избегают использования резервных изображений для пропущенных смайликов (см. В разделе SpriteSheest выше).
