Componentes XR: Barras de ferramentas
Saiba como os componentes do Material 3 Expressive se adaptam a dispositivos de realidade estendida
TIP
As diretrizes de XR destinam-se principalmente a designers. Para ver o que está implementado em código, consulte o kit de design.
As interfaces de realidade estendida (XR) têm requisitos específicos de design, como exibir aplicativos no espaço 3D. O Material fornece uma barra de ferramentas XR com especificações e orientações próprias. Consulte a documentação para desenvolvedores de XR para mais detalhes.
Variantes
Há um orbiterOrbiters são elementos flutuantes que controlam o conteúdo dentro de painéis espaciais.Mais sobre orbiters de barra de ferramentas. Ele é muito semelhante à barra de ferramentas flutuanteAs barras de ferramentas flutuantes ficam sobre o conteúdo da página e podem fornecer ações contextuais e dinâmicas.Mais sobre barras de ferramentas. Ele pode ser configurado na horizontal ou na vertical. Acesse a referência da API de barra de ferramentas XR

- Barra de ferramentas flutuante horizontal
- Barra de ferramentas flutuante vertical
Anatomia

- Contêiner
- Componentes posicionados
Cor e elevação
Na XR, a cor comunica a elevação de elementos da interface e de orbiters. Com a elevação espacial, a barra de ferramentas é exibida acima do painel espacialNo Android XR, um painel espacial é um contêiner para elementos da interface, componentes interativos e conteúdo imersivo.Mais sobre painéis espaciais no eixo Z. As barras de ferramentas elevadas podem usar qualquer uma destas opções de cor:

- Contêiner de superfície
- Contêiner de superfície alto
- Contêiner de superfície mais elevado
- Contêiner terciário
Medidas


Uso
Uma barra de ferramentas pode ser exibida em um orbiterOrbiters são elementos flutuantes que controlam o conteúdo dentro de painéis espaciais.Mais sobre orbiters para proporcionar uma experiência mais imersiva. Atualmente, esse recurso espacial está disponível apenas no modo full spaceFull space é o modo imersivo do Android XR e oferece suporte a componentes espaciais.Mais sobre full space. No modo home spaceHome space é compatível com aplicativos para dispositivos móveis e telas grandes, mas não oferece suporte a componentes espaciais.Mais sobre home space, use uma barra de ferramentas normal no mesmo plano do conteúdo principal para simular uma experiência 2D.
Comportamento
Contexto local (recomendado)
Quando posicionado no contexto local, o orbiter de barra de ferramentas fica centralizado na parte inferior do painel espacial que controla.
Ele se reposiciona quando o layout ou o conteúdo muda.
Contexto global
Quando posicionado no contexto global, o orbiter de barra de ferramentas fica centralizado na parte inferior do aplicativo.
Ele permanece ancorado ao aplicativo mesmo quando o layout ou o conteúdo muda.
Expandir e recolher
Orbiters de barra de ferramentas com mais de cinco itens podem ser expandidos e recolhidos para revelar ou ocultar conteúdo adicional.
Quando um orbiter de barra de ferramentas é expandido, ele permanece dentro dos limites do painel espacial adjacente.
Como alternativa, barras de ferramentas mais complexas podem ser divididas em várias barras.
Barras de ferramentas adicionais
Em alguns casos, aplicativos no modo full space podem ter mais de um orbiter de barra de ferramentas, posicionado no contexto global ou local.
Posicionamento
Posicionamento com deslocamento e recuo interno
No modo full space, um orbiter de barra de ferramentas pode ser posicionado ao lado de um painel espacial ou sobre ele.

- Com deslocamento de 20dp ou
- Com recuo interno de 12dp

Alinhamento horizontal


Alinhamento vertical


Alinhamento ao painel espacial
Por padrão, os orbiters de barra de ferramentas são alinhados ao centro do painel espacial. O posicionamento pode ser ajustado para atender a necessidades específicas dos usuários, como melhorar a ergonomia ou oferecer suporte a idiomas com escrita da direita para a esquerda (RTL).

Evite colocar um orbiter de barra de ferramentas vertical entre painéis espaciais.
Isso prejudica a estrutura da interface e pode dificultar que os usuários o encontrem.

Considerações de acessibilidade
As diretrizes de acessibilidade em XR ainda estão em evolução. As barras de ferramentas XR devem seguir os padrões de acessibilidade aplicáveis a barras de ferramentas do Material.