emoji data
1.0.0
Ce projet fournit des données faciles à classer sur les emoji, ainsi que des images de style spriteheet à utiliser sur le Web.
La version actuelle prend en charge la version 15.1 emoji (sept. 2023)
Vous pouvez voir un catalogue des données emoji ici: http://projects.iamcal.com/emoji-data/table.htm
Le repo git est assez grand (presque 4 Go), mais contient tout. Si vous souhaitez utiliser npm , vous pouvez:
npm install emoji-datasource
Cela n'installera que les spritesheets Full-Fidelity 32px (avec des images de secours). Si vous voulez différentes feuilles de taille (16, 20 ou 64px), des feuilles quantifiées (128 ou 256 couleur), des feuilles non-décalage (propres) ou les images individuelles (à 64px), vous devrez installer des modules NPM supplémentaires:
npm install emoji-datasource-apple
npm install emoji-datasource-google
npm install emoji-datasource-twitter
npm install emoji-datasource-facebookVous pouvez également l'utiliser sans télécharger via JSDelivr CDN (différentes tailles ici).
Le fichier que vous souhaitez est emoji.json . Il contient un tableau d'entrées pour emoji qui ressemblent à ceci:
[
{
"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 "
},
...
]La signification de chaque champ est la suivante:
| Champs | Description |
|---|---|
name | Le nom de l'Unicode officiel, en majuscules Shouty. |
unified | Le codepoint Unicode, à 4 à 5 chiffres hexadécimaux. Lorsqu'un emoji a besoin de 2 points de code ou plus, il est spécifié comme 1F1EA-1F1F8. Pour les emoji qui doivent spécifier un sélecteur de variation (-Fe0f), qui est inclus ici. |
non_qualified | Pour les emoji qui ont également une utilisation sans sélecteur de variation, cette version est incluse ici (sinon est nul). |
docomo , au ,softbank , google | Les points de code Unicode hérités utilisés par divers fournisseurs mobiles. |
image | Le nom du fichier image. |
sheet_x , sheet_y | La position de l'image dans les spritesheets. |
short_name | Le communément agré sur le nom court pour l'image, tel que soutenu dans CampFire, Github, etc. via: Colon-Syntax: |
short_names | Un tableau de tous les noms courts connus. |
text | Une version ASCII de l'emoji (par exemple :) ), ou null où aucune n'existe. |
texts | Un tableau d'emoji ASCII qui devrait se convertir en cet emoji. Chaque emoji ASCII n'apparaîtra qu'à une seule entrée emoji. |
category , subcategory | Catégorie et noms de groupes de sous-catégorie. |
sort_order | Indice de tri global pour tous les emoji, basé sur l'ordre CLDR UNICODE. |
added_in | Version emoji dans laquelle cette séquence CodePoint / Séquence a été ajoutée (version précédemment Unicode). |
has_img_* | Un drapeau pour savoir si l'ensemble d'images donné a une image (nommée par l'image prop) disponible. |
skin_variations | Pour les emoji avec plusieurs variations de teint, une liste de glyphes alternatifs, clés par le teint. Pour les emoji qui prennent en charge plusieurs tons de peau dans un seul emoji, chaque teint est séparé par un caractère de tableau de bord. |
obsoletes , obsoleted_by | Emoji qui ne sont plus utilisés, en préférence des versions sexospécifiques. |
Pour chaque ensemble d'images (Apple, Google, etc.), nous générons plusieurs "feuilles de sprite" différentes - grandes images de tous les emoji cousus ensemble.
Chaque image emoji de la feuille a une bordure transparente de 1 pixel autour de lui, de sorte que la feuille 64px est vraiment composée de carrés de 66 pixes, tandis que la feuille 16px est vraiment composée de carrés 18px, etc. Vous pouvez trouver la position d'une image donnée Sur une feuille à l'aide des propriétés sheet_x et sheet_y , comme suit:
x = (sheet_x * (sheet_size + 2)) + 1;
y = (sheet_y * (sheet_size + 2)) + 1;
À l'intérieur du Git Repo, vous trouverez des draps dans le répertoire racine et d'autres dans les répertoires sheets-indexed-128 , sheets-indexed-256 et sheets-clean . Dans les packages NPM, vous les trouverez sous les chemins img/{$set}/sheets* . Par exemple:
| Givré | Packages 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 |
Dans ces exemples, l'ensemble d'images provient d'Apple et les images sont 16px d'un côté. Les feuilles de la rangée supérieure sont de couleur 24 bits, tandis que les feuilles de la rangée du milieu utilisent une palette de couleurs indexée avec seulement 128 couleurs. Cela rend l'image beaucoup plus petite, mais sacrifie beaucoup de qualité. 128 couleurs et 256 feuilles de couleur sont fournies. Les feuilles de la rangée inférieure ne contiennent pas de secours pour les images manquantes, de sorte que la feuille Google ne contient que des images Google (et pas de replies Apple). Cela signifie que certaines images sont remplacées par le caractère de secours (un point d'interrogation), mais les droits d'utilisation sont plus simples.
Voir change.md
Les images sont extraites de leurs sources et cette bibliothèque tente de suivre les dernières versions disponibles. Si vous recherchez des versions plus anciennes d'Apple ou Android Images (comme le cœur velu), vous devrez examiner les révisions précédentes.
| Ensemble d'images | Version source | Emoji soutenu | Images manquantes |
|---|---|---|---|
| Pomme | iOS 17.4 Beta | Emoji 15.1 | 3 |
| Noto emoji, v2.042 | Emoji 15.1 | 0 | |
| Gazouillement | Twemoji (fourche), v15.0.3 | Emoji 15.0 | 118 |
| v9, récupéré 2024-02-05 | Emoji 15.0 | 142 |
Si vous utilisez les images Spitesheet et que vous vous souciez des droits d'utilisation, veuillez utiliser les versions «Clean», qui évitent d'utiliser des images de secours pour manquer des emoji (voir la section Spritesheet ci-dessus pour plus de détails).
