API do IME

O Internet Explorer 11 apresenta um conjunto de APIs que permitem aos aplicativos Web oferecer uma melhor experiência de entrada de IME. Por exemplo, a API do IME fornece informações de composição para sugestões de preenchimento automático ou pesquisa e permite evitar colisões de interface do usuário entre uma janela de candidatos do IME e uma lista de sugestões de pesquisa.

A implementação do IE11 é baseada na proposta da API do IME da Microsoft para o W3C (World Wide Web Consortium). O suporte total a esse recurso está disponível nos IMEs nativos do Windows 8.1 , incluindo aqueles disponíveis para o Internet Explorer na interface do usuário do Windows e nos aplicativos da Windows Store em JavaScript. O Internet Explorer para área de trabalho no Windows 8.1 e no Windows 7 é parcialmente compatível. Nesses casos, os IMEs para determinadas linguagens podem não permitir todas as APIs listadas aqui.

O objeto MSInputMethodContext

O MSInputMethodContext representa a funcionalidade do IME para um único elemento e fornece informações sobre o status atual da composição IME. Use o método msGetInputMethodContext para obter o MSInputMethodContext de um determinado elemento:


var testElement = document.getElementById("test");
var testElementIMEContext = testElement.msGetInputMethodContext();

Você pode registrar manipuladores para os seguintes eventos MSInputMethodContext:

EventoDescrição

candidatewindowshow

É disparado logo depois que a janela de candidados do IME é definida para exibição, mas antes que ela seja renderizada.

candidatewindowupdate

É disparado após a identificação de que a janela de candidatos do IME precisa mudar de tamanho, mas antes da renderização de atualizações visuais.

candidatewindowhide

É disparado depois que a janela de candidados do IME fica totalmente oculta.

 

O objeto MSInputMethodContext tem as seguintes propriedades:

PropriedadeDescrição

target

Retorna o elemento associado a MSInputMethodContext.

compositionStartOffset

Retorna o deslocamento inicial (posição do caractere) da composição em relação ao destino quando uma composição está ocorrendo, ou retorna zero quando não existe uma composição em andamento.

compositionEndOffset

Retorna o deslocamento final (posição do caractere) da composição em relação ao destino quando uma composição está ocorrendo, ou retorna zero quando não existe uma composição em andamento.

 

O objeto MSInputMethodContext dá suporte para os seguintes métodos:

MétodoDescrição

hasComposition

Retorna "true" quando existe uma composição em andamento; caso contrário, retorna "false".

getCompositionAlternatives

Retorna uma cópia da lista atual de cadeias candidatas alternativas do objeto MSInputMethodContext.

isCandidateWindowVisible

Retorna true se a interface do usuário da janela do candidato ao IME está visível e falso em caso contrário.

getCandidateWindowClientRect

Retorna um objeto ClientRect com as informações de espaço de coordenadas da janela de candidatos (se a janela de candidatos do IME estiver visível).

 

Suporte para CSS

Além disso, o IE11 apresenta uma nova propriedade de CSS para controlar o alinhamento de janela de candidatos do IME:

PropriedadeDescrição

-ms-ime-align

Alinha a caixa da janela de candidatos do IME em relação ao elemento no qual a composição do IME está ativa. Os seguintes valores têm suporte:

auto

Valor inicial. O IME pode alinhar a janela de candidatos de qualquer maneira.

after

O IME deve tentar alinhar a janela de candidatos abaixo do elemento (em layouts da esquerda para a direita e da direita para a esquerda).

 

Postagens no blog do IE

Criação da melhor experiência de entrada para usuários do leste asiático com a API do IME em IE11

 

 

Mostrar:
© 2014 Microsoft