/
Focar componente / Focus component

Focar componente / Focus component

Ativa o foco em um determinado componente presente na tela.

Figura 1 - Bloco Focar componente

Compatibilidade

  • Bloco cliente: cronapi.screen.focusComponent()

  • Bloco servidor: cronapi.screen.focusComponent() - executado a partir da chamada do bloco cliente.

Retorno

Bloco não possui retorno.

Parâmetros

id

Identificador (id) do componente que será focado. Para selecioná-lo, é necessário vincular o bloco de programação a um formulário de referência, confira no tópico Propriedades do Blockly da documentação Bloco de Programação.

  • Posição: 1

  • Inglês: id

  • Tipo: Objeto / Object

  • Exemplo: "crn-textinput-290605"

Exemplo

A função a seguir apresenta um exemplo de uso do bloco Focar componente. Após vincular um formulário de referência nas configurações do Editor, selecionamos, no parâmetro id do bloco, o identificador de um componente entrada de texto presente no formulário. 

Figura 2 - Função que foca um componente

 

A figura 2.1 apresenta a view antes da ativação do botão. Como pode-se observar, a view possui dois componentes entrada de texto, onde o primeiro se refere ao nome do usuário e o segundo, o endereço. Inicialmente inserimos dados apenas no primeiro componente. 

Figura 2.1 - Resultado antes da execução da função

 

Ao acionar o botão "Focar Componente", alteramos o foco para o segundo componente entrada de texto, que passa a conter o cursor de digitação.

Figura 2.2 - Resultado após a execução da função

Nesta página