配置 | TanStarter - Ship Faster with TanStack, Cost Less with Cloudflare

属性	类型	描述
`title`	`string`	菜单项的显示文本
`description`	`string?`	下拉项的可选描述
`icon`	`TablerIcon?`	可选的 Tabler Icons 图标组件
`href`	`string?`	链接 URL 目标
`external`	`boolean?`	链接是否在新标签页中打开
`authorizeOnly`	`string[]?`	可以看到此项的用户角色
`items`	`MenuItemConfig[]?`	下拉菜单的子菜单项

最佳实践

统一使用来自 Tabler Icons 中的图标，以确保一致性
对于基于特定角色可见的菜单项，可以使用 authorizeOnly 属性来限制可见性
使用 Routes 对象（在 src/lib/routes.ts 中）定义常用的链接，以确保一致性

下一步

现在您了解了配置结构，请探索其他相关主题：

网站配置

配置网站的核心设置

导航栏配置

配置头部导航菜单

页脚配置

配置网站页脚中的链接

侧边栏配置

配置仪表盘的导航菜单

本文档提供了配置 TanStarter 模板的详细参考。

配置结构

配置被分割到 src/config 目录中的几个文件中，每个文件负责配置网站的特定方面。

website.ts

navbar-config.ts

footer-config.ts

sidebar-config.ts

avatar-config.ts

social-config.ts

配置文件

配置文件用于定义网站的结构和内容。

网站配置

网站的核心设置

导航栏配置

配置头部导航菜单

页脚配置

设置网站页脚中的链接和部分

侧边栏配置

自定义仪表盘侧边栏导航

头像配置

配置用户头像下拉菜单

社交配置

管理社交媒体链接和分享选项

共享数据类型

配置在不同菜单中使用一致的数据类型：

MenuItemConfig

具有以下属性的基本菜单项：

属性	类型	描述
`title`	`string`	菜单项的显示文本
`description`	`string?`	下拉项的可选描述
`icon`	`TablerIcon?`	可选的 Tabler Icons 图标组件
`href`	`string?`	链接 URL 目标
`external`	`boolean?`	链接是否在新标签页中打开
`authorizeOnly`	`string[]?`	可以看到此项的用户角色
`items`	`MenuItemConfig[]?`	下拉菜单的子菜单项

最佳实践

统一使用来自 Tabler Icons 中的图标，以确保一致性
对于基于特定角色可见的菜单项，可以使用 authorizeOnly 属性来限制可见性
使用 Routes 对象（在 src/lib/routes.ts 中）定义常用的链接，以确保一致性

下一步

现在您了解了配置结构，请探索其他相关主题：

网站配置

配置网站的核心设置

导航栏配置

配置头部导航菜单

页脚配置

配置网站页脚中的链接

侧边栏配置

配置仪表盘的导航菜单