Skip to content

内置组件

https://developers.weixin.qq.com/miniprogram/dev/component/

RootPortal

root-portal 会让其子树脱离页面布局,适合弹窗、抽屉等浮层。基础库 2.25.2 起支持;低版本应提供普通页面布局的降级展示。

xml
<root-portal enable="{{showDialog}}">
  <view class="dialog-mask" bindtap="closeDialog">
    <view class="dialog" catchtap="noop">内容</view>
  </view>
</root-portal>

enable 控制子树是否脱离页面;遮罩层与内容层应分别处理点击事件,避免点击内容时关闭浮层。

PageContainer

page-container 是页面内的“假页”容器,适合半屏弹窗或全屏子页面。容器显示时,用户右滑、Android 物理返回键或调用 wx.navigateBack 会优先关闭容器,而不是离开当前页面。基础库 2.16.0 起支持。

xml
<page-container
  show="{{showSheet}}"
  position="bottom"
  round
  bind:clickoverlay="closeSheet"
>
  <view class="sheet">内容</view>
</page-container>

通过 show 控制显示,position 可选 topbottomrightcenter。每个页面最多只能存在一个 page-container;鸿蒙 OS 暂不能拦截页面返回。

基于 MIT 许可发布