vant-weapp van-popup

### Vant WeApp `van-popup` 组件使用指南

#### 创建弹出层基础结构
为了实现一个基本的弹窗功能，在页面中定义两个部分：触发按钮或其他元素以及实际显示的内容区域。通过绑定数据模型来控制可见状态。

<template>
  <!-- 触发器 -->
  <button type="default" @click="toggleShow">点击打开</button>

  <!-- 弹出框本身 -->
  <van-popup :show="isPopupVisible" position="center">
    这里放置要展示的信息...
  </van-popup>
</template>

#### 控制显隐逻辑
利用 Vue 的响应式特性管理弹窗的状态变化，通常会设置一个布尔类型的变量用于追踪当前是否应该渲染该组件。

<script setup lang="ts">
import { ref } from 'vue';

const isPopupVisible = ref(false);

function toggleShow() {
  isPopupVisible.value = !isPopupVisible.value;
}
</script>

#### 自定义样式与位置参数配置
除了默认居中的布局外，还可以调整其他属性来自定义外观和行为，比如改变方向(`position`)、宽度高度(`width`, `height`)等。

<!-- 设置底部滑动进入的效果 -->
<van-popup :show="true" position="bottom" round closeable>
  ...
</van-popup>

#### 处理交互事件
当涉及到更复杂的场景时，可以监听特定的动作并作出相应处理，例如确认提交表单或是关闭对话框。

<!-- 添加回调函数 -->
<van-popup ... @close="handleCloseEvent">
  <div>...</div>
</van-popup>

// 定义事件处理器
methods: {
  handleCloseEvent(event) {
    console.log('用户已关闭弹窗');
  }
}

以上就是针对 Vant WeApp 中 `van-popup` 组件的基础介绍及其常见应用场景下的实践案例[^2]。