Define se um componente ficará visível ou não na view.
![](/download/attachments/232293543/DefinirVisibilidadeBloco.png?version=1&modificationDate=1715629206000&api=v2)
Figura 1 - Bloco Definir visibilidade
Compatibilidade
- Bloco cliente: cronapi.screen.setVisibility()
- Bloco servidor: cronapi.screen.setVisibility() - executado a partir da chamada do bloco cliente.
Retorno
Bloco não possui retorno.
Parâmetros
Obter identificador
Componente a ter sua visibilidade alterada, é aceito tanto Identificador (id
) quanto o Valor (ng-model
). Para selecionar o Identificador(id
) ou Valor (ng-model
) do componente, é necessário apontar a view desejada no campo Formulário de referência das configurações do Editor de Bloco de programação. Veja mais detalhes no tópico "Propriedades do Blockly" em Bloco de programação.
- Posição: 1
- Inglês: Get identifier
- Tipo: Objeto / Object
- Exemplo: "
crn-textinput-290034
"
Visível?
Define se o componente informado ficará visível ou não. Se "Verdadeiro", o componente será exibido, se "Falso", o componente será ocultado.
- Posição: 2
- Inglês: Visible?
- Tipo: Boleano / Boolean
- Exemplo: Falso
Exemplo
Após vincular um formulário de referência nas configurações do bloco, a função abaixo recebe o bloco Definir visibilidade e seus parâmetros estão configurados da seguinte forma:
- Obter identificador: valor da propriedade Identificador(
id
) do componente que deseja alterar a visibilidade. - Visível?: selecionaremos Falso para esconder o componente.
![](/download/attachments/232293543/DefinirVisibilidadeFuncao.png?version=1&modificationDate=1715629206000&api=v2)
Figura 2 - Função que define se um item ficará ou não visível
O id passado no primeiro parâmetro do bloco pertence ao componente Entrada de texto que inserimos na view (Figura 2.1).
![](/download/attachments/232293543/DefinirVisibilidadeResultadoEntradaDeTexto.png?version=1&modificationDate=1715629206000&api=v2)
Função 2.1 - Componente Entrada de texto
A função foi atribuída ao evento Ao Clicar do botão. Ao acionar o botão "Esconder componente", na aplicação, o componente Entrada de texto deixará de ficar visível, pois a opção Falso foi inserida no parâmetro Visível? (Figura 2).
![](/download/attachments/232293543/DefinirVisibilidadeResultadoEsconder.png?version=1&modificationDate=1715629206000&api=v2)
Figura 2.2 - Formulário com os componentes Botão e Entrada de texto
Para que o componente apareça novamente, inserimos a função no botão "Exibir componente" com a opção Verdadeiro selecionado no parâmetro Visível?.
![](/download/attachments/232293543/DefinirVisibilidadeResultadoExibir.png?version=1&modificationDate=1715629206000&api=v2)
Figura 2.3 - Após clicar no botão Exibir componente