Consulta JavaScript
Há casos em que você deseja orquestrar operações, por exemplo, após acionar duas consultas, deseja combinar e armazenar seus resultados em um estado temporário e, em seguida, abrir um modal. Este processo pode ser complicado ao encadear vários manipuladores de eventos e certamente não pode ser feito em uma linha de código em {{ }}
. É aí que entra a consulta JavaScript (JS). Ela libera a capacidade de interagir com componentes e consultas escrevendo consultas JS complexas para realizar as seguintes operações:
Interagir com componentes da UI
Acionar consultas
Acessar bibliotecas JS de terceiros
Personalizar funções
O exemplo a seguir é para você entender rapidamente o que é consulta JS e como ela funciona.
Retorna dados
Use a sintaxe return
para retornar o resultado. Por exemplo, o código a seguir retorna 3
.
O resultado retornado também pode ser um objeto Promise. Por exemplo, query2.run()
retorna um objecto promise.
A instrução return
não é necessária para cenários onde você deseja omitir resultados.
Acessando dados
Use consultas JS para acessar dados em seu aplicativo. Observe que não há necessidade de usar a notação {{ }}
.
Controlando Componentes
Em consultas JS, você pode usar métodos expostos por componentes para interagir com componentes de UI em seu aplicativo. Tal operação não é suportada pelo código JS embutido em {{}}
.
O método input1.setValue()
(ou outros métodos componentes) é assíncrono e retorna um objeto Promise. Acessando input1.value
imediatamente após definir o valor de input1
não retorna o valor atualizado.
Executando consulta
run()
método e retornos de chamada
run()
método e retornos de chamadaExecute o método run()
para executar outras consultas, por exemplo:
O valor de retorno de query.run()
é uma promise, então você pode anexar retornos de chamada para lidar com o resultado ou erro bem-sucedido.
Passando parâmetros
Você pode passar parâmetros no método run()
para dissociar a implementação da consulta de seus parâmetros.
Declarando uma função
Você pode declarar funções dentro de uma consulta JS para melhor legibilidade.
Adicionando scripts pré-carregados
PocketBlocks oferece suporte à importação de bibliotecas JS de terceiros e à adição de código JS predefinido, como a adição de métodos ou variáveis globais para reutilização em nível de aplicativo ou nível de espaço de trabalho. Você pode encontrar as configurações no nível do aplicativo em ⚙️ > Outros > Scripts e estilo.
Para nível de espaço de trabalho, acesse ⚙️ Configurações > Avançado.
Na guia JavaScript, você pode adicionar código JavaScript pré-carregado para definir métodos e variáveis globais e reutilizá-los em seu aplicativo. Para importar bibliotecas, consulte Usando biblioteca de terceiros.
Restrições
Por motivos de segurança, diversas variáveis globais e funções de window estão desabilitadas no PocketBlocks. Por favor, reporte ao nosso GitHub se você encontrar algum problema.
Last updated