refactor: 将page-container重命名为root-page-layout

将page-container组件重命名为root-page-layout，并更新所有文档中的引用，以更好地反映其作为页面根布局的角色。已更新AGENTS.md、README.md中的引用，并相应重命名了组件使用指南。

miniprogram/components/root-page-layout/root-page-layout.json

@@ -0,0 +1,7 @@
+{
+  "component": true,
+  "lazyCodeLoading": "requiredComponents",
+  "usingComponents": {
+    "t-navbar": "tdesign-miniprogram/navbar/navbar"
+  }
+}

miniprogram/components/root-page-layout/root-page-layout.scss

@@ -0,0 +1,26 @@
+/* components/root-page-layout/root-page-layout.wxss */
+
+.root-page-layout {
+  width: 100%;
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
+  position: relative;
+  box-sizing: border-box;
+  background-color: var(--pg-container-bg-color);
+
+  // 预留安全区
+  &--safe {
+    padding-bottom: constant(safe-area-inset-bottom);
+    padding-bottom: env(safe-area-inset-bottom);
+  }
+}
+
+.root-page-layout__content {
+  flex: 1;
+  width: 100%;
+  box-sizing: border-box;
+  overflow-y: auto;
+  overflow-x: hidden;
+  -webkit-overflow-scrolling: touch;
+}

miniprogram/components/root-page-layout/root-page-layout.ts

@@ -0,0 +1,143 @@
+// components/root-page-layout/root-page-layout.ts
+
+Component({
+  /**
+   * 组件的属性列表
+   */
+  properties: {
+    // 导航栏标题
+    navBarTitle: {
+      type: String,
+      value: '',
+    },
+    // 是否显示返回按钮
+    navBarLeftArrow: {
+      type: Boolean,
+      value: true,
+    },
+    // 导航栏是否固定
+    navBarFixed: {
+      type: Boolean,
+      value: true,
+    },
+    // 导航栏占位
+    navBarPlaceholder: {
+      type: Boolean,
+      value: true,
+    },
+    // 是否适配安全区域顶部
+    navBarSafeAreaInsetTop: {
+      type: Boolean,
+      value: true,
+    },
+    // 导航栏层级
+    navBarZIndex: {
+      type: Number,
+      value: 10000,
+    },
+    // 是否带动画效果
+    navBarAnimation: {
+      type: Boolean,
+      value: true,
+    },
+    // 标题最大长度，超出用 "…" 表示
+    navBarTitleMaxLength: {
+      type: Number,
+      value: undefined,
+    },
+    // 是否显示导航栏
+    navBarVisible: {
+      type: Boolean,
+      value: true,
+    },
+    // 导航栏背景色
+    navBarBackgroundColor: {
+      type: String,
+      value: '#ffffff',
+    },
+    // 导航栏文本颜色（标题、返回按钮等）
+    navBarTextColor: {
+      type: String,
+      value: '#000000',
+    },
+    // 是否开启底部安全区适配
+    containerSafeAreaInsetBottom: {
+      type: Boolean,
+      value: true,
+    },
+    // rootPageLayout 背景色
+    containerBackgroundColor: {
+      type: String,
+      value: '#f5f5f5',
+    },
+  },
+
+  /**
+   * 组件的初始数据
+   */
+  data: {
+    // 是否显示返回按钮（根据页面栈判断）
+    showLeftArrow: true,
+  },
+
+  /**
+   * 组件生命周期函数
+   */
+  lifetimes: {
+    // 组件实例进入页面节点树时执行
+    attached() {
+      // 判断是否显示返回按钮
+      this.checkShowLeftArrow()
+    },
+  },
+
+  /**
+   * 属性观察器
+   */
+  observers: {
+    // 监听 visible 和 leftArrow 变化，重新判断是否显示返回按钮
+    'visible, leftArrow'() {
+      this.checkShowLeftArrow()
+    },
+  },
+
+  /**
+   * 组件的方法列表
+   */
+  methods: {
+    /**
+     * 检查是否显示返回按钮
+     * 如果页面栈中只有一个页面，或者 visible 为 false，则不显示返回按钮
+     */
+    checkShowLeftArrow() {
+      const pages = getCurrentPages()
+      const leftArrow = this.properties.navBarLeftArrow
+      const visible = this.properties.navBarVisible
+      const showLeftArrow = pages.length > 1 && leftArrow && visible
+      this.setData({
+        showLeftArrow,
+      })
+    },
+
+    /**
+     * 返回按钮点击事件
+     */
+    goBack() {
+      console.warn('点击了箭头按钮')
+      wx.navigateBack({
+        success: (res) => {
+          // 转发成功事件
+          this.triggerEvent('success', res)
+          // 转发完成事件
+          this.triggerEvent('complete', res)
+        },
+        fail: (err) => {
+          // 转发失败事件
+          this.triggerEvent('fail', err)
+          // 转发完成事件
+          this.triggerEvent('complete', err)
+        },
+      })
+    },
+  },
+})

miniprogram/components/root-page-layout/root-page-layout.wxml

@@ -0,0 +1,34 @@
+<!--components/root-page-layout/root-page-layout.wxml-->
+<view
+  class="root-page-layout {{containerSafeAreaInsetBottom ? 'root-page-layout--safe' : ''}}"
+  style="--pg-container-bg-color: {{containerBackgroundColor}};"
+>
+  <!-- 导航栏 -->
+  <t-navbar
+    title="{{navBarTitle}}"
+    left-arrow="{{showLeftArrow}}"
+    fixed="{{navBarFixed}}"
+    placeholder="{{navBarPlaceholder}}"
+    safe-area-inset-top="{{navBarSafeAreaInsetTop}}"
+    z-index="{{navBarZIndex}}"
+    animation="{{navBarAnimation}}"
+    title-max-length="{{navBarTitleMaxLength}}"
+    visible="{{navBarVisible}}"
+    bind:go-back="goBack"
+    style="--td-navbar-color: {{navBarTextColor}};--td-navbar-bg-color: {{navBarBackgroundColor}};"
+  >
+    <!-- 左侧自定义内容插槽 -->
+    <slot name="left" slot="left"></slot>
+    <!-- 胶囊区域自定义内容插槽 -->
+    <slot name="capsule" slot="capsule"></slot>
+    <!-- 标题自定义内容插槽 -->
+    <slot name="title" slot="title"></slot>
+  </t-navbar>
+
+  <!-- 内容区域 -->
+  <view
+    class="root-page-layout__content"
+  >
+    <slot></slot>
+  </view>
+</view>