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