Yt-UI
首页
快速开始
组件文档
首页
快速开始
组件文档
  • 表单组件

    • 输入框 Input
    • 多行输入框 Textarea
    • 开关 Switch
    • 多选框组 CheckboxGroup
    • 单选框组 RadioGroup
    • 滑块 Slider
    • 选择器 Picker
    • 日历 Calendar
    • 表单 Form
  • 展示组件

    • 头像 Avatar
    • 徽标 Badge
    • 卡片 Card
    • 标签 Tag
    • 步骤条 Steps
    • 结果页 Result
    • 空状态 Empty
    • 虚拟列表 VirtualList
  • 交互组件

    • 按钮 Button
    • 悬浮按钮 FAB
    • 图标 Icon
    • 搜索 Search
    • 分段器 Segment
    • 轮播 Swiper
    • 指示点 Dots
  • 反馈组件

    • 加载 Loading
    • 弹窗 Popup
    • 遮罩层 Overlay
    • 通告栏 NoticeBar
  • 导航组件

    • 标签栏 Tabbar
    • 顶部标签栏 TopTabbar
    • 折叠面板 Collapse
    • 课程表 Schedule
  • 布局组件

    • 分割线 Divider
    • 链接 Line
    • 可移动视图 MovableView

yt-overlay 遮罩层组件

属性

属性名类型默认值说明
visiblebooleanfalse是否显示
durationnumber200动画时长
zIndexnumber500层级
bgColorstring'#00000080'背景色
widthnumber | string'100%'宽度
heightnumber | string'100%'高度

事件

事件名参数说明
clicke: Event点击遮罩

示例

基本使用

<yt-overlay :visible="show" @click="show = false" />

控制显示

<yt-button @click="show = true">显示遮罩</yt-button>
<yt-overlay :visible="show" @click="show = false" />

自定义颜色

<yt-overlay :visible="show" bgColor="rgba(0,0,0,0.5)" />
<yt-overlay :visible="show" bgColor="#ffffff80" />

动画时长

<yt-overlay :visible="show" :duration="300" />
<yt-overlay :visible="show" :duration="100" />

弹窗遮罩

<yt-overlay :visible="showModal" @click="showModal = false" />
<view v-if="showModal" class="modal">弹窗内容</view>

侧边栏遮罩

<yt-overlay :visible="showSidebar" @click="showSidebar = false" />
<view v-if="showSidebar" class="sidebar">菜单</view>

加载遮罩

<yt-overlay :visible="loading" bgColor="rgba(255,255,255,0.7)">
  <view class="loading-content">
    <yt-loading />
  </view>
</yt-overlay>

图片预览

<yt-overlay :visible="showPreview" bgColor="rgba(0,0,0,0.9)" @click="showPreview = false" />
<view v-if="showPreview" class="preview">
  <image :src="imageUrl" mode="aspectFit" />
</view>

阻止滚动

<yt-overlay :visible="show" @touchmove.stop @click="show = false" />
最近更新:: 2026/1/2 20:18
Contributors: CHEEMS
Prev
弹窗 Popup
Next
通告栏 NoticeBar