emoji data
1.0.0
Dieses Projekt liefert einfach zu Eltern über Emoji sowie ein Spritesheet-Stil für die Verwendung im Web.
Die aktuelle Version unterstützt Emoji Version 15.1 (September 2023)
Sie können hier einen Katalog der Emoji-Daten sehen: http://projects.iamcal.com/emoji-data/table.htm
Das Git Repo ist ziemlich groß (fast 4 GB), enthält aber alles. Wenn Sie npm verwenden möchten, können Sie:
npm install emoji-datasource
Dadurch werden nur die 32px-Full-Fidelity-Spritesschenseets (mit Fallback-Bildern) installiert. Wenn Sie unterschiedliche Größenblätter (16, 20 oder 64px), quantisierte Blätter (128 oder 256 Farbe), Nicht-Fallback (sauber) oder die einzelnen Bilder (bei 64px) möchten, müssen Sie zusätzliche NPM-Module installieren:
npm install emoji-datasource-apple
npm install emoji-datasource-google
npm install emoji-datasource-twitter
npm install emoji-datasource-facebookSie können es auch verwenden, ohne über JSDelivr CDN (verschiedene Größen hier) herunterzuladen.
Die gewünschte Datei ist emoji.json . Es enthält eine Reihe von Einträgen für Emoji, die so aussehen:
[
{
"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 "
},
...
]Die Bedeutung jedes Feldes lautet wie folgt:
| Felder | Beschreibung |
|---|---|
name | Der offizielle Unicode -Name in Shouty Großbuchstaben. |
unified | Der Unicode-CodePoint als 4-5 Sechskantig. Wenn ein Emoji 2 oder mehr CodePoint benötigt, werden sie wie 1F1ea-1f1f8 angegeben. Für Emoji, die einen Variationswähler (-Fe0f) spezifizieren müssen, ist dies hier enthalten. |
non_qualified | Für Emoji, die auch ohne Variationswähler verwendet werden, ist diese Version hier enthalten (ansonsten ist NULL). |
docomo , au ,softbank , google | Die Legacy Unicode -CodePoints, die von verschiedenen mobilen Anbietern verwendet werden. |
image | Der Name der Bilddatei. |
sheet_x , sheet_y | Die Position des Bildes in den Spritschöhen. |
short_name | Die häufig auf den Kurznamen für das Bild, wie in Lagerfeuer, Github usw. unterstützt: Dickdarm-Syntax: |
short_names | Ein Anteil aller bekannten kurzen Namen. |
text | Eine ASCII -Version des Emoji (z. B. :) ) oder null, wo keiner existiert. |
texts | Eine Reihe von ASCII -Emoji, die in diesen Emoji umgewandelt werden sollte. Jeder ASCII -Emoji erscheint nur gegen einen einzelnen Emoji -Eintrag. |
category , subcategory | Gruppennamen Kategorie und Unterkategorie. |
sort_order | Global Sorting Index für alle Emoji, basierend auf der Unicode -CLDR -Bestellung. |
added_in | Emoji -Version, in der diese CodePoint/Sequenz hinzugefügt wurde (zuvor Unicode -Version). |
has_img_* | Ein Flag, ob der angegebene Bildsatz ein Bild (benannt von der Image Prop) zur Verfügung steht. |
skin_variations | Für Emoji mit mehreren Hautton -Variationen einer Liste alternativer Glyphen, die durch den Hautton gekennzeichnet sind. Für Emoji, die mehrere Hauttöne innerhalb eines einzelnen Emoji unterstützen, wird jeder Hautton durch einen Armaturenbrettcharakter getrennt. |
obsoletes , obsoleted_by | Emoji, die nicht mehr verwendet werden, bevorzugen geschlechtsspezifische Versionen. |
Für jeden Bildsatz (Apple, Google usw.) generieren wir verschiedene "Sprite -Blätter" - große Bilder aller Emoji, die zusammengenäht sind.
Jedes Emoji -Bild im Blatt hat einen transparenten 1 -Pixel Auf einem Blatt unter Verwendung der Eigenschaften sheet_x und sheet_y wie folgt:
x = (sheet_x * (sheet_size + 2)) + 1;
y = (sheet_y * (sheet_size + 2)) + 1;
Im Git-Repo finden Sie einige Blätter im Wurzelverzeichnis und einige in den sheets-indexed-128 , sheets-indexed-256 und sheets-clean . In den NPM -Paketen finden Sie sie unter den Pfaden img/{$set}/sheets* . Zum Beispiel:
| Git Repo | NPM -Pakete |
|---|---|
| /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 |
In diesen Beispielen stammt der Bildsatz von Apple und die Bilder sind 16px auf einer Seite. Die Blätter in der oberen Reihe haben 24 -Bit -Farben, während die Blätter in der mittleren Reihe eine indizierte Farbpalette mit nur 128 Farben verwenden. Dies macht das Bild viel kleiner, opfert aber viel Qualität. Sowohl 128 Farben als auch 256 Farbblätter sind bereitgestellt. Die Blätter in der unteren Zeile enthalten keine Fallbacks für fehlende Bilder, daher enthält das Google -Blatt nur Google -Bilder (und keine Apple Fallbacks). Dies bedeutet, dass einige Bilder durch den Fallback -Charakter (ein Fragezeichen) ersetzt werden, aber die Nutzungsrechte sind einfacher.
Siehe Änderungen.md
Bilder werden aus ihren Quellen extrahiert und diese Bibliothek versucht, die neuesten verfügbaren Versionen zu verfolgen. Wenn Sie nach älteren Versionen von Apple- oder Android -Bildern (wie dem haarigen Herzen) suchen, müssen Sie sich frühere Überarbeitungen ansehen.
| Bildsatz | Quellversion | Unterstützte Emoji | Fehlende Bilder |
|---|---|---|---|
| Apfel | iOS 17.4 Beta | Emoji 15.1 | 3 |
| Noto Emoji, v2.042 | Emoji 15.1 | 0 | |
| Twemoji (Fork), v15.0.3 | Emoji 15.0 | 118 | |
| V9, abgerufen 2024-02-05 | Emoji 15.0 | 142 |
Wenn Sie die Spritesheet -Bilder verwenden und sich über Verwendungsrechte besorgt sind, verwenden Sie bitte die "sauberen" Versionen, die vermeiden, dass Fallback -Bilder für fehlende Emoji verwendet werden (siehe Abschnitt mit Spritesheet oben, um weitere Informationen zu erhalten).
