讲师中心 微信公众号
AI工具推荐 视频效率加速

Vue 3 中实现多个可复用模态框实例的组合式函数最佳实践

胖静姑娘_7549

胖静姑娘_7549

发布时间:2026-01-29 09:04:10

|

576人浏览过

|

来源于php中文网

原创

Vue 3 中实现多个可复用模态框实例的组合式函数最佳实践

在 vue 3 组合式 api 中,一个 composable(如 `usemodal`)默认返回共享响应式状态,无法直接支持多实例;需通过解构重命名或参数化设计,使每个调用独立维护自身状态。

要让 useModal 同时支持多个模态框实例(如 Modal 1 和 Modal 2),核心在于确保每次调用 useModal() 都创建一份独立的响应式状态副本——而 Vue 的 ref、reactive 等响应式 API 天然具备该能力:只要 useModal 是一个普通函数(非单例),每次调用都会新建 ref 实例。

✅ 正确做法:利用 ES6 解构重命名,为不同实例分配专属变量名

// useModal.ts
import { ref } from 'vue'

export function useModal() {
  const isOpen = ref(false)
  const toggle = () => { isOpen.value = !isOpen.value }
  const open = () => { isOpen.value = true }
  const close = () => { isOpen.value = false }

  return {
    isOpen,
    toggle,
    open,
    close
  }
}

在组件中多次调用并解构重命名:

vue-composition-api-best-practices
vue-composition-api-best-practices

Vue 3 组合式 API 与 最佳实践,涵盖代码组织、useXxx 模式、组合式函数设计、Store 集成、响应式优化及功能抽取。

下载
<!-- Component.vue -->
<template>
  <button @click="modalOne.toggle">Open Modal 1</button>
  <button @click="modalTwo.toggle">Open Modal 2</button>

  <Modal :is-open="modalOne.isOpen" @close-modal="modalOne.close">Modal 1 Content</Modal>
  <Modal :is-open="modalTwo.isOpen" @close-modal="modalTwo.close">Modal 2 Content</Modal>
</template>

<script setup lang="ts">
import { useModal } from './composables/useModal'
import Modal from './Modal.vue'

// ✅ 每次调用 create 独立状态 —— 关键!
const modalOne = useModal()
const modalTwo = useModal()
</script>

⚠️ 注意事项:

立即学习“前端免费学习笔记(深入)”;

  • ❌ 不要写成 const { isOpen: isOneOpen } = useModal() 再重复解构(虽语法合法,但语义模糊且易出错);推荐直接赋值为对象(如 modalOne),语义更清晰、API 更一致、便于后续扩展方法(如 open()/close())。
  • ❌ 避免在 setup() 外部缓存 useModal() 返回值(如 const sharedModal = useModal()),否则所有组件将共享同一状态。
  • ✅ 若需进一步抽象(如带初始状态或 ID),可升级 useModal 为工厂函数:
// 支持初始化与标识
export function useModal(initial = false, id?: string) {
  const isOpen = ref(initial)
  const toggle = () => { isOpen.value = !isOpen.value }

  return {
    id,
    isOpen,
    toggle,
    open: () => { isOpen.value = true },
    close: () => { isOpen.value = false }
  }
}

// 使用时可传参区分行为
const modalA = useModal(true, 'login')
const modalB = useModal(false, 'confirm')

? 总结:Vue 3 的 composables 本质是「状态工厂函数」,其复用性正源于每次调用都生成全新响应式引用。无需特殊技巧,只需保证:多次调用 + 合理命名/组织返回值,即可优雅支撑任意数量的独立模态框、抽屉、提示框等交互组件。

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
es6新特性
es6新特性

es6新特性有:1、块级作用域变量;2、箭头函数;3、模板字符串;4、解构赋值;5、默认参数;6、 扩展运算符;7、 类和继承;8、Promise。本专题为大家提供es6新特性的相关的文章、下载、课程内容,供大家免费下载体验。

285

2023.07.17

es6新特性有哪些
es6新特性有哪些

es6的新特性有:1、块级作用域;2、箭头函数;3、解构赋值;4、默认参数;5、扩展运算符;6、模板字符串;7、类和模块;8、迭代器和生成器;9、Promise对象;10、模块化导入和导出等等。本专题为大家提供es6新特性的相关的文章、下载、课程内容,供大家免费下载体验。

406

2023.08.04

JavaScript ES6新特性
JavaScript ES6新特性

ES6是JavaScript的根本性升级,引入let/const实现块级作用域、箭头函数解决this绑定问题、解构赋值与模板字符串简化数据处理、对象简写与模块化提升代码可读性与组织性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

375

2025.12.24

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2278

2023.09.20

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

100

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

60

2026.10.22

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

60

2026.10.22

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

20

2026.10.22

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。

60

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app快速上手
uni-app快速上手

共0课时 | 0人学习

Vue 教程
Vue 教程

共42课时 | 17.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn