Propiedades de componentes en Vue.js

En este post te hablaré un poco sobre las props o propiedades de componentes en Vue.js. Las propiedades permiten pasar datos a un componente hijo, mejorando así la comunicación.

Gracias a las props en Vue así como $emit y on, podemos comunicar componentes de manera fácil.

Pasando propiedades a un componente

Para pasar valores o datos a un componente hijo, simplemente se las pasamos como si fueran atributos. Por ejemplo, yo tengo un componente al que le paso los detalles de un archivo, para ello:

<CompartirArchivo :archivo="archivoCompartido"></CompartirArchivo>

Estoy pasando mi variable archivoCompartido a la propiedad archivo del componente. Por cierto, esta variable, la de archivoCompartido debe estar en mi data:

export default {
  name: "VerArchivos",
  components: {CompartirArchivo},
  data: () => ({
    archivos: [],
    cargando: false,
    archivoCompartido: {}, // <-- Aquí
    mostrarModalCompartir: false,
  }),
}

Cuando este valor cambie en el padre, cambiará dentro del hijo. Ahora veamos cómo trabajar con esa propiedad en el componente que se incluye.

Recibir props en componente de Vue

Para indicar que queremos recibir una propiedad o valor en el componente hijo, indicamos el arreglo props dentro del componente:

export default {
  name: "CompartirArchivo",
  props: ["archivo"], // <-- Estoy indicando que recibiré la propiedad archivo
  data: () => ({
    cargando: false,
    compartido: false,
    hash: "",
  }),
}

Podemos indicar más propiedades, ya que las mismas se declaran en un arreglo. Y luego podemos acceder a ellas ya en el hijo a través de this:

const respuesta = await ArchivosService.dejarDeCompartir(this.archivo.id);

Por ejemplo en este caso estoy accediendo a this.archivo.id que no es más que acceder a la propiedad id del objeto que me están pasando como archivo.

Obviamente también se puede acceder a ellos en las vistas:

<div class="notification is-primary">
  <p>
    <strong>Nombre:&nbsp;</strong>{{ archivo.nombre_original }}
  </p>
  <p>
    <strong>Creado:&nbsp;</strong>{{ archivo.fecha_creacion }}
  </p>
  <p>
    <strong>Tamaño:&nbsp;</strong>{{ archivo.tamanio_bytes | bytes_legibles }}
  </p>
</div>

Y de este modo podemos pasar valores a nuestros componentes hijos. En este caso las pasé con la sintaxis :propiedad para que sean valores dinámicos, pero siempre puedes pasar los datos sin los dos puntos.

Para terminar te dejo el post de comunicación de componentes en Vue y más sobre JavaScript.