Header controle (experimental)

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Controle usado para criar uma experiência de navegação.

Importante

• Este é um recurso experimental.
• Os recursos experimentais não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

Description

Um Header é normalmente usado para exibir detalhes globais do aplicativo (por exemplo, nome do aplicativo ou nome da página) e ações de navegação (por exemplo, botões de navegação para a página principal ou voltar).

O componente Header pode substituir o cabeçalho padrão do Power Apps se você quiser uma aparência ou um comportamento diferente.

O controle deve ser usado com contêineres de layout para garantir que a experiência seja responsiva devido à sua natureza de largura variável quando o aplicativo é executado.

Esse componente de tela imita o estilo e o comportamento do cabeçalho padrão do Power Apps e pode realmente substituí-lo (consulte a seção Comportamento abaixo).

Propriedades

Principais propriedades

Propriedade	Description
Text	O texto exibido no centro do controle
BackButtonVisible	Ative para exibir o botão Voltar, caso contrário, o LeftButtonImage será exibido (se houver)
LeftButtonImage	Uma imagem exibida na borda esquerda do controle
LeftButtonVisible	Ative para exibir LeftButtonImage
RightButtonImage	Uma imagem exibida na borda direita do controle
RightButtonVisible	Ative para exibir RightButtonImage
ContentWidth	A largura do conteúdo no controle

Propriedades de estilo

Propriedade	Description
Color	A cor do texto do centro de controle
HeaderFill	É preferível que a cor de preenchimento do cabeçalho seja diferente da cor primária do Theme
Width	A largura do controle
Theme	O objeto do tema. Consulte os temas para obter orientação sobre como configurar.

Propriedades do evento

Propriedade	Description
OnLeftButtonSelect	Fórmula de ação executada quando o botão esquerdo é selecionado (quando exibido)
OnRightButtonSelect	Fórmula de ação executada quando o botão esquerdo é selecionado (quando exibido)
OnBackSelect	Fórmula de ação executada quando o botão voltar é selecionado (quando exibido)

Comportamental

Substitua a barra de navegação padrão do Power Apps por Header

*Aplica-se somente a aplicativos Canvas*

Se quiser exibir apenas o cabeçalho, poderá ocultar a barra de navegação padrão renderizada pelo Power Apps player compartilhando o link do aplicativo com o parâmetro de consulta hideNavBar:

https://apps.powerapps.com/play/APPID?source=iframe&hidenavbar=true

Onde APPID é substituído pelo valor do seu aplicativo. Observe que os parâmetros são necessários para que a renderização ocorra sem a barra de navegação padrão. Os aplicativos de tela reproduzidos sem os parâmetros de consulta, como diretamente do Maker Portal, continuarão renderizando a barra padrão.

Limitações

Este componente de tela pode ser usado somente em aplicativos de tela. Ele pode ser usado em páginas personalizadas, mas, provavelmente não é necessário, pois as páginas são incorporadas em aplicativos baseados em modelo.