From 11c6fb21cdfb7860e47ac9f856d7a55ff61fa48f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=86=8A=E7=86=8A=E7=86=8A=E5=AD=90=E8=B7=AF?= Date: Fri, 31 Jul 2026 11:59:34 +0800 Subject: [PATCH] =?UTF-8?q?refactor:=20=E5=B0=86page-container=E9=87=8D?= =?UTF-8?q?=E5=91=BD=E5=90=8D=E4=B8=BAroot-page-layout?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 将page-container组件重命名为root-page-layout，并更新所有文档中的引用，以更好地反映其作为页面根布局的角色。已更新AGENTS.md、README.md中的引用，并相应重命名了组件使用指南。 --- AGENTS.md | 4 +- README.md | 6 +-- ...{page-container.md => root-page-layout.md} | 54 +++++++++---------- .../root-page-layout.json} | 0 .../root-page-layout.scss} | 6 +-- .../root-page-layout.ts} | 4 +- .../root-page-layout.wxml} | 6 +-- miniprogram/pages/date/date.json | 2 +- miniprogram/pages/date/date.wxml | 4 +- miniprogram/pages/login/login.json | 2 +- miniprogram/pages/login/login.wxml | 4 +- 11 files changed, 46 insertions(+), 46 deletions(-) rename docs/{page-container.md => root-page-layout.md} (82%) rename miniprogram/components/{page-container/page-container.json => root-page-layout/root-page-layout.json} (100%) rename miniprogram/components/{page-container/page-container.scss => root-page-layout/root-page-layout.scss} (81%) rename miniprogram/components/{page-container/page-container.ts => root-page-layout/root-page-layout.ts} (97%) rename miniprogram/components/{page-container/page-container.wxml => root-page-layout/root-page-layout.wxml} (83%) diff --git a/AGENTS.md b/AGENTS.md index 1d352d9..eefe736 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -51,7 +51,7 @@ miniprogram/ ├── app.json # 页面注册、自定义 TabBar、navigationStyle: "custom" ├── app.scss # 全局样式重置 ├── api/ # API 接口层（每接口一个文件 + types.ts 定义 StandardResponse） -├── components/ # 共享组件（目前仅有 page-container） +├── components/ # 共享组件（目前仅有 root-page-layout） ├── custom-tab-bar/ # 自定义 TabBar（基于 TDesign t-tab-bar） ├── pages/ # 页面（index, login, date, one~four） ├── utils/ @@ -67,7 +67,7 @@ typings/ # 全局类型声明（IAppOption、PlatformInfoType 等 ### 自定义导航栏 -`app.json` 中 `window.navigationStyle: "custom"` 全局关闭了原生导航栏。所有需要导航栏的页面必须使用 `page-container` 组件（封装 TDesign `t-navbar`），该组件自动根据页面栈深度决定是否显示返回按钮。 +`app.json` 中 `window.navigationStyle: "custom"` 全局关闭了原生导航栏。所有需要导航栏的页面必须使用 `root-page-layout` 组件（封装 TDesign `t-navbar`），该组件自动根据页面栈深度决定是否显示返回按钮。 ### 网络请求模式 diff --git a/README.md b/README.md index 7e34dc7..c89badd 100644 --- a/README.md +++ b/README.md @@ -230,9 +230,9 @@ const strDate = formatDateTime('2024-01-15', 'YYYY年MM月DD日') - `A`: 上午/下午 - `a`: 上午/下午(小写) -### PageContainer 页面容器组件 +### RootPageLayout 页面容器组件 -项目提供了基于 TDesign Navbar 封装的页面容器组件，位于 `miniprogram/components/page-container/` 目录。 +项目提供了基于 TDesign Navbar 封装的页面容器组件，位于 `miniprogram/components/root-page-layout/` 目录。 **主要特性：** @@ -242,7 +242,7 @@ const strDate = formatDateTime('2024-01-15', 'YYYY年MM月DD日') - 支持自定义导航栏样式和插槽内容 - 完整的返回事件回调支持 -详细使用说明请参考 [PageContainer 组件使用手册](docs/page-container.md)。 +详细使用说明请参考 [RootPageLayout 组件使用手册](docs/root-page-layout.md)。 ### 自定义 TabBar diff --git a/docs/page-container.md b/docs/root-page-layout.md similarity index 82% rename from docs/page-container.md rename to docs/root-page-layout.md index ac478a2..4520699 100644 --- a/docs/page-container.md +++ b/docs/root-page-layout.md @@ -1,8 +1,8 @@ -# PageContainer 组件使用手册 +# RootPageLayout 组件使用手册 ## 概述 -PageContainer 是一个基于 TDesign `t-navbar` 封装的页面容器组件，提供统一的导航栏与内容区域布局。组件内部已引入 `t-navbar`，并通过样式变量透传导航栏与容器背景配置，适用于需要自定义导航栏的页面。 +RootPageLayout 是一个基于 TDesign `t-navbar` 封装的页面容器组件，提供统一的导航栏与内容区域布局。组件内部已引入 `t-navbar`，并通过样式变量透传导航栏与容器背景配置，适用于需要自定义导航栏的页面。 ## 功能特性 @@ -22,7 +22,7 @@ PageContainer 是一个基于 TDesign `t-navbar` 封装的页面容器组件， ```json { "usingComponents": { - "page-container": "../../components/page-container/page-container" + "root-page-layout": "../../components/root-page-layout/root-page-layout" } } ``` @@ -32,48 +32,48 @@ PageContainer 是一个基于 TDesign `t-navbar` 封装的页面容器组件， ### 最简单的用法 ```xml - + 页面内容 - + ``` ### 自定义导航栏样式 ```xml - 页面内容 - + ``` ### 隐藏返回按钮 ```xml - + 页面内容 - + ``` ### 隐藏导航栏 ```xml - + 页面内容 - + ``` ### 关闭底部安全区适配 ```xml - 页面内容 - + ``` ## 样式与主题 @@ -120,12 +120,12 @@ PageContainer 是一个基于 TDesign `t-navbar` 封装的页面容器组件， ### 默认插槽 -默认插槽用于渲染页面主体内容（位于内容区域 `page-container__content` 内）： +默认插槽用于渲染页面主体内容（位于内容区域 `root-page-layout__content` 内）： ```xml - + 页面内容 - + ``` ### left 插槽 @@ -133,10 +133,10 @@ PageContainer 是一个基于 TDesign `t-navbar` 封装的页面容器组件， 自定义左侧内容（返回按钮区域）： ```xml - + 自定义左侧内容 页面内容 - + ``` ### capsule 插槽 @@ -144,10 +144,10 @@ PageContainer 是一个基于 TDesign `t-navbar` 封装的页面容器组件， 自定义胶囊区域内容： ```xml - + 自定义胶囊内容 页面内容 - + ``` ### title 插槽 @@ -155,10 +155,10 @@ PageContainer 是一个基于 TDesign `t-navbar` 封装的页面容器组件， 自定义标题区域内容： ```xml - + 自定义标题内容 页面内容 - + ``` ## 事件说明 @@ -172,14 +172,14 @@ PageContainer 是一个基于 TDesign `t-navbar` 封装的页面容器组件， ### 事件使用示例 ```xml - 页面内容 - + ``` ```typescript @@ -222,7 +222,7 @@ showLeftArrow = getCurrentPages().length > 1 && navBarLeftArrow && navBarVisible ```xml - 1 && navBarLeftArrow && navBarVisible 这是页面内容区域 - + ``` ```json @@ -247,7 +247,7 @@ showLeftArrow = getCurrentPages().length > 1 && navBarLeftArrow && navBarVisible { "navigationStyle": "custom", "usingComponents": { - "page-container": "../../components/page-container/page-container" + "root-page-layout": "../../components/root-page-layout/root-page-layout" } } ``` diff --git a/miniprogram/components/page-container/page-container.json b/miniprogram/components/root-page-layout/root-page-layout.json similarity index 100% rename from miniprogram/components/page-container/page-container.json rename to miniprogram/components/root-page-layout/root-page-layout.json diff --git a/miniprogram/components/page-container/page-container.scss b/miniprogram/components/root-page-layout/root-page-layout.scss similarity index 81% rename from miniprogram/components/page-container/page-container.scss rename to miniprogram/components/root-page-layout/root-page-layout.scss index bf38d85..0b98a67 100644 --- a/miniprogram/components/page-container/page-container.scss +++ b/miniprogram/components/root-page-layout/root-page-layout.scss @@ -1,6 +1,6 @@ -/* components/page-container/page-container.wxss */ +/* components/root-page-layout/root-page-layout.wxss */ -.page-container { +.root-page-layout { width: 100%; min-height: 100vh; display: flex; @@ -16,7 +16,7 @@ } } -.page-container__content { +.root-page-layout__content { flex: 1; width: 100%; box-sizing: border-box; diff --git a/miniprogram/components/page-container/page-container.ts b/miniprogram/components/root-page-layout/root-page-layout.ts similarity index 97% rename from miniprogram/components/page-container/page-container.ts rename to miniprogram/components/root-page-layout/root-page-layout.ts index 821aef7..af41e81 100644 --- a/miniprogram/components/page-container/page-container.ts +++ b/miniprogram/components/root-page-layout/root-page-layout.ts @@ -1,4 +1,4 @@ -// components/page-container/page-container.ts +// components/root-page-layout/root-page-layout.ts Component({ /** @@ -65,7 +65,7 @@ Component({ type: Boolean, value: true, }, - // pageContainer背景色 + // rootPageLayout 背景色 containerBackgroundColor: { type: String, value: '#f5f5f5', diff --git a/miniprogram/components/page-container/page-container.wxml b/miniprogram/components/root-page-layout/root-page-layout.wxml similarity index 83% rename from miniprogram/components/page-container/page-container.wxml rename to miniprogram/components/root-page-layout/root-page-layout.wxml index 1a170f2..2d6ac0c 100644 --- a/miniprogram/components/page-container/page-container.wxml +++ b/miniprogram/components/root-page-layout/root-page-layout.wxml @@ -1,6 +1,6 @@ - + @@ -27,7 +27,7 @@ diff --git a/miniprogram/pages/date/date.json b/miniprogram/pages/date/date.json index 4a145e0..a65e710 100644 --- a/miniprogram/pages/date/date.json +++ b/miniprogram/pages/date/date.json @@ -1,5 +1,5 @@ { "usingComponents": { - "page-container": "../../components/page-container/page-container" + "root-page-layout": "../../components/root-page-layout/root-page-layout" } } diff --git a/miniprogram/pages/date/date.wxml b/miniprogram/pages/date/date.wxml index 6828241..9f5bf59 100644 --- a/miniprogram/pages/date/date.wxml +++ b/miniprogram/pages/date/date.wxml @@ -1,5 +1,5 @@ - + @@ -69,4 +69,4 @@ - + diff --git a/miniprogram/pages/login/login.json b/miniprogram/pages/login/login.json index f0c887e..ee3742e 100644 --- a/miniprogram/pages/login/login.json +++ b/miniprogram/pages/login/login.json @@ -3,7 +3,7 @@ "navigationBarBackgroundColor": "#FFFFFF", "navigationBarTextStyle": "black", "usingComponents": { - "page-container": "../../components/page-container/page-container", + "root-page-layout": "../../components/root-page-layout/root-page-layout", "t-input": "/miniprogram_npm/tdesign-miniprogram/input/input", "t-button": "/miniprogram_npm/tdesign-miniprogram/button/button" } diff --git a/miniprogram/pages/login/login.wxml b/miniprogram/pages/login/login.wxml index c470c80..4c5650f 100644 --- a/miniprogram/pages/login/login.wxml +++ b/miniprogram/pages/login/login.wxml @@ -1,5 +1,5 @@ - + - +