Ir para conteúdo principal Pular para conteúdo complementar

Botão

Você pode usar botões para:

  • adicionar links rápidos para facilitar a seleção e a navegação no seu aplicativo

  • carregar dados

Quando usar

O botão é útil quando você deseja ajudar o usuário do aplicativo, fornecendo:

  • seleções predefinidas ou controles de seleção
  • links de navegação para outras pastas, histórias ou sites
  • funcionalidade de carregamento de dados em um aplicativo

Você pode carregar dados em um aplicativo do qual você é proprietário. Os usuários do aplicativo precisam de direitos de acesso apropriados. Para obter mais informações, consulte Projetando o controle de acesso (somente em inglês).

Exemplo de botões em uso em uma pasta

Quatro botões à medida que aparecem no Qlik Sense.

Criando um botão

Você pode criar um botão na pasta que está editando. Isso mostra como criar um botão que faz uma seleção e depois navega para outra pasta. Também é possível criar um botão que apenas execute a ação ou que navegue.

  1. No painel Ativos, em Gráficos, arraste um objeto Button até a pasta.
  2. Clique em Add action em Actions no painel de propriedades.mm
  3. Selecione a ação que você deseja usar.

    Você precisa fornecer detalhes para algumas ações. Por exemplo, para a ação Selecionar valores em um campo, você precisa selecionar um campo e qual valor selecionar no campo.

  4. Selecione qual opção de navegação usar em Navegação. Você pode navegar para outra pasta, uma história ou um site.
  5. Defina o rótulo do botão no Label em General no painel de propriedades.

Agora você terá um botão que faz uma seleção de dados e depois navega para o local no aplicativo selecionado.

Definindo a ação

Você pode adicionar uma ou mais ações a serem executadas quando o botão é clicado. Você precisa fornecer detalhes para algumas ações.

As ações são executadas na ordem em que estão listadas em Actions. Você pode alterar a ordem de uma ação arrastando-a.

Nota de dicaVocê não precisa adicionar uma ação se quiser apenas que o botão realize a navegação.

Aplicar marcador

Você pode aplicar a seleção definida em um marcador que você escolher.

Limpar todas as seleções

Você pode limpar todas as seleções em todos os estados no aplicativo. Opcionalmente, você pode substituir as seleções bloqueadas.

Limpar seleções em outros campos

Você pode limpar as seleções de todos os campos, exceto o que você especificar. Opcionalmente, você pode substituir as seleções bloqueadas.

Avançar em suas seleções

Você pode avançar um passo no seu histórico de seleção.

Retornar em suas seleções

Você pode mover um passo para trás no seu histórico de seleção.

Limpar seleções em campo

Você pode limpar todas as seleções de um campo que especificar.

Bloquear todas as seleções

Você pode bloquear todas as seleções no aplicativo.

Bloquear um campo específico

Você pode bloquear as seleções em um campo que especificar.

Desbloquear todas as seleções

Você pode desbloquear todas as seleções no aplicativo.

Desbloquear um campo específico

Você pode desbloquear as seleções em um campo que especificar.

Selecionar todos os valores em um campo

Você pode selecionar todos os valores em um campo que especificar. Opcionalmente, você pode substituir as seleções bloqueadas.

Selecionar valores em um campo

Você pode selecionar uma lista de valores em um campo que especificar. Separe os valores a serem selecionados com ponto e vírgula. Opcionalmente, você pode substituir as seleções bloqueadas.

Nota informativaNão é possível usar campos com data, carimbo de data/hora ou o tipo de dados Dinheiro.
Nota informativaEsta ação de botão não seleciona valores numéricos armazenados ou classificados como texto. Para isso, use a ação Selecionar valores que correspondam aos critérios de pesquisa.

Selecionar valores que correspondam aos critérios de pesquisa

É possível selecionar todos os valores que correspondem aos resultados da pesquisa, com base em um critério de pesquisa que você especificar. Os critérios de pesquisa devem ser especificados como uma sequência de caracteres. Opcionalmente, você pode substituir as seleções bloqueadas.

  • Se quiser usar uma expressão, coloque-a entre aspas simples, por exemplo, ='=Sum([Sales Amount]) > 200000'.
  • Se quiser procurar uma sequência parcial, use caracteres curinga (*, ?,^). Se você não usar caracteres curingas, apenas as sequências com correspondência exata serão selecionadas.

