u

code/g3soft-libs/docs/content/framework/.navigation.yml

@@ -0,0 +1,2 @@
+title: 框架
+icon: i-lucide-layout-dashboard

code/g3soft-libs/docs/content/framework/1.layout/.navigation.yml

@@ -0,0 +1,2 @@
+title: 布局
+icon: i-lucide-panel-left

code/g3soft-libs/docs/content/framework/1.layout/index.md

@@ -0,0 +1,21 @@
+---
+title: Layout 布局框架
+description: G3 框架的布局骨架，支持 7 种布局模式，菜单/页签数据由宿主注入
+---
+
+# Layout 布局框架
+
+`G3Layout` 是 `@g3soft/framework` 的布局骨架。它只负责「怎么摆」，不关心菜单从哪来 —— 菜单、用户、页签都由宿主通过 props / 插槽注入。
+
+点击下方按钮切换 7 种布局模式：
+
+:::demo{name="layout/basic"}
+:::
+
+## 说明
+
+- **7 种模式**：`sidebar-nav`（垂直，默认）/ `header-nav`（顶部）/ `sidebar-mixed-nav`（双列）/ `mixed-nav` / `header-sidebar-nav` / `header-mixed-nav` / `full-content`。
+- **一个组件 + 模式表驱动**：内部按 `layout` prop 条件渲染，不拆成 7 个组件。
+- **菜单数据注入**：`:menus` 直接给数组，或 `:menu-source` 给函数（framework 接管加载态）。
+- **插槽宁可多不要少**：`logo` / `header-left` / `header-right` / `sidebar-top` / `sidebar-footer` / `tabbar-extra` / `breadcrumb-extra` / `page` / `default`。
+- **主题**：偏好里的主色 / 暗色最终经 `@g3soft/ui` 的 `ConfigProvider` 派生，不另起一套变量系统。