用途:帮助用户搭建 SGDS(SGDS Web Component)应用页面布局,按应用类型在两种推荐模板中选择:面向公众的网站、信息或事务页面用 Simple App Layout;内部工具、仪表盘、管理门户或需要常驻侧边导航的数据密集型应用用 Sidebar App Layout。
前置条件:使用前需导入以下 CSS: import "@govtechsg/sgds-web-component/themes/day.css"; import "@govtechsg/sgds-web-component/css/sgds.css"; import "@govtechsg/sgds-web-component/css/utility.css"; 完整安装见 sgds-components-setup。
主要能力:
- Simple App Layout:结构为 masthead → mainnav → content → footer 的纵向堆叠;内容容器用 .sgds-container,居中且随视口响应式增长(<512px 为 calc(100% - 40px),≥512px 为 calc(100% - 48px),≥768px 为 calc(100% - 56px),≥1024px 为 888px,≥1280px 为 1168px,≥1440px 为 1312px)。
- Sidebar App Layout:顶部为 masthead + mainnav 的粘性顶栏,主体为可独立滚动的粘性侧边栏 + 可滚动主内容区与页脚;主内容容器用 .sgds-container-sidebar(<768px 为 100%,≥768px 为 calc(100% - 96px),≥1024px 为 840px,≥1280px 为 888px,≥1440px 为 1024px)。
使用方式:Simple 布局用 sgds-masthead 与 sgds-mainnav(fluid),内容放在 .sgds-container 内,页脚置于内容列中。Sidebar 布局需把 masthead + mainnav 包在同一个 div 中并整体加 sgds:sticky;侧边栏列须同时具备 sgds:sticky、sgds:top-27、sgds:h-[calc(100vh-108px)] 才能保持固定;以 sgds:overflow-y-scroll 让侧边栏独立滚动;sgds-footer 放在主内容列内,避免横跨侧边栏。
限制与注意:头部高度由 masthead(约 60px)与 mainnav(约 48px)估算约 108px,若实际头部高度不同需调整 h-[calc(100vh-108px)] 与 sgds:top-27。Simple 布局不要用 sgds:max-w-* 工具类替代 .sgds-container,因其内置了正确断点;Sidebar 布局主内容列须用 .sgds-container-sidebar 而非 .sgds-container。其余细节暂未提供。