TypeScript + Vue3 en la práctica

Vue 3 tiene un excelente soporte para TypeScript. Este tutorial presenta las prácticas de desarrollo de Vue 3 + TypeScript.

La Composition API de Vue 3 se combina perfectamente con el sistema de tipos de TypeScript, lo que hace que el código sea más seguro y fácil de mantener.

Ver el tutorial de Vue3:https://www.example.com/vue3/vue3-tutorial.html


Diagrama SVG: Desarrollo con Vue 3 + TypeScript Fondo Título Soporte de tipos en Vue 3 + TypeScript Componente Vue 3 Componente Vue 3 defineComponent() PropType<User> emits: ['edit', 'delete'] API de composición API de composición ref<T>(initial) computed<T>(() => {}) reactive<T>(obj) Definición de tipos Definición de tipos interface User { id: number name: string } Parte inferior: Ventajas Ventajas de Vue 3 + TypeScript Ventaja 1 Inferencia de tipos completa Ventaja 2 Verificación de tipos de props Ventaja 3 Tipos de eventos emits Flecha indicadora

¿Por qué usar TypeScript en Vue 3?

Vue 3 ha adoptado plenamente TypeScript desde su diseño inicial, ofreciendo un soporte de tipos excelente.

El estilo funcional de la Composition API encaja perfectamente con el sistema de tipos de TypeScript: ref tiene soporte de genéricos, computed tiene inferencia de tipos y props tiene verificación completa de tipos.

Usar TypeScript permite que las propiedades, eventos y datos reactivos de los componentes Vue tengan protección de tipos.

Vue 3 admite de forma nativa:El código fuente de Vue 3 está escrito en TypeScript y se integra sin problemas con TypeScript.


Creación de proyecto

Usa Vite para crear un proyecto Vue 3 con soporte de TypeScript.

Inicialización

# Crear Vue con Vite3 +Proyecto TypeScript (recomendado)
npm create vite@latest my-vue-app -- --template vue-ts

# Entrar al directorio del proyecto
cd my-vue-app

# Instalar dependencias
npm install

Recomendación:Vite es la herramienta de compilación recomendada oficialmente por Vue. Al crear un proyecto, simplemente selecciona la plantilla vue-ts.


Tipos de componentes

Usa defineComponent y PropType para definir los tipos de componentes y props.

src/components/UserCard.vue

<template>
  <div class="user-card">
    <h3>{{ user.name }}</h3>
    <p>{{ user.email }}</p>
    <button @click="handleEdit">Editar</button>
  </div>
</template>

<script lang="ts">
import { defineComponent, PropType } from 'vue'

// Definir la interfaz de tipo de usuario
interface User {
  id: number
  name: string
  email: string
}

export default defineComponent({
  name: 'UserCard',
  // Definición de props
  props: {
    // Declaración de tipos con PropType
    user: {
      type: Object as PropType<User>,
      required: true
    }
  },
  // Declarar los eventos emitidos por el componente
  emits: ['edit'],
  setup(props, { emit }) {
    // Manejar el clic de edición
    const handleEdit = () => {
      emit('edit', props.user)
    }

    return { handleEdit }
  }
})
</script>

Resultado de ejecución:

UserCard 组件渲染成功

PropType:Cuando el tipo de props es un objeto complejo, se debe usar PropType para la aserción de tipos.


Tipos de la API de composición

Al usar APIs reactivas como ref y computed, TypeScript proporciona soporte completo de tipos.

src/components/Counter.vue

<template>
  <div>
    <p>Contador: {{ count }}</p>
    <p>Duplicar: {{ doubled }}</p>
    <button @click="increment">+1</button>
    <button @click="decrement">-1</button>
  </div>
</template>

<script lang="ts">
import { ref, computed } from 'vue'

export default {
  setup() {
    // ref: define datos reactivos, el genérico especifica el tipo
    const count = ref<number>(0)

    // computed: propiedad computada, infiere automáticamente el tipo de retorno
    const doubled = computed(() => count.value * 2)

    // Definir método
    const increment = () => {
      count.value++
    }

    const decrement = () => {
      count.value--
    }

    return { count, doubled, increment, decrement }
  }
}
</script>

Resultado de ejecución:

Counter 组件渲染成功

Inferencia de tipos:La API de composición de Vue 3 infiere automáticamente los tipos según el valor inicial; para tipos complejos se puede especificar el genérico explícitamente.


Definición de interfaces

Define de forma centralizada las interfaces de tipo del proyecto en el directorio types.

src/types/index.ts

// Definición del tipo de usuario
export interface User {
  id: number       // ID de usuario
  name: string    // Nombre de usuario
  email: string   // Correo electrónico
  avatar?: string // Avatar (opcional)
}

// Objeto de transferencia de datos para crear usuario
export interface CreateUserDTO {
  name: string    // Nombre de usuario
  email: string  // Correo electrónico
  password: string // Contraseña
}

// Tipo de respuesta API genérico
export interface ApiResponse<T> {
  success: boolean  // Si fue exitoso
  data?: T         // Datos en caso de éxito
  error?: string   // Mensaje de error en caso de fallo
}

Gestión centralizada de tipos:Coloca las definiciones de tipos en el directorio types para facilitar su reutilización en múltiples componentes.


Notas

  • defineComponent:Proporciona inferencia de tipos completa
  • PropType:Los tipos de props complejos requieren el uso de
  • genéricos de ref:Especificar explícitamente tipos complejos
  • emits:Declarar tipos de eventos

Mejores prácticas:Vue 3 recomienda usar la API de composición + TypeScript para obtener la mejor experiencia de desarrollo.


Resumen

Vue 3 se combina perfectamente con TypeScript.

  • defineComponent:Obtener inferencia de tipos completa
  • PropType:Proporcionar seguridad de tipos para props
  • ref:Los parámetros genéricos especifican tipos reactivos
  • computed:Inferir automáticamente los tipos de propiedades computadas

Sugerencia:Se recomienda encarecidamente usar TypeScript en proyectos Vue 3, especialmente en aplicaciones grandes.

Otras extensiones