试用实验性移动端页脚导航!

我们正在推出一种实验性的移动端导航布局,旨在让社区的主要区域更易于用拇指触达。这是一项即将推出的实验性功能,名为“移动端底部导航”。管理员如果拥有近期更新过的 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,它渲染自己的状态,并在没有内容可显示时渲染为空。

:rocket: 告诉我们你的想法!

请告诉我们新的导航感觉如何,特别是在主题、聊天和其他板块之间移动时。如果你遇到布局或导航问题,请告诉我们你使用的设备/浏览器组合!

7 个赞

看起来很棒!我觉得这对使用大屏设备的用户会非常有帮助 :+1:

我们可以假定,如果用户没有启用聊天或 AI 代理功能,这些按钮就不会显示吗?

1 个赞

是的!目前从简单功能入手比较合适,但以后或许值得增加一个设置项,以便即使在启用的情况下也能隐藏某些板块。

1 个赞

这太酷了!比我预期的还要喜欢。我唯一的想法是它是静态的,完全不会动……

如果让它响应滚动并像这样下移,会不会更合理一些?

另外,把个人资料放在下面,就像 Instagram 那样,是不是也更合理呢?

4 个赞

有可能!Instagram 的做法之所以可行,是因为他们为所有用户提供固定数量的选项。而在 Discourse 中,我们肯定会添加更多功能,这些功能可能适合放在底部栏中,因此可能需要一个“……”按钮和一个抽屉,用于访问更多板块(这也将始终是最右侧的图标)。

因此,底部栏中的最后一项不一定总是固定的,理想情况下,你的通知/用户菜单应该始终位于同一位置。目前,通过页眉可以轻松实现这一点。

1 个赞

完全理解并且100%同意——如果个人资料图标因为我是管理员或者启用了某些功能而在不同站点间跳动,我会很烦的。如果这一点以后可以自定义,我觉得最好能让用户自行选择,而管理员只设置默认值,因为这种非常个性化的东西,管理员似乎不应该去控制每个用户的设置。除此以外,做得真棒 :slight_smile:

1 个赞