emoji data
1.0.0
Este projeto fornece dados fáceis de comparar sobre emoji, juntamente com uma imagens no estilo SpriteSheet para uso na web.
A versão atual suporta emoji versão 15.1 (setembro de 2023)
Você pode ver um catálogo dos dados emoji aqui: http://projects.iamcal.com/emoji-data/table.htm
O repo Git é muito grande (quase 4 GB), mas contém tudo. Se você quiser usar npm , você pode:
npm install emoji-datasource
Isso instalará apenas as folhas de folhas de fullidade de 32px (com imagens de fallback). Se você deseja folhas de tamanho diferentes (16, 20 ou 64px), folhas quantizadas (cor 128 ou 256), folhas não-quedas (limpas) ou imagens individuais (a 64px), você precisará instalar módulos NPM adicionais:
npm install emoji-datasource-apple
npm install emoji-datasource-google
npm install emoji-datasource-twitter
npm install emoji-datasource-facebookVocê também pode usá -lo sem baixar via JSDelivr CDN (tamanhos diferentes aqui).
O arquivo que você deseja é emoji.json . Ele contém uma variedade de entradas para emoji que se parecem com o seguinte:
[
{
"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 "
},
...
]O significado de cada campo é o seguinte:
| Campos | Descrição |
|---|---|
name | O nome do Unicode Oral, em maiúsculas gritadas. |
unified | O CodePoint Unicode, como 4-5 dígitos hexadecimais. Onde um emoji precisa de 2 ou mais pontos de código, eles são especificados como 1f1ea-1f1f8. Para emoji que precisam especificar um seletor de variação (-Fe0F), que está incluído aqui. |
non_qualified | Para emoji que também possui uso sem um seletor de variação, essa versão está incluída aqui (caso contrário, é nulo). |
docomo , au ,softbank , google | Os pontos codePoints do Legacy Unicode usados por vários fornecedores móveis. |
image | O nome do arquivo de imagem. |
sheet_x , sheet_y | A posição da imagem nas folhas de sprites. |
short_name | O comumente acordado em nome curto para a imagem, conforme suportado em fogueira, github etc via: cólon-sintax: |
short_names | Uma matriz de todos os nomes curtos conhecidos. |
text | Uma versão ASCII do emoji (por exemplo :) ), ou nulo onde não existe. |
texts | Uma variedade de emoji ascii que deve se converter neste emoji. Cada emoji ascii só aparecerá contra uma única entrada emoji. |
category , subcategory | Nomes de categorias e grupos de subcategoria. |
sort_order | Índice de classificação global para todos os emoji, com base na ordem do Unicode CLDR. |
added_in | Versão emoji na qual essa sequência/sequência foi adicionada (versão anterior Unicode). |
has_img_* | Um sinalizador para se o conjunto de imagens fornecido possui uma imagem (nomeada pelo suporte da imagem) disponível. |
skin_variations | Para emoji com múltiplas variações de tom de pele, uma lista de glifos alternativos, chaveada pelo tom da pele. Para emoji que suporta vários tons de pele em um único emoji, cada tom de pele é separado por um caractere de traço. |
obsoletes , obsoleted_by | Emoji que não são mais usados, em preferência de versões de gênero. |
Para cada conjunto de imagens (Apple, Google, etc.), geramos várias "folhas de sprite" diferentes - imagens grandes de todos os emoji costurados.
Toda imagem emoji na folha tem uma borda transparente de 1 pixel ao redor, então a folha de 64px é realmente composta de quadrados de 66px, enquanto a folha de 16px é realmente composta de quadrados de 18 px, etc. Você pode encontrar a posição de qualquer imagem dada Em uma folha usando as propriedades sheet_x e sheet_y , como segue:
x = (sheet_x * (sheet_size + 2)) + 1;
y = (sheet_y * (sheet_size + 2)) + 1;
Dentro do repositório Git, você encontrará algumas folhas no diretório raiz e algumas nos diretórios sheets-indexed-128 , sheets-indexed-256 sheets-clean . Nos pacotes NPM, você os encontrará nos caminhos img/{$set}/sheets* . Por exemplo:
| Repo Git | Pacotes NPM |
|---|---|
| /sheet_apple_16.png | /img/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 | /img/apple/sheets-clean/16.png |
Nesses exemplos, o conjunto de imagens é da Apple e as imagens são de 16 px de um lado. As folhas na linha superior são de 24 bits, enquanto as folhas na fila do meio usam uma paleta de cores indexada com apenas 128 cores. Isso torna a imagem muito menor, mas sacrifica muita qualidade. São fornecidas 128 folhas de cores e 256 folhas de cores. As folhas na linha inferior não contêm fallbacks para imagens ausentes, portanto a folha do Google contém apenas imagens do Google (e não fallbacks da Apple). Isso significa que algumas imagens são substituídas pelo personagem de fallback (um ponto de interrogação), mas os direitos de uso são mais simples.
Veja mudanças.md
As imagens são extraídas de suas fontes e essa biblioteca tenta rastrear as mais recentes versões disponíveis. Se você está procurando versões mais antigas de imagens Apple ou Android (como o coração peludo), precisará analisar as revisões anteriores.
| Conjunto de imagens | Versão de origem | Emoji apoiado | Imagens ausentes |
|---|---|---|---|
| Maçã | iOS 17.4 Beta | Emoji 15.1 | 3 |
| Noto emoji, v2.042 | Emoji 15.1 | 0 | |
| Twemoji (garfo), v15.0.3 | Emoji 15.0 | 118 | |
| V9, buscou 2024-02-05 | Emoji 15.0 | 142 |
Se você usar as imagens da folha de sprite e estiver preocupada com os direitos de uso, use as versões 'limpas', que evitam usar imagens de fallback para falta emoji (consulte a seção SpriteSheet acima para obter mais detalhes).
