我们正在推出一种实验性的移动端导航布局,旨在让社区的主要区域更易于用拇指触达。这是一项即将推出的实验性功能,名为“移动端底部导航”。管理员如果拥有近期更新过的 Discourse 站点,可以从 /admin/upcoming-changes 启用此功能。
与从顶栏打开菜单不同,你现在会在屏幕底部看到一个导航栏,其中包含通往各个站点板块的快捷方式、一个全局菜单按钮以及一个创建新内容的按钮。
如果你想在此处的 Meta 站点上试用,请加入设计实验小组!如果反响良好,我们将向所有 Meta 用户推广此功能。
这改变了什么?
新的底部栏整合了以下内容:
- 站点板块:在主题、聊天、AI 对话、管理页面等之间切换!可以通过 API 添加其他板块,如果此实验进展顺利,我们可能会增加对更多自有插件的支持。
- 菜单:打开站点的全局汉堡包菜单……该菜单不再具有上下文依赖性,无论你在何处都会保持持久存在。
- 创建:根据你的权限和启用的功能,发起主题、私信、聊天或 AI 对话。这里也可以访问草稿。
- 二级导航:在主题列表中,最新、新帖、未读和热门等视图会显示在主导航栏上方的一行中。
当你向下滚动时,二级导航行会滑出屏幕;当你向上滚动时,它会重新出现。当你打开键盘进行撰写或聊天时,底部栏也会隐藏。
在板块之间切换时,系统会记住你离开的位置。例如,你可以从主题切换到聊天,然后再返回到该主题。再次点击当前激活的导航项会带你回到其起始位置:从主题回到主题列表,从聊天频道回到频道列表等。
当导航标签超过四个时,前三个保持可见,其余板块会出现在省略号按钮菜单中。
匿名访客在公开站点上也可以使用底部栏,并且可以使用登录按钮。
大屏设备的导航保持不变,但我们也有兴趣探索在那里切换上下文的一致方式。
面向插件和主题开发者
这是一项实验性更改,因此请注意这些方法可能会发生变化,但如果你想尝试,底部栏基于现有的侧边栏面板 API 构建。面板通过在 mobileTab getter 中返回一个 mobileTab 对象来选择启用此功能。
添加板块标签
使用 api.addSidebarPanel() 注册一个面板,或为现有面板添加 mobileTab getter:
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"),
},
],
};
}
}
);
});
},
};
mobileTab 对象支持以下属性:
| 属性 | 用途 |
|---|---|
| label | 标签上显示的翻译文本。 |
| icon | 标签上显示的图标。 |
| url | 板块的起始 URL,用于在记住之前的位置之前。 |
| primary | 可选。将标签放置在“主题”之后,其他标签之前。 |
| badgeComponent | 可选。在图标上渲染的组件,用于显示未读指示器或计数。 |
| ownsRoute(routeInfo) | 识别属于该板块的路由,并确定其标签何时激活。 |
| isNestedRoute(routeInfo) | 识别详情页面,在这些页面上,点击激活的标签或使用顶栏的后退按钮应返回到板块列表。 |
| showsTitleInHeader(routeInfo) | 控制嵌套页面是否在后退按钮旁边使用标题样式页眉。默认为 true。 |
| createActions | 可选的 { label, icon, action } 对象数组,贡献给全局“创建”按钮。 |
主题首先出现,随后是主要导航标签、其他标签和管理页面。
匹配路由和嵌套页面
discourse/lib/mobile-tab-bar 提供了两个辅助函数:
routeWithin(routeInfo, ...names)匹配指定路由及其后代。findRoute(routeInfo, name)在当前路由的祖先中查找指定路由,允许通过.attributes访问其模型。
在确定路由所有权时,其他板块会在“主题”之前进行检查。这允许扩展名声明一个代表其自身板块内容的主题,就像 AI 对话所做的那样。
如果没有板块声明某个路由,则不会高亮任何板块标签,并保留之前记住的板块位置。
添加二级导航
使用 MobileTabBarViews 在底部栏上方的一行中渲染板块的视图或控件:
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 将其块渲染到底部栏的二级行中。当底部栏隐藏或禁用时,它不会渲染任何内容,因此请保留常规导航作为后备方案。
底部栏的菜单按钮始终打开论坛菜单。每个板块应通过其页面或此二级行提供自己的导航。
添加创建操作和徽章
所有参与标签的创建操作都会收集到全局“创建”按钮中,当前板块的操作排在首位。如果有草稿可用,它们会被追加在后面。如果只有一个操作,按钮会直接执行……否则,它会打开一个菜单。
对于未读指示器,请提供一个 badgeComponent,它渲染自己的状态,并在没有内容可显示时渲染为空。
告诉我们你的想法!
请告诉我们新的导航感觉如何,特别是在主题、聊天和其他板块之间移动时。如果你遇到布局或导航问题,请告诉我们你使用的设备/浏览器组合!