Selecionar alternativas

Selecione todos os valores alternativos em um campo que você especificar. Opcionalmente, você pode substituir as seleções bloqueadas.

Selecionar excluídos

Selecione todos os valores excluídos em um campo que você especificar. Opcionalmente, você pode substituir as seleções bloqueadas.

Selecionar possíveis valores em um campo

Selecione todos os valores possíveis em um campo que você especificar. Opcionalmente, você pode substituir as seleções bloqueadas.

Alternar seleção de campo

Você pode definir o botão para alternar entre a seleção atual e uma seleção que adicione seleções definidas por caracteres de busca. Você pode usar caracteres curingas nos caracteres de busca. Se você deseja definir uma lista de valores, precisa usar o formato (A|B), em que A e B são valores para selecionar.

Definir valor da variável

Você pode atribuir um valor a uma variável.

Carregar dados

Você pode executar o script de carregamento para carregar dados.

Você também pode selecionar Carregamento parcial. Para obter mais informações, consulte Carregamento parcial.

Atualizar exibições dinâmicas

Atualiza as exibições de todos os objetos dinâmicos na pasta com base na seleção atual.

Navegação

Você pode optar por navegar para outra pasta, uma história ou um site quando o botão for clicado. Você não precisa especificar uma ação se desejar criar um botão de navegação simples. Um botão só pode ter uma opção de navegação por vez.

Nota informativaA navegação não possui suporte em histórias.

Ir para próxima pasta

Navegar até a próxima pasta sequencialmente.

Ir para pasta anterior

Navegar até a pasta anterior sequencialmente.

Ir para última pasta

Navegar até a última pasta.

Ir para primeira pasta

Navegar até a primeira pasta.

Ir para uma pasta

Navegar até uma pasta específica. Insira o nome da pasta desejada ou selecione-a na lista.

Ir para uma pasta definida por ID da pasta

Navegar até uma pasta específica. Insira o ID da pasta desejada. Você pode encontrar o ID de uma pasta na URL do navegador com a pasta aberta. O ID da pasta segue após /sheet/, seguida por /.

Exemplo: URL da pasta

qlik.com/sense/app/8f8ffa0e-3fde-48a5-a127-59645923a1fc/sheet/7300b241-f221-43db-bb8b-8c8cc1887531/state/analysis

O ID da pasta é 7300b241-f221-43db-bb8b-8c8cc1887531 neste exemplo.

Ir para uma história

Navegar até uma história específica. Insira o nome da história desejada ou selecione-a na lista.

Abrir um site ou e-mail

Abrir um site ou cliente de e-mail especificado. Insira o URL para navegar. Opcionalmente, selecione Abrir na mesma janela para que o site ou o cliente de e-mail seja aberto na mesma janela.

Gerar aplicativo on-demand

Cria um aplicativo on-demand com base na seleção atual. Você deve selecionar um link dme navegação para o aplicativo on-demand (consulte Criando um aplicativo On-demand). O status do aplicativo é exibido à medida que ele é criado.

Estilizando o botão

Você tem várias opções de estilo disponíveis em Aparência no painel de propriedades.

Clique em Estilo em Aparência > Apresentação para personalizar ainda mais o estilo do gráfico. O painel de estilo contém várias seções nas guias Geral e Gráfico.

Você pode redefinir seus estilos clicando em ao lado de cada seção. Clicar em Redefinir tudo redefine os estilos em Geral e Gráfico.

Para obter informações gerais sobre o estilo de uma visualização individual, consulte Aplicando estilo personalizado a uma visualização.

Adicionando um ícone

Você pode adicionar um ícone ao botão em AparênciaÍcone. Escolha entre várias opções predefinidas.

Personalizando o texto

Você pode definir o texto do título, subtítulo e nota de rodapé em Aparência > Geral. Para ocultar esses elementos, desative a configuração Mostrar títulos.

Além disso, você pode definir o texto para o botão Rótulo.

