프로젝트 소개

Twemoji는 표준 유니코드 이모지를 플랫폼 간에 일관되게 표시하기 위한 라이브러리이자 이모지 아트워크 컬렉션입니다. 버전 14.0은 유니코드 14.0 및 이모지 14.0을 따르며, 일반적인 상호 교환에 권장되는 유니코드 정의 이모지를 포함합니다. 사용자 정의 이모지는 지원하지 않습니다. 자바스크립트 라이브러리는 unpkg과 같은 CDN에서 로드하거나 저장소의 빌드된 자산에서 다운로드할 수 있습니다. 주요 API는 twemoji.parse로, HTMLElement 또는 문자열을 처리할 수 있습니다. DOM 파싱은 텍스트 노드에서만 이모지를 대체하고 주변 요소와 리스너를 보존하며 innerHTML을 피하므로 권장됩니다. 문자열 파싱은 레거시로 문서화되어 있으며 입력을 살균하지 않습니다. 파싱은 이미지 URL 콜백, 기본 경로, 파일 확장자, CSS 클래스, 크기 및 자산 폴더에 대한 옵션을 통해 구성할 수 있습니다. 기본 출력은 PNG 이미지를 사용하며, 폴더와 확장자를 설정하여 SVG 자산을 선택할 수 있습니다. 생성된 이미지에는 원래 이모지를 포함하는 접근 가능한 대체 텍스트가 포함됩니다. 라이브러리는 16진수 코드포인트와 UTF-16 서로게이트 쌍 간 변환을 위한 헬퍼도 제공합니다. 문서에는 주변 텍스트에 상대적인 이모지 크기 조정을 위한 CSS 지침, 개발자에게 UTF-8 선언을 상기시키는 내용, 저작권 또는 상표 기호와 같은 특정 문자를 제외할 수 있는 콜백 방법이 포함되어 있습니다. 코드는 MIT 라이선스로 배포되며, 그래픽은 CC-BY 4.0으로 배포되어 README, 소개 섹션, 웹사이트 바닥글 또는 소스 코드와 같은 곳에서 저작자 표시를 인정받습니다. README에는 Ruby, PHP, .NET, Vue, JavaFX, LaTeX, 글꼴 및 기타 환경에 대한 관련 커뮤니티 통합도 나열되어 있습니다.