Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: DI-2290

Ativa o foco em um determinado componente presente na tela.


Image Added

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. 


Image Added

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. 


Image Added

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.


Image Added

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

Nesta página

Índice

Focar componente

Essa função é utilizada para focar um determinado componente  passado como parâmetro.

NomeTipoDocParâmetro 1ObjectRecebe do formulário selecionado, o id do componente que será focado

Compatibilidade

blockly_server.pngImage Removed Servidor

Image Removed Cliente

Exemplo

Após atribuir o bloco ao formulário "Formulários/Web/Autenticado/home

Tooltip
onlyIcontrue
appendIconinfo-circle

"src/main/webapp/views/logged/home.view.html"

", selecionamos o componente que o foco do cursor estará, para esse exemplo, selecionamos o componente de Entrada de texto (Figura 1), após isso, atribuímos a função à um componente botão, com isso, após salvarmos tudo e executarmos o projeto, clicaremos no botão para que o componente selecionado receba o foco, como mostrado na Figura 2, o campo de texto ja foi clicado com o mouse após clicarmos no botão.

Image Removed

Figura 1 - Bloco Focar componente

Image Removed

Figura 2 - O bloco de texto foi clicado pelo cursor assim podendo digitar

Vincular formulário

Para selecionar Valor (ng-model) da Grade no parâmetro id, é necessário apontar a view desejada no campo Formulário de referência das configurações do Editor de Bloco de programação.

Informações
titleMais sobre
Veja mais detalhes no tópico "Propriedades do Blockly" em Bloco de programação.