Label

1. Geral

O componente LABEL é utilizado para exibir textos, que podem ser fixos ou dinâmicos (provenientes do banco de dados). Este componente é ideal para adicionar descrições, títulos, totais, informações gerais de cadastros filtrados, ou qualquer outra informação textual. As interações incluem abrir modais, executar ações, manipular dados por SQL, abrir formulários, entre outras possibilidades.

2. Como Configurar

Arraste para a Tela: Arraste o componente LABEL para a tela onde deseja exibir o texto.

2.1. Dados

Configurar a VIEW: Configure a VIEW através de SQL, VIEW Análise de Dados ou VIEW de Cadastro caso queira alimentar os dados da label com informações provenientes do banco de dados. Ela deve retornar apenas uma linha e uma coluna. 

2.2. Personalizar

2.2.1. Configurações Gerais 

Texto: Insira o texto que será exibido pelo componente. Pode ser usado variáveis para exibir dados dinâmicos na label. Explicação sobre as variáveis no tópico 3 dessa documentação. 

Scroll: caso o conteúdo da label seja maior que o tamanho dela, ao ativar essa opção, será gerado um scroll interno.

Texto selecionável: Permite que o texto seja selecionado pelo usuário para ser possível copiá-lo usando o "Ctrl + C".

Tamanho: Permite definir o tamanho relativo da fonte, que altera de acordo com a resolução do usuário.

Tamanho Mínimo da Fonte (px): Defina o tamanho mínimo da fonte, para evitar que a fonte fique muito pequena em resoluções muito menores. Para mais detalhes, acesse a documentação de "Responsividade".

Fonte: Escolha a fonte do texto.

Formatação de Texto: Ajuste a formatação do texto, incluindo negrito, itálico, sublinhado, cor do texto, alinhamento e estilo.

Cor do Texto: Defina a cor do texto da label.

Cor de Fundo: Defina a cor de fundo da label.

Transparência: Defina a opacidade do label.

Configurar borda: Acesse para configurar o contorno, cor, espessura e arredondamento da borda. 

Dica: Insira uma dica (tooltip) que será exibida ao passar o mouse sobre a label.

Incluir hiperlink: Permite incluir um link que abre em uma nova aba do navegador.

2.2.2. Animação

Transição: Ative para aplicar um efeito de transição que altera a cor de fundo do elemento ao passar o cursor sobre ele.

Cor da transição: Defina a cor do fundo quando o cursor passa sobre o label.

Elevação: Ative para adicionar um efeito de sombreamento que adiciona profundidade aos elementos.

Nível da elevação: Defina o nível da profundidade da elevação. 

2.2.3. Visibilidade Dinâmica

A funcionalidade de Visibilidade Dinâmica permite que a label fique visível ou invisível de acordo com o valor retornado por uma VIEW. O componente desaparecerá se o valor retornado for 0 ou null e aparecerá para qualquer outro número. Esta funcionalidade pode ser aplicada utilizando a VIEW do próprio componente ou a VIEW da tela, oferecendo flexibilidade na configuração e controle do comportamento dos componentes.

• Referenciando a VIEW do próprio componente: Quando configurada para usar a VIEW do próprio componente, a Visibilidade Dinâmica baseia-se na primeira linha e coluna retornada pela VIEW para determinar a visibilidade.

• Referenciando a VIEW da tela: Caso a Visibilidade seja configurada para referenciar a VIEW da tela, o usuário pode especificar a interseção desejada utilizando comandos de variáveis. Por exemplo, o comando "$A1" pode ser usado para pegar o valor da primeira linha e coluna da VIEW da tela.

2.2.4. Reatividade

Escolher manualmente os componentes que serão atualizados: Caso queira entender como e porque usar esta funcionalidade, acesse a documentação "Reatividade".

2.3. Interações

Nenhuma: A label não terá interação.

Ação: Defina uma ação para ser executada ao interagir com a label.

Ação de Database: Permite realizar operações de manipulação de dados, como INSERT, UPDATE, DELETE, ou chamar PROCEDURES.

Formulário: Abra um formulário ao interagir com a label.

Modal: Abra um modal ao interagir com a label.

3. Variáveis

O componente LABEL permite a utilização de variáveis para exibir textos dinâmicos, conectando diretamente os dados retornados pela VIEW ao conteúdo exibido. 

3.1. View Própria da Label

Quando a LABEL utiliza uma VIEW própria, o valor exibido será automaticamente a primeira linha e primeira coluna retornada pela VIEW configurada. Para exibir este valor na LABEL, utilize a variável $value no campo de texto.

3.2. View da Tela

Quando a LABEL utiliza a VIEW geral da tela, é possível referenciar os dados de colunas específicas dessa VIEW utilizando variáveis no formato $A1, $B1, $C1, etc. Essas variáveis indicam os valores da primeira linha de cada coluna da VIEW, de acordo com a ordem exibida na tabela de pré-visualização. Por exemplo, $A1 retorna os dados da primeira coluna, $B1 os da segunda coluna, $C1 os da terceira coluna, e assim sucessivamente.

3.3 Seleções Aplicadas na Tela

A variável $selection é utilizada para exibir todas as seleções e filtros aplicados na tela no momento, como intervalos de datas, categorias escolhidas, entre outros. Essa variável é especialmente útil para demonstrar quais condições ou filtros estão ativos, facilitando a visualização e entendimento dos dados exibidos.

4. Conjuntos de Labels

Os conjuntos de labels são agrupamentos de labels prontos que facilitam a montagem e a exibição de informações de forma organizada, que podem ser alterados para qualquer usabilidade. Nesses conjuntos, os componentes estão agrupados, de modo que ao arrastar, ampliar ou diminuir, todos os elementos do grupo são ajustados juntos. Caso você queira modificar apenas uma label específica dentro do conjunto, será necessário desagrupar os componentes primeiro. Para mais informações sobre como desagrupar, acesse a documentação "Layout de Componentes".

4.1. Cards

São conjuntos de labels mais simples. Eles podem incluir textos, ícones, valores e comparações, dependendo do modelo escolhido. 

4.2. Grupo de Cards

São conjuntos maiores que agrupam múltiplos cards para exibir informações detalhadas e comparativas.

4.3. Headers

São componentes prontos para a exibição de títulos de páginas.