Ler em inglês

Partilhar via

Breadcrumb Controlo

  • Artigo

Um controlo utilizado para fornecer navegação.

Nota

A documentação completa e o código de origem encontram-se no repositório de componentes de código do GitHub.

Controlo Breadcrumb.

Description

Breadcrumb Os controles devem ser usados como um auxílio à navegação em seu aplicativo ou site. Indicam a localização da página atual dentro de uma hierarquia e ajudam o utilizador a compreender onde se encontram em relação ao resto dessa hierarquia. Um trilho também fornece acesso com um clique a níveis superiores dessa hierarquia.

Este componente de código fornece um wrapper em torno do controlo Breadcrumb da Fluent UI para utilização em aplicações de tela e páginas personalizadas.

_Propriedades

Propriedades chave

Property Description
SelectedKey Isto denota a chave selecionada. Isto será atualizado através do evento OnChange quando o utilizador interagir com o controlo.
Items Os itens de ação a compor

Items propriedades

Cada item utiliza o esquema que se segue para visualizar dados no componente.

Name Description
ItemDisplayName O Nome a Apresentar do item de trilho
ItemKey A chave a utilizar para indicar o item que está selecionado e quando adicionar subitens. As chaves têm de ser exclusivas.
ItemClickable Defina como false no caso do item de trilho específico for não clicável.

Fórmula do Power Fx de exemplo:

Power Fx 
Table(
    {
        ItemKey: "1",
        ItemDisplayName: "General",
        ItemClickable: true
    },
    {
        ItemKey: "2",
        ItemDisplayName: "Document",
        ItemClickable: true
    }
)

Propriedades de estilo

Name Description
Theme Aceita uma cadeia JSON que é gerada através do Estruturador de Teams da Fluent UI (windows.net). Deixar isto em branco irá utilizar o tema predefinido estabelecido pelo Power Apps. Consulte personalizar o tema para obter orientações sobre como configurar.
AccessibilityLabel Etiqueta aria de leitor de ecrã
MaxDisplayedItems O número máximo de trilhos a apresentar antes de agregar. Se zero, todos os trilhos serão compostos.
OverflowIndex Índice opcional onde os itens de capacidade excedida será fechado. Por predefinição, está definido como zero.

Propriedades do evento

Name Description
InputEvent Um evento a enviar ao controlo. Por exemplo, SetFocus. Ver abaixo.

Comportamento

Suporta SetFocus como um InputEvent.

Configurar o comportamento "Ao Selecionar"

Utilize a fórmula Switch() na propriedade OnSelect do componente para configurar ações específicas para cada item, referindo-se ao ItemKey do controlo selecionado como o valor de comutador.

Substitua os valores false por expressões apropriadas na linguagem do Power Fx.

Uma vez que este controlo é utilizado para navegação, uma ação lógica é utilizar funções de navegação (idealmente para um ecrã relevante com os dados relacionados carregados).

Power Fx 
  Switch( Self.Selected.ItemKey,
    /* Action for ItemKey 1 */
    "1", false,
    
    /* Action for ItemKey 2 */
    "2", false,
  
    /* Default action */
        false
  )

Definir o foco no controlo

Quando é apresentado um novo diálogo e o foco predefinido deverá estar no controlo, será necessário um foco de conjunto explícito.

Para fazer chamadas para o evento de entrada, pode definir uma variável de contexto que está dependente da propriedade Input Event para uma cadeia que começa por SetFocus e seguida por um elemento aleatório, para assegurar que a aplicação a deteta como uma alteração.

Fórmula do Power Fx de exemplo:

Power Fx 
UpdateContext({ ctxResizableTextareaEvent:"SetFocus" & Text(Rand()) }));

A variável de contexto ctxResizableTextareaEvent ficaria então dependente da propriedade Input Event.

Limitações

Este componente de código só pode ser utilizado em aplicações de tela e páginas personalizadas.