Experimente a navegação de rodapé móvel experimental!

Estamos introduzindo um layout de navegação móvel experimental que coloca as principais áreas da sua comunidade ao alcance mais fácil dos seus polegares. Isso está por trás de uma alteração experimental futura chamada “Mobile footer navigation” (Navegação no rodapé móvel). Administradores com um site Discourse atualizado recentemente podem habilitá-la em /admin/upcoming-changes.

Em vez de abrir o menu pelo cabeçalho, você encontrará uma barra de navegação na parte inferior da tela, com atalhos para seções do site, um botão de menu global e um botão para criar novo conteúdo.

Se você quiser experimentá-la aqui no Meta, entre no grupo de experimentos de design! Isso será expandido para todos os usuários do Meta se der certo.

O que isso muda?

O novo rodapé reúne:

  • Seções do site: Alterne entre Tópicos, Chat, conversas com IA, Administração e mais! Outras seções podem ser adicionadas via API, e provavelmente adicionaremos suporte para mais dos nossos próprios plugins se este experimento progredir.
  • Menu: Abra o menu hambúrguer global do site… este não é mais contextual e será persistente independentemente de onde você estiver.
  • Criar: Inicie um tópico, mensagem pessoal, chat ou conversa com IA, de acordo com suas permissões e recursos habilitados. Rascunhos também estão disponíveis aqui.
  • Subnavegações: Nas listas de tópicos, visualizações como Recentes, Novos, Não lidos e Top aparecem em uma linha secundária acima da navegação principal.

A linha secundária desaparece quando você rola para baixo e retorna quando você rola para cima. O rodapé também se oculta enquanto o teclado está aberto para compor ou conversar.

Alternar entre seções lembra onde você parou. Por exemplo, você pode sair de um tópico para o Chat e depois voltar para aquele tópico. Tocar novamente no item de navegação ativo leva você de volta para o início dele: de um tópico para a lista de tópicos, de um canal de chat para a lista de canais, etc.

Quando há mais de quatro abas de navegação, as três primeiras permanecem visíveis e as seções restantes aparecem em um menu de botão de reticências.

Visitantes anônimos de sites públicos também podem usar o rodapé, com o botão de login disponível.

A navegação para telas maiores permanece inalterada, mas estamos interessados em explorar uma maneira consistente de alternar contextos também lá.

Para desenvolvedores de plugins e temas

Esta é uma alteração experimental, então tenha em mente que esses métodos podem mudar, mas se você quiser experimentar com ela, o rodapé se baseia na API existente do painel da barra lateral. Um painel entra por meio do retorno de um objeto mobileTab de seu getter mobileTab.

Adicionar uma aba de seção

Use api.addSidebarPanel() para registrar um painel, ou adicione um getter mobileTab a um painel existente:

import { routeWithin } from "discourse/lib/mobile-tab-bar";
import { withPluginApi } from "discourse/lib/plugin-api";
import { i18n } from "discourse-i18n";

export default {
  name: "example-mobile-navigation",

  initialize(container) {
    const router = container.lookup("service:router");

    withPluginApi((api) => {
      api.addSidebarPanel(
        (BaseCustomSidebarPanel) =>
          class extends BaseCustomSidebarPanel {
            key = "example";
            switchButtonIcon = "compass";

            get switchButtonLabel() {
              return i18n("example.navigation.title");
            }

            get switchButtonDefaultUrl() {
              return "/example";
            }

            get mobileTab() {
              return {
                label: this.switchButtonLabel,
                icon: this.switchButtonIcon,
                url: "/example",
                ownsRoute: (routeInfo) =>
                  routeWithin(routeInfo, "example"),
                isNestedRoute: (routeInfo) =>
                  routeWithin(routeInfo, "example.item"),
                createActions: [
                  {
                    label: i18n("example.navigation.new_item"),
                    icon: "plus",
                    action: () =>
                      router.transitionTo("example.new"),
                  },
                ],
              };
            }
          }
      );
    });
  },
};

O objeto mobileTab suporta estas propriedades:

Propriedade Propósito
label Texto traduzido exibido na aba.
icon Ícone exibido na aba.
url A URL inicial da seção, usada antes que um local anterior tenha sido lembrado.
primary Opcional. Coloca a aba após Tópicos e antes das outras abas.
badgeComponent Opcional. Componente renderizado sobre o ícone para indicadores de não lidos ou contagens.
ownsRoute(routeInfo) Identifica rotas pertencentes à seção e determina quando sua aba está ativa.
isNestedRoute(routeInfo) Identifica páginas de detalhes onde tocar na aba ativa ou usar o botão voltar do cabeçalho deve retornar à lista da seção.
showsTitleInHeader(routeInfo) Controla se uma página aninhada usa o cabeçalho estilo título ao lado do botão voltar. Padrão é true.
createActions Matriz opcional de objetos { label, icon, action } contribuídos para o botão Criar global.

