blockly > IFocusableNode > getFocusableElement

Método IFocusableNode.getFocusableElement()

Retorna o elemento DOM que pode ser solicitado explicitamente para receber o foco.

IMPORTANTE: esse elemento precisa ter uma presença visual na página, já que ele será explicitamente focado e terá o estilo alterado dependendo do estado de foco atual (ou seja, desfocado, focado ativamente e focado passivamente). O elemento terá um dos dois estilos anexados (em que nenhum estilo indica desfocado/sem foco): - blocklyActiveFocus - blocklyPassiveFocus

O elemento retornado também precisa ter um ID válido especificado, e esse ID precisa ser exclusivo em toda a página. Não ter um ID adequadamente exclusivo pode fazer com que a tentativa de focar um nó (por exemplo, com um clique do mouse) leve a outro nó com o mesmo ID sendo focado pelo FocusManager.

O elemento retornado precisa estar visível se o nó for focado usando FocusManager.focusNode() ou FocusManager.focusTree(). É permitido que um elemento fique oculto até que onNodeFocus() seja chamado ou que fique oculto com uma chamada para onNodeBlur().

Espera-se que o elemento retornado não mude durante o ciclo de vida do nó. Ou seja, as propriedades podem mudar, mas um novo elemento nunca deve ser retornado. Além disso, o elemento retornado terá o tabindex substituído durante todo o ciclo de vida desse nó e do FocusManager.

Se um nó precisar ser focado diretamente sem primeiro ser focado pelo FocusManager, ele precisará definir o próprio índice de tabulação.

Signature:

getFocusableElement(): HTMLElement | SVGElement;

Retorna:

HTMLElement | SVGElement

O HTMLElement ou SVGElement que pode receber foco e ser representado visualmente como ativamente ou passivamente focado para este nó.