이 프로젝트는 웹에서 사용할 수있는 스프리 시트 스타일 이미지와 함께 이모티콘에 대한 패러스의 데이터를 제공합니다.
현재 버전은 이모티콘 버전 15.1 (2023 년 9 월)을 지원합니다.
이모티콘 데이터의 카탈로그를 여기에서 볼 수 있습니다 : http://projects.iamcal.com/emoji-data/table.htm
git repo는 꽤 크지 만 (거의 4GB) 모든 것이 포함되어 있습니다. npm
사용하려면 다음을 수행 할 수 있습니다.
npm install emoji-datasource
이렇게하면 32px Full Fidelity Spritesheets (폴백 이미지 포함) 만 설치합니다. 다른 크기 시트 (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 | 외부 유니 코드 이름, 외형 대문자. |
unified | 유니 코드 코드 포인트 (4-5 16 진수). 이모티콘에 2 개 이상의 코드 포인트가 필요한 경우 1F1EA-1F1F8과 같이 지정됩니다. 변형 선택기 (-fe0f)를 지정 해야하는 이모티콘의 경우 여기에 포함됩니다. |
non_qualified | 변형 선택기가없는 사용이있는 이모티콘의 경우 해당 버전이 여기에 포함됩니다 (그렇지 않으면 NULL). |
docomo , au ,softbank , google | 다양한 모바일 공급 업체가 사용하는 레거시 유니 코드 코드 포인트. |
image | 이미지 파일의 이름. |
sheet_x , sheet_y | 스프리 시트에서 이미지의 위치. |
short_name | Colon-Syntax : Colon-Syntax를 통해 캠프 파이어, github 등에서 지원되는 이미지의 짧은 이름으로 일반적으로 합의됩니다. |
short_names | 알려진 모든 짧은 이름의 배열. |
text | 이모티콘의 ASCII 버전 (예 :) ) 또는 존재하지 않는 경우 널. |
texts | 이 이모티콘으로 변환 해야하는 ASCII 이모티콘 배열. 각 ASCII 이모티콘은 단일 이모티콘 항목에 대해서만 나타납니다. |
category , subcategory | 카테고리 및 하위 범주 그룹 이름. |
sort_order | 유니 코드 CLDR 주문을 기반으로 모든 이모티콘의 글로벌 분류 색인. |
added_in | 이 코드 포인트/시퀀스가 추가 된 이모티콘 버전 (이전 유니 코드 버전). |
has_img_* | 주어진 이미지 세트에 이미지 (이미지 소품으로 명명)가 있는지 여부에 대한 플래그. |
skin_variations | 여러 피부 톤 변화가있는 이모티콘의 경우 피부 톤으로 키워진 대체 글리프 목록입니다. 단일 이모티콘 내에서 여러 피부 톤을지지하는 이모티콘의 경우 각 피부색은 대시 특성으로 분리됩니다. |
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 | /img/apple/sheets/16.png |
/sheets-indexed-128/sheet_apple_16_indexed_128.png | /img/apple/sheets-128/16.png |
/Sheets-slean/sheet_apple_16_clean.png | /img/apple/sheets-clean/16.png |
이 예에서 이미지 세트는 Apple에서 나 왔으며 이미지는 측면에서 16px입니다. 상단 행의 시트는 24 비트 색상이며 중간 행의 시트는 128 개의 색상의 색인화 된 색상 팔레트를 사용합니다. 이것은 이미지를 훨씬 작게 만들지 만 많은 품질을 희생합니다. 128 개의 색상과 256 개의 컬러 시트가 제공됩니다. 맨 아래 줄의 시트에는 누락 된 이미지의 폴백이 포함되어 있지 않으므로 Google 시트에는 Google 이미지 만 포함되어 있으며 Apple 낙하가 포함되어 있습니다. 이는 일부 이미지가 폴백 문자 (물음표)로 대체되지만 사용 권한이 더 간단하다는 것을 의미합니다.
changes.md를 참조하십시오
이미지는 소스에서 추출 되며이 라이브러리는 최신 버전을 추적하려고 시도합니다. 이전 버전의 Apple 또는 Android 이미지 (예 : 털이 많은 심장)를 찾고 있다면 이전 개정을 살펴 봐야합니다.
이미지 세트 | 소스 버전 | 지원 된 이모티콘 | 누락 된 이미지 |
---|---|---|---|
사과 | iOS 17.4 베타 | 이모티콘 15.1 | 3 |
노토 이모티콘, v2.042 | 이모티콘 15.1 | 0 | |
지저귀다 | Twemoji (포크), v15.0.3 | 이모티콘 15.0 | 118 |
페이스 북 | V9, 2024-02-05를 가져 왔습니다 | 이모티콘 15.0 | 142 |
Spritesheet 이미지를 사용하고 사용 권한에 대해 우려하는 경우, '깨끗한'버전을 사용하여 이모티콘 누락에 대한 폴백 이미지를 사용하지 않도록하십시오 (자세한 내용은 위의 Spritesheet 섹션 참조).