커뮤니티의 주요 영역을 손가락 끝으로 더 쉽게 접근할 수 있는 실험적인 모바일 내비게이션 레이아웃을 소개합니다. 이는 “Mobile footer navigation”(모바일 푸터 내비게이션)이라는 실험적 향후 변경사항 뒤에 있습니다. Discourse 사이트를 최근 업데이트한 관리자는 /admin/upcoming-changes에서 이 기능을 활성화할 수 있습니다.
헤더에서 메뉴를 여는 대신, 화면 하단에 사이트 섹션 바로가기, 전역 메뉴 버튼, 새 콘텐츠 생성 버튼이 포함된 내비게이션 바가 표시됩니다.
Meta에서 이를 직접 테스트해 보려면 design experiments 그룹에 가입하세요! 결과가 좋으면 모든 Meta 사용자로 확대 적용될 예정입니다.
무엇이 바뀌나요?
새로운 푸터는 다음 요소들을 통합합니다:
- 사이트 섹션: Topics, Chat, AI 대화, Admin 등 간에 전환합니다! 다른 섹션은 API를 통해 추가할 수 있으며, 이 실험이 진전되면 자체 플러그인에 대한 지원도 추가될 가능성이 높습니다.
- 메뉴: 사이트의 전역 햄버거 메뉴를 엽니다… 더 이상 문맥에 따라 달라지지 않으며 어디에 있든 항상 표시됩니다.
- 만들기: 사용자의 권한 및 활성화된 기능에 따라 토픽, 개인 메시지, 채팅 또는 AI 대화를 시작합니다. 여기서는 초안도 사용할 수 있습니다.
- 서브 내비게이션: 토픽 목록에서 Latest, New, Unread, Top 등의 보기가 주요 내비게이션 위의 보조 행에 표시됩니다.
보조 행은 스크롤하여 아래로 내려가면 사라지고 위로 스크롤하면 돌아옵니다. 또한 키보드가 열려 작성을 하거나 채팅을 하는 동안 푸터는 숨겨집니다.
섹션 간 전환 시 마지막 위치를 기억합니다. 예를 들어, 토픽에서 Chat으로 이동했다가 다시 그 토픽으로 돌아올 수 있습니다. 활성 내비게이션 항목을 다시 탭하면 시작점으로 이동합니다: 토픽에서 토픽 목록으로, 채팅 채널에서 채널 목록으로 등등.
내비게이션 탭이 4개 이상인 경우, 처음 3개는 계속 표시되고 나머지 섹션은 말줄임표(…) 버튼 메뉴에 나타납니다.
공개 사이트의 익명 방문자도 푸터를 사용할 수 있으며, 로그인 버튼이 제공됩니다.
큰 화면에서의 내비게이션은 변경되지 않지만, 거기서도 컨텍스트를 전환하기 위한 일관된 방식을 탐색하는 데 관심이 있습니다.
플러그인 및 테마 개발자용
이것은 실험적 변경사항이므로 이러한 메서드가 변경될 수 있다는 점을 염두에 두세요. 만약 이를 실험해 보고 싶다면, 푸터는 기존 사이드바 패널 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 | 선택 사항. 탭을 Topics 뒤에, 다른 탭 앞에 배치합니다. |
| badgeComponent | 선택 사항. 읽지 않은 표시나 개수를 위해 아이콘 위에 렌더링되는 컴포넌트. |
| ownsRoute(routeInfo) | 섹션에 속하는 라우트를 식별하고 해당 탭이 활성화되는 시점을 결정합니다. |
| isNestedRoute(routeInfo) | 활성 탭을 탭하거나 헤더의 뒤로 가기 버튼을 사용할 때 섹션의 목록으로 돌아가야 하는 상세 페이지를 식별합니다. |
| showsTitleInHeader(routeInfo) | 중첩된 페이지가 뒤로 가기 버튼 옆에 제목 스타일의 헤더를 사용하는지 제어합니다. 기본값은 true입니다. |
| createActions | 전역 Create 버튼에 기여하는 { label, icon, action } 객체의 선택적 배열. |
Topics가 먼저 표시되고, 그 다음 primary 내비게이션 탭, 다른 탭, admin 순서로 표시됩니다.
라우트 및 중첩 페이지 매칭
discourse/lib/mobile-tab-bar에서 사용할 수 있는 두 가지 헬퍼가 있습니다:
routeWithin(routeInfo, ...names)은 named 라우트와 그 하위 라우트를 매칭합니다.findRoute(routeInfo, name)은 현재 라우트의 조상 계층에서 named 라우트를 찾아 .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는 푸터의 보조 행에 블록을 렌더링합니다. 푸터가 숨겨지거나 비활성화된 동안에는 아무것도 렌더링하지 않으므로, 기존 내비게이션을 폴백으로 유지하세요.
푸터의 Menu 버튼은 항상 포럼 메뉴를 엽니다. 각 섹션은 페이지 내에서 또는 이 보조 행을 통해 자체 내비게이션을 제공해야 합니다.
생성 작업 및 배지 추가
참가하는 모든 탭의 생성 작업은 전역 Create 버튼으로 수집되며, 현재 섹션의 작업이 먼저 표시됩니다. 초안이 있으면 마지막에 추가됩니다. 작업이 하나뿐이면 버튼이 직접 실행되며, 그렇지 않으면 메뉴가 열립니다.
읽지 않은 표시를 위해, 표시할 내용이 없을 때는 아무것도 렌더링하지 않고 자체 상태를 렌더링하는 badgeComponent를 제공하세요.
의견을 들려주세요!
새 내비게이션이 어떻게 느껴지는지, 특히 토픽, Chat 및 기타 섹션 간 이동할 때 알려주세요. 레이아웃이나 내비게이션 문제가 발생하면 사용 중인 디바이스/브라우저 조합을 알려주세요!



