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.
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!



