Definir valor do atributo / Change attribute value

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