コミュニティの主要なエリアを親指でより簡単にアクセスできるようにする、実験的なモバイルナビゲーションレイアウトを導入します。これは、「Mobile footer navigation(モバイルフッターナビゲーション)」という実験的な変更として提供されています。Discourseサイトを最近更新した管理者は、/admin/upcoming-changes から有効にできます。
ヘッダーからメニューを開く代わりに、画面の下部にナビゲーションバーが表示され、サイトのセクションへのショートカット、グローバルメニューボタン、新規コンテンツ作成用のボタンが含まれます。
Meta上でこの機能を試してみたい場合は、デザイン実験グループに参加してください! 結果が良好であれば、すべてのMetaユーザーに適用されます。
何が変更されますか?
新しいフッターには以下の機能が集約されています:
- サイトセクション: トピック、チャット、AI会話、管理画面などを切り替えます! APIを通じて他のセクションを追加することができ、この実験が進むにつれて、当社のプラグインへのサポートも増える可能性があります。
- メニュー: サイトのグローバルハンバーガーメニューを開きます… これは文脈に依存せず、どこにいても常駐表示されます。
- 作成: トピック、個人メッセージ、チャット、AI会話を開始します。これはあなたの権限と有効な機能に基づきます。下書きもここで利用可能です。
- サブナビ: トピック一覧では、「最新」「新着」「未読」「人気」などのビューがメインナビゲーションの上にセカンダリ行として表示されます。
下方向にスクロールするとセカンダリ行はスライドアウトし、上方向にスクロールすると再表示されます。また、作成やチャットのためにキーボードが開いている間、フッターは非表示になります。
セクション間の切り替えでは、最後にいた場所が記憶されます。例えば、トピックからチャットに移動し、その後そのトピックに戻ることができます。アクティブなナビ項目を再度タップすると、そのセクションの開始位置に戻ります: トピックからトピック一覧へ、チャットチャンネルからチャンネル一覧へなど。
ナビゲーションタブが4つ以上ある場合、最初の3つは表示されたままで、残りのセクションは省略記号ボタンメニューに表示されます。
公開サイトの匿名訪問者もフッターを使用できます。ログインボタンが表示されます。
大型画面向けのナビゲーションは変更されませんが、そちらでも一貫したコンテキスト切り替えの方法を検討することに興味があります。
プラグインおよびテーマ開発者の方へ
これは実験的な変更であるため、これらのメソッドは変更される可能性があることにご注意ください。しかし、この機能を試してみたい場合は、フッターは既存のサイドバーパネルAPIに基づいています。パネルは、mobileTab ゲッターから mobileTab オブジェクトを返すことで最適化されます。
セクションタブの追加
api.addSidebarPanel() を使用してパネルを登録するか、既存のパネルに mobileTab ゲッターを追加します:
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 | オプション。Topics(トピック)の後に、他のタブの前にタブを配置します。 |
| badgeComponent | オプション。未読インジケーターやカウントのためにアイコンの上に描画されるコンポーネント。 |
| ownsRoute(routeInfo) | セクションに属するルートを識別し、そのタブがアクティブになるタイミングを決定します。 |
| isNestedRoute(routeInfo) | 詳細ページを識別します。アクティブなタブをタップするかヘッダーの戻るボタンを使用すると、セクションの一覧に戻ります。 |
| showsTitleInHeader(routeInfo) | ネストされたページが戻るボタンの横にタイトルスタイルのヘッダーを使用するかどうかを制御します。デフォルトは true です。 |
| createActions | オプションの { label, icon, action } オブジェクトの配列。グローバルなCreate(作成)ボタンに追加されます。 |
Topics(トピック)が最初に表示され、次に primary(優先)ナビゲーションタブ、他のタブ、そして管理画面が続きます。
ルートとネストされたページの一致
discourse/lib/mobile-tab-bar から利用可能な2つのヘルパーがあります:
routeWithin(routeInfo, ...names)は、名前付きルートとそのサブルートに一致します。findRoute(routeInfo, name)は、現在のルートの祖先から名前付きルートを検索し、.attributes を通じてそのモデルへのアクセスを可能にします。
ルートの所有権を決定する際、Topics(トピック)の前に他のセクションがチェックされます。これにより、拡張機能は自身のセクション内のコンテンツを表すトピック(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 はそのブロックをフッターのセカンダリ行に描画します。フッターが非表示または無効な場合は何も描画しないため、通常のナビゲーションをフォールバックとして保持してください。
フッターのメニューボタンは、常にフォーラムメニューを開きます。各セクションは、そのページ上でこのセカンダリ行を通じて独自のナビゲーションを提供する必要があります。
作成アクションとバッジの追加
参加しているすべてのタブからの作成アクションは、現在のセクションのアクションを最初にして、グローバルなCreate(作成)ボタンに集められます。下書きが利用可能な場合は追加されます。アクションが1つしかない場合、ボタンはそれを直接実行します… それ以外の場合、メニューを開きます。
未読インジケーターについては、独自の状態を描画し、表示すべきものがない場合は何も描画しない badgeComponent を指定します。
ご意見をお聞かせください!
特にトピック、チャット、その他のセクション間を移動する際に、新しいナビゲーションがどのように感じられるか教えてください。レイアウトやナビゲーションの問題が発生した場合は、使用しているデバイス/ブラウザの組み合わせを教えてください!



