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
¿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
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
<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
<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
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
Otras extensionesSugerencia:Se recomienda encarecidamente usar TypeScript en proyectos Vue 3, especialmente en aplicaciones grandes.