Tópicos aparecem primeiro, seguidos pelas abas de navegação principais, outras abas e administração.

Correspondência de rotas e páginas aninhadas

Dois ajudantes estão disponíveis em discourse/lib/mobile-tab-bar:

  • routeWithin(routeInfo, ...names) corresponde a uma rota nomeada e seus descendentes.
  • findRoute(routeInfo, name) encontra uma rota nomeada na ancestralidade da rota atual, permitindo acesso a seu modelo através de .attributes.

Outras seções são verificadas antes de Tópicos ao determinar a propriedade da rota. Isso permite que uma extensão reivindique um tópico que representa conteúdo em sua própria seção, como as conversas com IA fazem.

Se nenhuma seção reivindicar uma rota, nenhuma aba de seção será destacada, e os locais de seções anteriormente lembrados serão retidos.

Adicionar navegação secundária

Use MobileTabBarViews para renderizar as visualizações ou controles de uma seção na linha acima do rodapé:

import Component from "@glimmer/component";
import { service } from "@ember/service";
import MobileTabBarViews from "discourse/components/mobile-tab-bar/views";
import ExampleNavigation from "./example-navigation";

export default class ExamplePage extends Component {
  @service mobileTabBar;

  <template>
    {{#if this.mobileTabBar.enabled}}
      <MobileTabBarViews>
        <ExampleNavigation />
      </MobileTabBarViews>
    {{else}}
      <ExampleNavigation />
    {{/if}}
  </template>
}

MobileTabBarViews renderiza seu bloco na linha secundária do rodapé. Não renderiza nada enquanto o rodapé estiver oculto ou desabilitado, então mantenha sua navegação usual como alternativa.

O botão Menu do rodapé sempre abre o menu do fórum. Cada seção deve fornecer sua própria navegação em suas páginas ou através desta linha secundária.

Adicionar ações de criação e badges

As ações de criação de todas as abas participantes são coletadas no botão Criar global, com as ações da seção atual primeiro. Rascunhos são anexados quando disponíveis. Se houver apenas uma ação, o botão a executa diretamente… caso contrário, abre um menu.

Para indicadores de não lidos, forneça um badgeComponent que renderize seu próprio estado e não renderize nada quando não houver nada para mostrar.

:rocket: Diga o que você acha!

Por favor, nos conte como a nova navegação parece, especialmente ao mover-se entre tópicos, Chat e outras seções. Se você encontrar um problema de layout ou navegação, por favor, nos diga qual combinação de dispositivo/navegador você está usando!

7 curtidas

Ficou ótimo! Dá para ver que isso será muito útil para quem tem dispositivos maiores :+1:

Posso presumir que, se alguém não tiver o chat ou os agentes de IA ativados, esses botões não aparecem?

1 curtida

Isso mesmo! Pode ser útil ter uma configuração para excluir algumas seções mesmo quando habilitadas, mas por enquanto vamos começar com o simples.

1 curtida

Isso é demais! Gostei mais do que esperava. Só acho que é estático e não se move nada…

Não faria um pouco mais de sentido responder ao scroll e baixar assim?

E não faria sentido colocar o seu perfil lá embaixo, como funciona no Instagram?

4 curtidas

Talvez! O Instagram tem a vantagem de oferecer um número fixo de opções para todos. No caso do Discourse, com certeza vamos adicionar mais recursos que podem fazer sentido em uma barra de rodapé, então um botão “…” com uma gaveta para mais seções pode ser necessário (e sempre seria o ícone mais à direita).

Portanto, o último item da barra pode não ser sempre consistente, e o ideal é que suas notificações/menu de usuário estejam sempre no mesmo lugar. Por enquanto, o cabeçalho facilita isso.

1 curtida

Entendido e 100% de acordo — seria irritante se o ícone do perfil ficasse mudando de um site para outro com base em eu ter admin ou alguns recursos ativados. Se isso for personalizável algum dia, acho que seria ótimo se fosse uma opção do usuário, e os administradores apenas definissem o padrão, pois parece ser uma dessas coisas que os administradores não têm o direito de controlar para todos os usuários, sendo algo tão pessoal. Além disso, bom trabalho :slight_smile:

1 curtida