Tema 9 · SFC & Script Setup

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() y defineEmits() 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.

index.html
Solo lectura
<!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">&lt;script setup&gt; 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>
Pruébalo tú mismo » Se abre en una nueva pestaña con ejecución en vivo
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.