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
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.
Faça o seguinte:
- No painel Ativos, em Gráficos, arraste um objeto Button até a pasta.
- Clique em Add action em Actions no painel de propriedades.mm
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.
- Selecione qual opção de navegação usar em Navegação. Você pode navegar para outra pasta, uma história ou um site.
- 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.
Ative ou desative Avaliação do tempo de execução para alterar quando as expressões no botão são avaliadas. Se esta configuração estiver desativada, as expressões no botão (por exemplo, a expressão de valor de uma variável) serão avaliadas independentemente umas das outras. Com a configuração ativada, as expressões de cada ação são avaliadas no tempo de execução da ação. Isso permite que os valores de expressão definidos em uma ação sejam transportados para ações futuras na cadeia.
Conteúdo do vídeo relacionado
Configurar uma ação para um botão é semelhante a definir ações de pasta. As principais diferenças são:
As ações da pasta são configuradas em Ações no painel de propriedades quando a pasta é o objeto em foco.
As ações do botão são configuradas em Ações e navegação no painel de propriedades quando o botão é selecionado.
Existem algumas diferenças entre as ações disponíveis para botões e pastas.
Para conteúdo de vídeo que descreve as configurações de ação para pastas, consulte Adicionando ações a pastas.
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.
Se nenhuma seleção for feita no campo especificado, todos os valores neste campo serão selecionados.
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.
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.
Ir para dimensão cíclica
Percorre os campos em uma dimensão cíclica selecionada para frente ou para trás.
Limitações
Ir para dimensão cíclica tem as seguintes limitações:
No Qlik Sense Mobile, os botões com a ação Ir para dimensão cíclica só percorrerão a dimensão se o botão estiver em um contêiner.
No Qlik Sense Mobile, os botões com a ação Ir para dimensão cíclica não alternam a dimensão no modo offline.
Definir campo ativo
Defina o campo ativo em uma dimensão cíclica.
Limitações
Definir campo ativo tem as seguintes limitações:
Definir campo ativo usa a posição do campo selecionado na dimensão cíclica. Se os campos forem reordenados na dimensão cíclica, Definir campo ativo usará o campo na mesma posição que o campo originalmente selecionado. Para resolver isso, selecione o campo novamente nas propriedades do botão.
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.
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
Navegue até uma pasta específica e, opcionalmente, destaque um gráfico específico na pasta.
Em Pasta, insira o nome da pasta desejada ou selecione-a na lista. Em ID do gráfico, insira o ID do objeto do gráfico ou selecione o gráfico desejado na lista.
Você pode obter o ID do objeto com um dos seguintes métodos:
Adicione /options/developer à sua URL. Em seguida, clique com o botão direito no gráfico e clique em
Desenvolvedor.Para determinados tipos de gráfico, você pode usar a função de gráfico ObjectId. Por exemplo, adicione =ObjectId() como uma dimensão junto com qualquer medida. O ID do gráfico é exibido e você pode anotá-lo para referência futura. Para obter mais informações, consulte ObjectId - função de gráfico.
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
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. Clique em Redefinir tudo para redefinir os estilos de todas as guias disponíveis no painel de guias.
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.
Faça o seguinte:
Em Aparência > Apresentação, clique em
Estilo.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é
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:
Responsívo: 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.
Fluido: 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ência > Apresentaçã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.
Faça o seguinte:
No painel propriedades, expanda a seção Aparência.
Em Aparência > Apresentação, clique em
Estilo.Na guia Geral do painel de estilo, você pode selecionar uma cor de fundo (cor única ou expressão). Você também pode definir o plano de fundo como uma imagem da sua biblioteca de mídia ou de uma URL.
Ao usar uma cor de fundo, use o controle deslizante para ajustar a opacidade do fundo.
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.
Faça o seguinte:
No painel propriedades, expanda a seção Aparência.
Em Aparência > Apresentação, clique em
Estilo.Na guia Gráfico 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.
Faça o seguinte:
Em Aparência > Apresentação, clique em
Estilo.Na guia Gráfico, em Borda, alterne a borda para Ativado para exibi-la no botão.
Ajuste o raio e a largura do canto.
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.
Faça o seguinte:
No painel propriedades, expanda a seção Aparência.
Em Aparência > Apresentação, clique em
Estilo.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.
Selecione uma cor para a borda.
Ajuste o Raio do canto para controlar o arredondamento da borda.
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.