page-container
基础库 3.61.0 开始支持本组件。渲染框架支持情况:WebView。
页面容器。
小程序如果在页面内进行复杂的界面设计(如在页面内弹出半屏的弹窗、在页面内加载一个全屏的子页面等),用户进行返回操作会直接离开当前页面,不符合用户预期,预期应为关闭当前弹出的组件。为此提供“假页”容器组件,效果类似于 popup 弹出层,页面内存在该容器时,当用户进行返回操作,关闭该容器不关闭页面。返回操作包括右滑手势、Android 物理返回键和调用 navigateBack 接口。
属性说明
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
show | boolean | false | 否 | 是否显示容器组件。 | 3.61.0 |
duration | number | 250 | 否 | 动画时长,单位为毫秒。 | 3.61.0 |
z-index | number | 100 | 否 | z-index 层级。 | 3.61.0 |
overlay | boolean | true | 否 | 是否显示遮罩层。 | 3.61.0 |
position | string | bottom | 否 | 弹出位置,可选值为 top、bottom、right、center。 | 3.61.0 |
round | boolean | false | 否 | 是否显示圆角。 | 3.61.0 |
close-on-slide-down | boolean | false | 否 | 是否在下滑一段距离后关闭。 | 3.61.0 |
overlay-style | string | | 否 | 自定义遮罩层样式。 | 3.61.0 |
custom-style | string | | 否 | 自定义弹出层样式。 | 3.61.0 |
bind:beforeenter | eventhandle | | 否 | 进入前触发。 | 3.61.0 |
bind:enter | eventhandle | | 否 | 进入中触发。 | 3.61.0 |
bind:entercancelled | eventhandle | | 否 | 进入被打断时触发(通过 a:if 打断时不触发)。 | 3.61.0 |
bind:afterenter | eventhandle | | 否 | 进入后触发。 | 3.61.0 |
bind:beforeleave | eventhandle | | 否 | 离开前触发。 | 3.61.0 |
bind:leave | eventhandle | | 否 | 离开中触发。 | 3.61.0 |
bind:leavecancelled | eventhandle | | 否 | 离开被打断时触发(通过 a:if 打断时不触发)。 | 3.61.0 |
bind:afterleave | eventhandle | | 否 | 离开后触发。 | 3.61.0 |
bind:clickoverlay | eventhandle | | 否 | 点击遮罩层时触发。 | 3.61.0 |
配置说明
在 app.json 的 enableComponents 配置中配置该组件,即可使用 page-container。
{ "enableComponents": ["page-container"] }
扫码体验
在开发者工具中打开下方代码示例,使用真机预览体验。
代码示例
Bug & Tip
- •Tip:一个页面只能存在一个 page-container 组件。如果使用多个(无论嵌套还是并列),将在运行时报错
[Component] <page-container>: Only one instance can exist.,只有第 一个 page-container 生效。- •Tip:page-container 是半受控组件,即该组件表现由用户行为和 data 两方共同决定。可以通过设置 show 属性来触发对应效果,但由用户行为导致的失去焦点、页面容器关闭行为不会同步更新 data。因此不能根据 data 判断组件当前的状态。
