Definir valor do atributo / Change attribute value
Função que define ou modifica um atributo de um elemento HTML de um componente visual.
Figura 1 - Bloco Definir valor do atributo
Compatibilidade
Bloco cliente: cronapi.screen.changeAttrValue()
Bloco servidor: cronapi.screen.changeAttrValue() - executado a partir da chamada do bloco cliente.
Retorno
Bloco não possui retorno.
Parâmetros
Obter identificador
Identificador (id) do componente que terá seu atributo modificado. 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: Get Identifier
Tipo: Objeto / Object
Exemplo: "
crn-anchor-583179"
Nome do atributo
Nome do atributo que terá seu valor definido ou modificado.
Posição: 2
Inglês: Attribute name
Tipo: Texto / String
Exemplo: "
href"
Valor do atributo
Valor que será atribuído ao atributo.
Posição: 3
Inglês: Attribute value
Tipo: Texto / String
Exemplo: "
#/home/logged/home"
Exemplo
A função a seguir apresenta um exemplo de uso do bloco Definir valor do atributo. Após vincular um formulário de referência nas configurações do blockly, selecionamos, no parâmetro Identificador do bloco, o identificador (id) de um componente link (web) presente no formulário.
Figura 2 - Exemplo de uso do bloco Definir valor do atributo
A imagem abaixo apresenta o resultado de execução da função da Figura 2, a qual foi associada ao evento "Ao clicar" do botão "Definir valor do atributo". Como pode-se observar, inicialmente, o componente link (web) não possui nenhum valor no seu atributo href (destaque 1 da Figura 2.1). Após clicar no botão do formulário, a função é executada e o novo valor é atribuído ao atributo href (destaque 2).
Figura 2.1 - Resultado de execução da função da Figura 2
Nesta página