Você pode estilizar o texto que aparece no gráfico.

  1. Em AparênciaApresentação, clique em Estilo.

  2. Na guia Geral, defina a fonte, o estilo de ênfase, o tamanho da fonte e a cor dos seguintes elementos de texto:

    • Título

    • Subtítulo

    • Nota de rodapé

  3. Na guia Gráfico, defina as propriedades de texto do botão Rótulo. Defina a fonte, o estilo de ênfase, o alinhamento do texto, o tamanho da fonte e a cor.

    Você também pode escolher entre várias opções de layout de texto para esse rótulo em Comportamento do layout. Estão disponíveis as seguintes opções:

    • Responsivo: Você pode ajustar o tamanho da fonte do Rótulo, com ajustes de tamanho de texto adicionais sendo aplicados com base no tamanho do botão e do texto. Os ajustes são feitos para caber todo o conteúdo de texto no botão.

    • Fluído: Você pode ajustar o tamanho da fonte do Rótulo, com ajustes de tamanho de texto adicionais sendo aplicados somente com base no tamanho do botão. Este redimensionamento do texto é independente do comprimento do texto. Se o texto for muito longo, uma reticência é inserida no final.

    • Fixo: Você pode ajustar o tamanho da fonte do Rótulo em pixels. Se o texto for muito longo, uma reticência é inserida no final.

Personalizando o plano de fundo

Você pode personalizar o plano de fundo geral, bem como o plano de fundo do botão em si. O plano de fundo de cada um pode ser definido por cor e imagem. As opções de plano de fundo podem ser configuradas expandindo AparênciaApresentação no painel de propriedades e clicando em Estilo.

Definindo o plano de fundo geral

O plano de fundo geral do botão inclui a área do título, bem como o próprio gráfico, que é parcialmente coberto pelo botão em si.

  1. No painel propriedades, expanda a seção Aparência.

  2. Em AparênciaApresentação, clique em Estilo.

  3. Na guia Geral do painel de estilo, você pode selecionar uma cor de fundo (cor única ou expressão) e também definir o fundo para uma imagem de sua biblioteca de mídia.

    Ao usar uma imagem de fundo, você pode ajustar o tamanho e a posição da imagem.

Definindo o plano de fundo do botão

O plano de fundo do botão inclui a parte em que o usuário pode clicar para executar a ação.

  1. No painel propriedades, expanda a seção Aparência.

  2. Em AparênciaApresentação, clique em Estilo.

  3. Na guia Geral do painel de estilo, você pode selecionar uma cor de fundo (cor única ou expressão) e também definir o fundo para uma imagem de sua biblioteca de mídia.

    Ao usar uma imagem de fundo, você pode ajustar o tamanho e a posição da imagem.

Ajustando a borda da parte interativa do botão

Você pode ajustar a borda da parte do botão com a qual o usuário interage para realizar a ação pretendida.

  1. Em AparênciaApresentação, clique em Estilo.

  2. Na guia Gráfico, em Borda, alterne a borda para Ativado para exibi-la no botão.

  3. Ajuste o raio e a largura do canto.

  4. Defina a cor da borda, uma única cor ou com uma expressão.

Personalizando a borda e a sombra de todo o objeto

Você pode personalizar a borda e a sombra de todo o objeto no qual o botão está localizado. Observe que você também pode ajustar a borda do próprio botão clicável.

  1. No painel propriedades, expanda a seção Aparência.

  2. Em AparênciaApresentação, clique em Estilo.

  3. Na guia Geral do painel de estilo, em Borda, ajuste o tamanho do Contorno para aumentar ou diminuir as linhas da borda ao redor do gráfico.

  4. Selecione uma cor para a borda.

  5. Ajuste o Raio do canto para controlar o arredondamento da borda.

  6. Em Sobra na guia Geral, selecione um tamanho e uma cor para a sombra. Selecione Nenhum para remover a sombra.

Desabilitando e habilitando o botão

Você pode definir uma condição de cálculo para habilitar o gráfico em Habilitar gráfico. Se a condição for avaliada como 0, o botão será desabilitado.

Convertendo do Button for navigation no Dashboard bundle

Você pode converter um controle Button for navigation existente em um botão. Existem algumas limitações quando você faz a conversão.

  • A opção de navegação para alternar para o modo de edição (Switch to edit mode) não tem suporte.
  • A ação para selecionar um valor e depois bloquear o campo (Select a value and lock field) não tem suporte. Isso será convertido em duas ações consecutivas: Selecionar valores em um campo e Bloquear um campo específico.

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!