Skip to content

Popup

A popup layer that slides in from the specified direction, commonly used to display content that requires user attention or interaction.

Basic Usage

vue
<script setup>
import { ref } from 'vue'
const show = ref(false)
</script>

<template>
  <see-popup v-model:show="show" position="bottom">
    <view class="content">Popup Content</view>
  </see-popup>
</template>

Props

PropTypeDefaultDescription
showbooleanfalseWhether to show the popup
positionstring'center'Popup position: top, bottom, left, right, center
zIndexnumber100Custom z-index
durationnumber300Animation duration in ms
isOverlaybooleantrueWhether to show overlay mask
isCloseOnClickOverlaybooleantrueWhether to close when clicking overlay
isLockScrollbooleantrueWhether to lock background scroll
isShowCloseBtnbooleanfalseWhether to show close button
isRoundbooleanfalseWhether to show rounded corners
isSafeAreabooleantrueWhether to enable safe area adaptation
isShowHeaderbooleanfalseWhether to show header area
titlestring''Header title text
beforeClosefunctionundefinedCallback before closing, return false to prevent close

Events

EventParametersDescription
onOpen-Triggered when popup starts to open
onOpened-Triggered after popup opening animation completes
onClose-Triggered when popup starts to close
onClosed-Triggered after popup closing animation completes
onClickOverlay-Triggered when overlay is clicked
update:show(value: boolean)Triggered when show state changes

Liao ICP No. 2025070134