You need to enable JavaScript to run this app. VueJs3中能否将数组作为model传递给组件?求用户列表滑动组件实现示例
优惠活动
大模型
产品
解决方案
定价
更多

VueJs3中能否将数组作为model传递给组件?求用户列表滑动组件实现示例

实现核心思路

这个需求实现难度很低,属于Vue3入门级组件开发范畴,不需要引入第三方动效库,用Vue3内置能力即可完整实现,核心逻辑拆分为三点:

  • 通过props接收父组件传入的用户数组,完成列表的基础结构渲染
  • 借助Vue内置的<Transition>组件配合原生CSS,实现列表从屏幕外滑入展示、点击按钮滑出屏幕的动效
  • 在组件内部维护独立的显示状态变量,绑定给组件内置的控制按钮,点击即可切换状态触发对应动效
可直接复用的示例代码

代码分为父组件传参、UserList子组件实现两部分,完全适配Vue3的<script setup>写法,没有复杂逻辑:

  1. 父组件(App.vue),负责传入用户数组

    <template>
      <!-- 传入用户数组给自定义用户列表组件 -->
      <UserList :user-list="testUsers" />
    </template>
    
    <script setup>
    import { ref } from 'vue'
    import UserList from './components/UserList.vue'
    
    // 模拟业务场景里的用户数据
    const testUsers = ref([
      { id: 1, name: '张三', email: 'zhangsan@demo.com' },
      { id: 2, name: '李四', email: 'lisi@demo.com' },
      { id: 3, name: '王五', email: 'wangwu@demo.com' }
    ])
    </script>
    
  2. 核心UserList子组件(components/UserList.vue),内置滑入滑出逻辑和控制按钮

    <template>
      <!-- 常驻的控制按钮,点击切换列表显示状态 -->
      <button class="toggle-btn" @click="isShowList = !isShowList">
        {{ isShowList ? '收起列表' : '展开列表' }}
      </button>
    
      <!-- Transition组件包裹动效目标,name和CSS里的动画类名对应 -->
      <Transition name="slide">
        <div v-if="isShowList" class="user-panel">
          <div class="user-item" v-for="user in userList" :key="user.id">
            <p>用户姓名:{{ user.name }}</p>
            <p>联系邮箱:{{ user.email }}</p>
          </div>
        </div>
      </Transition>
    </template>
    
    <script setup>
    import { ref } from 'vue'
    // 接收父组件传入的用户数组,加基础类型校验避免传参错误
    const props = defineProps({
      userList: {
        type: Array,
        required: true,
        default: () => []
      }
    })
    // 列表显示状态,默认值为true即页面加载完成自动滑入展示
    const isShowList = ref(true)
    </script>
    
    <style scoped>
    .toggle-btn {
      padding: 8px 16px;
      margin: 24px;
      cursor: pointer;
    }
    .user-panel {
      /* 固定定位让列表悬浮在页面侧边,方便做滑入滑出效果 */
      position: fixed;
      right: 0;
      top: 0;
      height: 100vh;
      width: 320px;
      background: #f5f5f5;
      padding: 24px;
      box-shadow: -2px 0 10px rgba(0, 0, 0, 0.1);
    }
    .user-item {
      padding: 12px 0;
      border-bottom: 1px solid #e5e5e5;
    }
    
    /* 定义滑入滑出的动画逻辑 */
    .slide-enter-from,
    .slide-leave-to {
      transform: translateX(100%); /* 动画起点/终点:完全位于屏幕右侧外 */
    }
    .slide-enter-active,
    .slide-leave-active {
      transition: all 0.3s ease; /* 动画时长和缓动曲线,可自行调整 */
    }
    </style>
    
实现时的常见踩坑提醒
  • 动效必须配合v-if使用,不要替换成v-show,否则Vue的Transition组件无法正确识别元素的离开动画,会出现滑出失效的问题
  • 动画的方向、速度、列表位置都可以通过修改CSS参数调整:比如要从屏幕左侧滑入,把transform的位移值改成translateX(-100%)即可
  • 如果需要页面加载完成后延迟一段时间再滑入列表,只需要把isShowList的初始值改成ref(false),在onMounted钩子里搭配定时器,延迟指定时间后把值改为true即可

内容的提问来源于stack exchange,提问作者Doglas

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 13:24:11