9. Single File Components (SFC) y la Revolución de <script setup>
Estructura componentes en archivos .vue organizando template, script y style scoped, y aprovecha el azúcar sintáctico de <script setup> para reducir código repetitivo y maximizar el rendimiento.
El Estándar de la Industria: Single File Components (.vue) y <script setup>
Los Single File Components (SFC) son la joya de la corona del ecosistema de Vue. Permiten encapsular la vista (HTML), la lógica reactiva (JS/TS) y los estilos visuales (CSS) de un componente en un único archivo con extensión .vue. Con la llegada de <script setup> en Vue 3, la cantidad de código repetitivo (boilerplate) se redujo drásticamente.
1. Anatomía Canónica de un Archivo .vue
Un componente moderno de Vue 3 se divide en tres bloques bien delimitados:
<!-- 1. Lógica Reactiva (Script Setup) -->
<script setup lang="ts">
import { ref } from 'vue';
import TarjetaUsuario from './TarjetaUsuario.vue'; // ¡Directamente usable en template!
const contador = ref(0);
const incrementar = () => contador.value++;
</script>
<!-- 2. Vista Declarativa (Template) -->
<template>
<div class="contador-box">
<h3>Valor: {{ contador }}</h3>
<button @click="incrementar">+1</button>
<TarjetaUsuario :puntos="contador" />
</div>
</template>
<!-- 3. Estilos Aislados (Scoped CSS) -->
<style scoped>
.contador-box {
padding: 16px;
background: #f8fafc;
border-radius: 8px;
}
</style>
2. Las Ventajas Decisivas de <script setup>
- Cero Boilerplate: Ya no necesitas escribir
export default { setup() { return { ... } } }. Cualquier variable, función o import declarado en el bloque está automáticamente disponible en el template. - Importación directa de componentes: No se requiere la propiedad
components: { TarjetaUsuario }. Al importar un componente, queda registrado y listo para usarse como etiqueta. - Mayor Rendimiento en Runtime: La plantilla se compila como una función de renderizado en el mismo alcance léxico que el script, evitando llamadas intermedias a proxies de contexto.
- Soporte de Tipos Puro con TypeScript: Macrocompiladores nativos como
defineProps()ydefineEmits()sin necesidad de runtime overhead.
3. El Aislamiento de Estilos: <style scoped>
Al agregar el atributo scoped a la etiqueta <style>, PostCSS y el compilador de Vue transforman tus selectores agregando un atributo de datos único (por ejemplo: .boton[data-v-7ba5bd90]). Esto garantiza que tus estilos nunca colisionarán ni afectarán accidentalmente a otros componentes de la aplicación.
⚡ Estructura de un Componente Moderno con Composición Declarativa
Ejemplo didáctico de cómo script setup resuelve lógica, eventos y renderizado limpio.
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="utf-8">
<title>Componentes en Vue 3</title>
<link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
<style>
/* Estilos encapsulados de demostración */
.sfc-card {
border-top: 4px solid #42b883;
transition: transform 0.2s;
}
.sfc-card:hover {
transform: translateY(-2px);
}
</style>
</head>
<body class="p-4 bg-light">
<div id="app" class="card shadow-sm sfc-card p-4 mx-auto" style="max-width: 500px;">
<div class="d-flex align-items-center justify-content-between mb-3">
<h5 class="fw-bold text-success mb-0"><script setup> en Acción</h5>
<span class="badge bg-dark">SFC .vue</span>
</div>
<p class="text-secondary small">
Observa cómo los datos del usuario y los eventos se gestionan de forma declarativa sin retornos manuales.
</p>
<div class="p-3 bg-white border rounded mb-3">
<div class="d-flex align-items-center gap-3">
<div class="rounded-circle bg-success text-white d-flex align-items-center justify-content-center fs-4" style="width: 50px; height: 50px;">
{{ inicial }}
</div>
<div>
<h6 class="mb-0 fw-bold">{{ perfil.nombre }}</h6>
<span class="badge bg-primary">{{ perfil.especialidad }}</span>
</div>
</div>
</div>
<div class="d-flex gap-2">
<button @click="cambiarRol" class="btn btn-outline-success flex-fill">Alternar Rol</button>
<button @click="resetear" class="btn btn-outline-secondary">Restablecer</button>
</div>
</div>
<script src="/assets/vendor/vue/vue.global.prod.js"></script>
<script>
if (!window.Vue) {
document.write('<script src="https://cdn.jsdelivr.net/npm/vue@3/dist/vue.global.prod.js"><\/script>');
}
</script>
<script>
const { createApp, reactive, computed } = Vue;
// Equivalente del comportamiento de <script setup> en entorno monolitico:
createApp({
setup() {
const perfil = reactive({
nombre: 'David Amador',
especialidad: 'Vue 3 + Composition API'
});
const inicial = computed(() => perfil.nombre.charAt(0));
const cambiarRol = () => {
perfil.especialidad = perfil.especialidad.includes('Vue')
? 'Arquitecto FullStack (PHP / Node / Vue)'
: 'Vue 3 + Composition API';
};
const resetear = () => {
perfil.nombre = 'David Amador';
perfil.especialidad = 'Vue 3 + Composition API';
};
return {
perfil,
inicial,
cambiarRol,
resetear
};
}
}).mount('#app');
</script>
</body>
</html>
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Cuál es la principal ventaja que introdujo la sintaxis <script setup> frente a la sintaxis setup() tradicional en archivos .vue?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Vue.js 3 Profesional: Composition API, Script Setup, Pinia & Vite y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.