用途:构建网站主水平导航栏 <sgds-mainnav>,小屏幕下折叠为汉堡菜单。导航项用 <sgds-mainnav-item>,下拉菜单用 <sgds-mainnav-dropdown>。安装与框架集成(React 19+ 与 React ≤18、Vue、Angular)参见 sgds-components-setup;该组件不暴露自定义属性和 CSS part,不支持自定义样式修改。
主要能力:expand 属性控制折叠断点,取值 sm|md|lg|xl|xxl|always|never,默认 lg(低于 lg 断点折叠);always 永不折叠;never 始终折叠。fluid 布尔属性启用全宽容器,默认 false 为定宽。brandHref 设置品牌 logo 链接地址,默认空字符串。
用法:品牌 logo 放在 brand 插槽的 <img> 元素内,首页链接设 brandHref="/";普通导航链接在 <sgds-mainnav-item> 内使用 <a> 标签,active 标记当前页,disabled 禁用该项;右对齐项(如登录按钮、联系方式)放在 end 插槽,折叠时也并入汉堡菜单;non-collapsible 插槽内容在所有屏幕尺寸下保持可见。下拉项用 <sgds-mainnav-dropdown>,toggler 插槽放触发元素,内部为 <sgds-dropdown-item>,其属性继承 <sgds-dropdown>(active、menuIsOpen、close、drop)。主导航事件:sgds-show、sgds-after-show、sgds-hide、sgds-after-hide,仅在移动端断点使用汉堡切换时触发。新加坡政府站点需在 <sgds-mainnav> 上方使用 <sgds-masthead>。
限制:组件不提供样式定制接口;资料未提供更多平台或版本细节。