引言

在现代前端应用中，模态框(Modal)是最常用的UI组件之一。然而，随着应用规模的增长，模态框的状态管理往往会变得混乱。本文将介绍一种基于 Pinia 和 Vue 3 Composition API 的类型安全模态框管理方案，帮助你优雅地处理应用中的各种模态框状态。

核心概念解析

1. Pinia 状态管理

Pinia 是 Vuex 的继任者，也是 Vue3 官方推荐的状态管理库，相比 Vuex 提供了更好的 TypeScript 支持和更简洁的 API。我们的解决方案将基于 Pinia 来存储和管理所有模态框的状态。

2. 类型安全的必要性

在大型项目中，确保模态框状态和操作的类型安全可以显著减少运行时错误，并提高开发效率。我们的方案充分利用 TypeScript 的泛型和类型推断来实现这一点。

实现详解

1. 定义模态框状态类型

首先，我们需要定义应用中所有模态框的状态类型：

type BaseModalState = {
  open: boolean;
};

type ModalStates = {
  taskCompleteModal: BaseModalState;
  recConfirmModal: BaseModalState & { tipsText?: string };
};

type ModalKey = keyof ModalStates;

这里我们定义了一个基础模态框状态 BaseModalState，然后通过 ModalStates 类型扩展定义了具体的模态框类型。

2. 创建 Pinia Store

接下来，我们创建 Pinia store 来管理这些模态框状态：

const useModalStore = defineStore('APP_MODAL_STORE', () => {
  const modals = ref<ModalStates>({
    taskCompleteModal: { open: false },
    recConfirmModal: { open: false, tipsText: '' },
  });

  function updateModal<K extends ModalKey>(
    key: K,
    value: Partial<ModalStates[K]>
  ) {
    modals.value[key] = { ...modals.value[key], ...value };
  }

  return {
    modals,
    updateModal,
  };
});

这个 store 提供了：

• modals: 响应式对象，存储所有模态框状态
• updateModal: 用于更新特定模态框状态的通用方法

3. 创建便捷的 Composition 函数

为了更方便地在组件中使用，我们创建了一个 useModal 组合式函数：

export function useModal<K extends ModalKey>(
  key: K
): {
  state: ComputedRef<ModalStates[K]>;
  update: (payload: Partial<ModalStates[K]>) => void;
} & {
  [P in keyof ModalStates[K]]: ComputedRef<ModalStates[K][P]>;
} {
  const store = useModalStore();
  const state = computed(() => store.modals[key]);

  const result: Record<string, any> = {
    state,
    update: (payload: Partial<ModalStates[K]>) =>
      store.updateModal(key, payload),
  };

  for (const field in state.value) {
    if (Object.prototype.hasOwnProperty.call(state.value, field)) {
      result[field] = computed(
        () => state.value[field as keyof ModalStates[K]]
      );
    }
  }

  return result as any;
}

这个函数为每个模态框状态属性生成了计算属性，这一步很重要，使得在组件中可以更方便地访问和更新状态。

使用示例

1. 在组件中使用

<script setup lang="ts">
import { useModal } from './modalStore';

const {
  open: isTaskModalOpen,
  update: updateTaskModal
} = useModal('taskCompleteModal');

const openModal = () => {
  updateTaskModal({ open: true });
};
</script>

<template>
  <button @click="openModal">打开任务完成模态框</button>
  <TaskCompleteModal v-model="isTaskModalOpen" />
</template>

2. 带有额外属性的模态框

<script setup lang="ts">
import { useModal } from './modalStore';

const {
  open: isConfirmModalOpen,
  tipsText,
  update: updateConfirmModal
} = useModal('recConfirmModal');

const showConfirm = () => {
  updateConfirmModal({
    open: true,
    tipsText: '您确定要执行此操作吗？'
  });
};
</script>

<template>
  <button @click="showConfirm">显示确认对话框</button>
  <ConfirmModal v-model="isConfirmModalOpen" :tips-text="tipsText" />
</template>

方案优势

1. 类型安全：所有模态框状态和操作都有严格的类型检查
2. 集中管理：所有模态框状态集中在一个 store 中，便于维护，也可根据实际情况拆分出不同的 modal store
3. 使用便捷：useModal 函数提供了简洁的 API 来访问和更新状态
4. 响应式：基于 Vue 的响应式系统，状态变化自动更新视图
5. 可扩展：添加新模态框只需扩展 ModalStates 类型

总结与延伸

本文介绍的类型安全模态框管理方案适用于中大型 Vue 项目，特别是那些需要管理多个模态框状态的应用。通过结合 Pinia 和 TypeScript 的强大功能，我们实现了既安全又易用的解决方案。希望这个方案能帮助你更好地管理 Vue 应用中的模态框状态。如果你有更复杂的需求，可以考虑在此基础上进一步扩展和完善。