emoji data
1.0.0
Este proyecto proporciona datos fáciles de parecer sobre emoji, junto con imágenes de estilo spritheet para su uso en la web.
La versión actual admite Emoji versión 15.1 (septiembre de 2023)
Puede ver un catálogo de los datos de emoji aquí: http://projects.iamcal.com/emoji-data/table.htm
El Repo Git es bastante grande (casi 4 GB), pero contiene todo. Si desea usar npm , puede:
npm install emoji-datasource
Esto solo instalará las hojas de sprits de fidelidad de 32px (con imágenes respaldadas). Si desea sábanas de diferentes tamaños (16, 20 o 64 px), sábanas cuantificadas (128 o 256 color), hojas no caídas (limpias) o las imágenes individuales (a 64 px), entonces deberá instalar módulos NPM adicionales:
npm install emoji-datasource-apple
npm install emoji-datasource-google
npm install emoji-datasource-twitter
npm install emoji-datasource-facebookTambién puede usarlo sin descargar a través de JSDelivr CDN (diferentes tamaños aquí).
El archivo que desea es emoji.json . Contiene una variedad de entradas para emoji que se ven así:
[
{
"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 "
},
...
]El significado de cada campo es el siguiente:
| Campos | Descripción |
|---|---|
name | El nombre de Unicode oficial, en mayúscula en mayúsculas. |
unified | El punto de código unicode, como dígitos hexadecimales 4-5. Cuando un emoji necesita 2 o más puntos de código, se especifican como 1F1EA-1F1F8. Para emoji que necesitan especificar un selector de variación (-fe0f), que se incluye aquí. |
non_qualified | Para los emoji que también tienen uso sin un selector de variación, esa versión se incluye aquí (de lo contrario, es nulo). |
docomo , au ,softbank , google | Los puntos de código de código UNICODE heredados utilizados por varios proveedores móviles. |
image | El nombre del archivo de imagen. |
sheet_x , sheet_y | La posición de la imagen en las hojas de sprits. |
short_name | El nombre común de la imagen comúnmente acordado para la imagen, según lo compatible en Campfire, GitHub, etc. a través de: colon-syntax: |
short_names | Una serie de todos los nombres cortos conocidos. |
text | Una versión ASCII del emoji (por ejemplo :) ), o nulo donde no existe ninguna. |
texts | Una matriz de emoji ascii que debería convertirse en este emoji. Cada emoji ASCII solo aparecerá contra una sola entrada de emoji. |
category , subcategory | Categoría y nombres de grupos de subcategoría. |
sort_order | Índice de clasificación global para todos los emoji, basado en un orden de unicode CLDR. |
added_in | Versión de emoji en la que se agregó este punto de código/secuencia (anteriormente la versión unicode). |
has_img_* | Una bandera para si el conjunto de imágenes dado tiene una imagen (nombrada por el accesorio de imagen) disponible. |
skin_variations | Para el emoji con múltiples variaciones de tono de piel, una lista de glifos alternativos, con el tono de piel. Para los emoji que admiten múltiples tonos de piel dentro de un solo emoji, cada tono de piel está separado por un carácter de tablero. |
obsoletes , obsoleted_by | Emoji que ya no se usan, en preferencia de versiones de género. |
Para cada conjunto de imágenes (Apple, Google, etc.) generamos varias "sábanas" diferentes: imágenes grandes de todos los emoji cosidos.
Cada imagen de emoji en la hoja tiene un borde transparente de 1 píxel a su alrededor, por lo que la hoja de 64px realmente está compuesta por cuadrados de 66 px, mientras que la hoja de 16 px está realmente compuesta por cuadrados de 18 px, etc. Puede encontrar la posición de cualquier imagen dada en una hoja usando las propiedades sheet_x y sheet_y , como sigue:
x = (sheet_x * (sheet_size + 2)) + 1;
y = (sheet_y * (sheet_size + 2)) + 1;
Dentro del repositorio Git encontrarás algunas hojas en el directorio de la raíz y algunas en las sheets-indexed-128 , sheets-indexed-256 y los directorios sheets-clean . En los paquetes NPM, los encontrará debajo de las rutas img/{$set}/sheets* . Por ejemplo:
| Repo de git | Paquetes de NPM |
|---|---|
| /sheet_apple_16.png | /img/apple/sheets/16.png |
| /sheets-dexed-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 |
En estos ejemplos, el conjunto de imágenes es de Apple y las imágenes son 16px en un lado. Las sábanas en la fila superior tienen un color de 24 bits, mientras que las sábanas en la fila central usan una paleta de colores indexada con solo 128 colores. Esto hace que la imagen sea mucho más pequeña, pero sacrifica mucha calidad. Se proporcionan 128 hojas de color y 256 de color. Las sábanas en la fila inferior no contienen retrocesos para las imágenes faltantes, por lo que la hoja de Google solo contiene imágenes de Google (y no hay fondos de Apple). Esto significa que algunas imágenes se reemplazan por el carácter de alojamiento (un signo de interrogación), pero los derechos de uso son más simples.
Ver cambios.md
Las imágenes se extraen de sus fuentes y esta biblioteca intenta rastrear las últimas versiones disponibles. Si está buscando versiones más antiguas de imágenes de Apple o Android (como el corazón peludo), entonces deberá ver revisiones anteriores.
| Conjunto de imágenes | Versión de origen | Emoji compatible | Imágenes faltantes |
|---|---|---|---|
| Manzana | iOS 17.4 beta | Emoji 15.1 | 3 |
| Noto emoji, v2.042 | Emoji 15.1 | 0 | |
| Gorjeo | Twemoji (tenedor), V15.0.3 | Emoji 15.0 | 118 |
| V9, obtenido 2024-02-05 | Emoji 15.0 | 142 |
Si usa las imágenes de hoja de spriting y está preocupado por los derechos de uso, utilice las versiones 'limpias', que evitan el uso de imágenes respaldadas para emoji faltante (consulte la sección de hoja de spriting anterior para obtener más detalles).
