Sobre o projeto
Twemoji é uma biblioteca e coleção de arte de emoji projetada para fazer com que os emoji padrão do Unicode sejam exibidos de forma consistente em diferentes plataformas. A versão 14.0 segue o Unicode 14.0 e o Emoji 14.0, abrangendo emoji definidos pelo Unicode recomendados para intercâmbio geral; não suporta emoji personalizados.
A biblioteca JavaScript pode ser carregada de uma CDN como unpkg ou baixada dos ativos compilados do repositório. Sua API principal é twemoji.parse, que pode processar um HTMLElement ou uma string. A análise DOM é recomendada porque substitui emoji apenas em nós de texto, preserva elementos e listeners ao redor e evita innerHTML. A análise de string é documentada como legado e não sanitiza a entrada.
A análise é configurável por meio de opções para o callback de URL da imagem, caminho base, extensão do arquivo, classe CSS, tamanho e pasta de ativos. A saída padrão usa imagens PNG, enquanto ativos SVG podem ser selecionados definindo a pasta e a extensão de acordo. As imagens geradas incluem texto alternativo acessível contendo o emoji original. A biblioteca também fornece auxiliares para converter entre codepoints hexadecimais e pares substitutos UTF-16.
A documentação inclui orientações CSS para dimensionar emoji em relação ao texto ao redor, lembra os desenvolvedores de declarar UTF-8 e mostra como um callback pode excluir caracteres específicos, como símbolos de copyright ou marca registrada. O código é lançado sob a licença MIT, enquanto os gráficos são lançados sob CC-BY 4.0 com atribuição aceita em lugares como um README, seção Sobre, rodapé do site ou código-fonte. O README também lista integrações comunitárias relacionadas para Ruby, PHP, .NET, Vue, JavaFX, LaTeX, fontes e outros ambientes.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.