Skip to content

Trabalhando com Eventos e Ações no App Builder

No App Builder, um aspecto-chave da criação de aplicações interativas e responsivas é o uso efetivo de eventos e ações. Esta funcionalidade é crucial para integrar componentes com gerenciamento de variáveis e interações do usuário.

Entendendo Manipuladores de Eventos de Componentes

App Builder expõe vários manipuladores de eventos de componentes, que são fundamentais no contexto de gerenciamento de variáveis. Os principais eventos incluem:

  • Evento Seleção Alterada: Utilizado no componente Combo.
  • Evento de Seleção de Linha Alterada: Empregado no componente Grid.
  • Evento de Clique: Disponível para todos os componentes, este evento é usado no contexto de definir uma variável ao clicar.
Note

Para exemplos deste tópico, utilizaremos a Northwind WebAPI.

Ajuste Dinâmico de Tipo de Variável

Os componentes Grid e Combo no App Builder permitem a definição de modos de seleção. De forma interessante, o tipo de variável muda dinamicamente com base no modo de seleção escolhido. Por exemplo, um componente Combo vinculado a um array de clientes em modo de seleção única passará um Objeto Cliente através do contexto do evento para o item selecionado.

Trabalhando com eventos

Manipuladores de Evento OnClick e Contexto de Dados

Cada componente no App Builder é equipado com um manipulador de evento OnClick, que pode ser utilizado no contexto de uma variável. Em cenários envolvendo dados repetidos, você pode acessar o Contexto de Dados para um item específico através da ação OnClick -> Definir variável. Este recurso permite a modificação de um valor de variável com base na interação do usuário, como demonstrado no exemplo de componente de árvore.

Exemplo de clique

Manipulando Componente Combo com valueKey

Um aspecto notável do componente Combo é seu comportamento com o atributo valueKey definido. O componente Combo passa um valor primitivo durante o evento Selection changed. Por exemplo, se CustomerID for definido como valueKey, um número é passado; se CustomerName for definido, uma string é passada.

Nota sobre a chave de valor do Combo

Pontos-Chave

  • Interatividade Orientada por Eventos: Os manipuladores de eventos do App Builder como Seleção Alterada e eventos de Clique permitem interações dinâmicas dentro das aplicações.
  • Integração de Gerenciamento de Variáveis: Estes eventos estão perfeitamente integrados com o gerenciamento de variáveis, permitindo aplicações reativas orientadas por dados.
  • Tipos de Variáveis Dinâmicos: A capacidade de mudar dinamicamente tipos de variáveis com base nos modos de seleção de componentes aumenta a flexibilidade do tratamento de dados.
  • Acesso ao Contexto de Dados do OnClick: O manipulador de evento OnClick fornece acesso ao contexto de dados, crucial para manipular variáveis com base nas interações do usuário.
  • Flexibilidade do Componente Combo: O recurso valueKey em componentes Combo demonstra a flexibilidade do App Builder em lidar com diferentes tipos de dados.
  • Experiência de Usuário Aprimorada: Esses recursos contribuem coletivamente para uma aplicação mais interativa e amigável ao usuário, alinhando-se com os objetivos de plataformas de desenvolvimento low-code.

Recursos Adicionais