抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

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 判断组件当前的状态。