更新记录

1.0.8(2024-08-01) 下载此版本

增加示例

1.0.7(2024-07-30) 下载此版本

适配r-theme

1.0.6(2024-07-23) 下载此版本

修复控制台警告

查看更多

平台兼容性

Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.1.0 app-vue
钉钉小程序 快手小程序 飞书小程序 京东小程序
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

r-overlay

r-overlay 是一个基于 r-animation 的一个 vue3 的遮罩层组件,一般用于弹窗场景。

示例

<template>
  <r-config-provider :themeName="themeName">
    <page-header title="遮罩层"></page-header>
    <view style="padding: 20rpx">
      <r-divider content-position="left">基本使用</r-divider>
      <r-button
        type="primary"
        @click="
          () => {
            show = true;
            zIndex = 1;
            hasContent = false;
          }
        "
        >显示遮罩层</r-button
      >
      <r-divider content-position="left">嵌入内容</r-divider>
      <r-button
        type="primary"
        @click="
          () => {
            show = true;
            zIndex = 1;
            hasContent = true;
          }
        "
        >嵌入内容</r-button
      >
      <r-divider content-position="left">设置 z-index </r-divider>
      <r-button
        type="primary"
        @click="
          () => {
            show = true;
            zIndex = 1000;
            hasContent = false;
          }
        "
        >设置 z-index
      </r-button>
    </view>

    <r-overlay :show="show" :zIndex="zIndex" @click="show = false">
      <view class="wrapper" @click.stop="show = false" v-if="hasContent">
        <view class="block" />
      </view>
    </r-overlay>
  </r-config-provider>
</template>

<script setup>
import { ref } from "vue";
import useTheme from "@/hooks/useTheme";
const { themeName } = useTheme();
const zIndex = ref(1);
const show = ref(false);
const hasContent = ref(false);
</script>
<style scoped>
.wrapper {
  display: flex;
  align-items: center;
  justify-content: center;
  height: 100%;
}

.block {
  width: 120px;
  height: 120px;
  background-color: #fff;
}
</style>

API

Props

参数 说明 类型 默认值 可选值
show 加载动画的显隐 Boolean false true
entryClass 入场动画 String animate__fadeIn animate__bounceIn ...更多可移步到官网查看 https://animate.style/
exitClass 退场动画 String animate__fadeOut animate__bounceOut ...更多可移步到官网查看 https://animate.style/
duration 持续时间(ms) Number 1000 -
delay 延迟时间(ms) Number 0 -
customStyle 自定义样式 Object {} -
customTransitionStyle 自定义动画组件样式 (r-animation 的 customStyle 属性) Object {} -
customClass 自定义类名 String, | Array |Object '' -
color 背景颜色 String rgba(0,0,0,0.7) -
zIndex 层级 Number 2000 -
themeName 主题名称 String default 可自定义 r-theme 设置

Slots

名称 说明
default 组件内部,将需要添加内容放置于此

Events

事件名 说明 回调参数
open 打开的回调 -
opened 打开动画结束时的回调 -
close 关闭的回调 -
closed 关闭动画结束时的回调 -
click 点击遮罩层的事件 e

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问