AppNav

AppNav组件根据AppNavItem条目创建侧边导航菜单。条目可以链接到内部视图或外部资源，在父条目下嵌套以形成分层菜单，并携带图标、徽章或其他组件，以便用户能够一目了然地获得更多上下文信息。

添加和嵌套条目

AppNavItem实例用于填充AppNav结构。这些条目可以是简单链接或包含子条目的嵌套组标题。没有链接的组标题作为可展开的容器。

使用addItem()在导航中包含条目：

AppNavItem dashboard = new AppNavItem("仪表板", "/dashboard");
AppNavItem admin = new AppNavItem("管理员");
admin.addItem(new AppNavItem("用户", "/admin/users"));
admin.addItem(new AppNavItem("设置", "/admin/settings"));

AppNav nav = new AppNav();
nav.addItem(dashboard);
nav.addItem(admin);

链接组条目

导航树中的顶层条目通常意味着可展开，而不是可点击的链接。在这样的条目上设置path可能会让用户感到困惑，他们期待它们揭示子条目而不是导航到其他地方。

如果您希望组标题触发自定义操作（例如打开外部文档），请保持组路径为空，而是向条目的后缀添加交互控件，如IconButton。这将保持用户体验的一致性和简洁性。

显示代码

AppNavView.java
AppNavPageView.java

链接条目

每个AppNavItem可以导航到内部视图或外部链接。您可以使用静态路径或注册的视图类来定义此项。

静态路径

使用字符串路径直接定义链接：

AppNavItem docs = new AppNavItem("文档", "/docs");
AppNavItem help = new AppNavItem("帮助", "https://support.example.com");

注册的视图

如果您的视图已与路由器注册，您可以传递类而不是硬编码的URL：

AppNavItem settings = new AppNavItem("设置", SettingsView.class);

如果您的注释路由支持路由参数，您还可以传递ParametersBag：

ParametersBag params = ParametersBag.of("id=123");
AppNavItem advanced = new AppNavItem("用户", UserView.class, params);

带查询参数

传递ParametersBag以包括查询字符串：

ParametersBag params = ParametersBag.of("param1=value1&param2=value2");
AppNavItem advanced = new AppNavItem("高级", SettingsView.class, params);
advanced.setQueryParameters(params);

目标行为

使用setTarget()控制链接的打开方式。这对于外部链接或弹出视图尤其有用。

SELF（默认）：在当前视图中打开。
BLANK：在新选项卡或窗口中打开。
PARENT：在父浏览上下文中打开。
TOP：在顶层浏览上下文中打开。

AppNavItem help = new AppNavItem("帮助", "https://support.example.com");
help.setTarget(AppNavItem.NavigationTarget.BLANK);

前缀和后缀

AppNavItem支持前缀和后缀组件。使用这些提供图标、徽章或按钮的视觉清晰度。

前缀：出现在标签之前，适用于图标。
后缀：出现在标签之后，非常适合徽章或操作。

AppNavItem notifications = new AppNavItem("警报");
notifications.setPrefixComponent(TablerIcon.create("alert"));
notifications.setSuffixComponent(TablerIcon.create("link"));

自动展开组

在AppNav组件上使用setAutoOpen(true)以在应用程序刷新时自动展开嵌套组。

nav.setAutoOpen(true);

添加和嵌套条目​

链接条目​

静态路径​

注册的视图​

带查询参数​

目标行为​

前缀和后缀​

自动展开组​

样式 AppNavItem​