Contenido del curso

Bienvenida al curso

1
Vue consumiendo APIs oficiales de Blizzard
13:27 min

VueCli, configuración inicial del proyecto y consumo del API de Blizzard

Creación de los componentes y layouts de nuestro proyecto

Agregando funcionalidades avanzadas a nuestro proyecto

En este bloque vamos a agregarle un poco más de contenido a nuestro layout principal. Vamos a crear el NavBar y el Footer, que será genérico a toda la apliación.

Bootstrap nos proporciona un componente de Navbar que soporta múltiples opciones. Empezamos creando la carpeta /HeaderBar dentro de nuestro directorio de componentes /components, y dentro de esta creamos nuestro archivo principal: Index.vue.
Deberías tener el archivo creado en esta ruta: /components/HeaderBar/Index.vue, con este contenido:

&lt;template&gt;
  &lt;div class=&quot;header-bar&quot;&gt;
    &lt;div class=&quot;navigation-bar&quot;&gt;
      &lt;b-navbar toggleable=&quot;lg&quot; type=&quot;dark&quot; variant=&quot;dark&quot;&gt;
        &lt;b-navbar-brand :to=&quot;{ name: 'Home' }&quot;&gt;
          &lt;img src=&quot;@/assets/img/diablo-iii.svg&quot; alt=&quot;D3&quot; width=&quot;30&quot;&gt;
          &lt;span class=&quot;font-diablo ml-2&quot;&gt;D3PF&lt;/span&gt;
        &lt;/b-navbar-brand&gt;
      &lt;/b-navbar&gt;
    &lt;/div&gt;

  &lt;/div&gt;
&lt;/template&gt;

&lt;script&gt;

export default {
  name: 'HeaderBar'
}
&lt;/script&gt;

En el proyecto original hay más componentes que no vamos a tocar en este curso, para que no se haga muy largo. Recuerda que puedes revisar en cualquier momento el código fuente completo del proyecto en https://github.com/baumannzone/diablo3-vue-platzi

Vamos a crear el componente Footer del proyecto en /components/Footer/Index.vue. Para el Footer, puedes copiar esto:

&lt;template&gt;
  &lt;footer class=&quot;footer-bar mt-5&quot;&gt;
    &lt;PoweredByFoot :icons=&quot;icons&quot;/&gt;

    &lt;hr class=&quot;my-5&quot;&gt;

    &lt;div class=&quot;row&quot;&gt;
      &lt;div class=&quot;col-sm-6 mb-sm-0 mb-5&quot;&gt;
        &lt;FootLinks/&gt;
      &lt;/div&gt;
      &lt;div class=&quot;col-sm-6&quot;&gt;
        &lt;MadeByFoot/&gt;
      &lt;/div&gt;
    &lt;/div&gt;

  &lt;/footer&gt;
&lt;/template&gt;

&lt;script&gt;
import MadeByFoot from './MadeByFoot'
import PoweredByFoot from './PoweredByFoot'
import FootLinks from './FootLinks'

export default {
  name: 'FooterBar',
  components: { FootLinks, PoweredByFoot, MadeByFoot },
  data () {
    return {
      icons: [
        {
          classes: [ 'fab', 'vuejs' ],
          color: '#4fc08d',
          href: 'https://vue.js.org/'
        },
        {
          classes: [ 'fab', 'bootstrap' ],
          color: '#7952b3',
          href: 'https://bootstrap-vue.js.org/'
        },
        {
          classes: [ 'fab', 'battle-net' ],
          href: 'https://develop.battle.net/documentation/diablo-3/community-apis'
        },
        {
          classes: [ 'fab', 'github' ],
          color: '#e4e4e4',
          href: 'https://github.com/baumannzone'
        },
        {
          classes: [ 'fab', 'font-awesome' ],
          color: '#0e95ff',
          href: 'https://fontawesome.com/'
        }
      ]
    }
  }
}
&lt;/script&gt;

Dentro de este componente hay 3 componentes más. Vamos a crearlos:

/Footer/FootLinks.vue

&lt;template&gt;
  &lt;div&gt;
    &lt;b-nav small align=&quot;start&quot;&gt;
      &lt;b-nav-item :to=&quot;{name: 'Home'}&quot;&gt;Home&lt;/b-nav-item&gt;
      &lt;b-nav-item :to=&quot;{name: 'About'}&quot;&gt;About&lt;/b-nav-item&gt;
      &lt;b-nav-item href=&quot;https://github.com/baumannzone/diablo3-vue-platzi&quot; target=&quot;_blank&quot;&gt;Github&lt;/b-nav-item&gt;
    &lt;/b-nav&gt;
  &lt;/div&gt;
&lt;/template&gt;

&lt;script&gt;
export default {
  name: 'FootLinks'
}
&lt;/script&gt;

/Footer/MadeByFoot.vue

&lt;template&gt;
  &lt;p class=&quot;text-muted m-0 pt-1 pl-3 text-left text-sm-right&quot;&gt;
    &lt;small&gt;
      Made by
      &lt;a href=&quot;https://twitter.com/baumannzone&quot; target=&quot;_blank&quot;&gt;Jorge Baumann&lt;/a&gt;
      for
      &lt;a href=&quot;https://platzi.com/&quot; target=&quot;_blank&quot;&gt;Platzi&lt;/a&gt;
    &lt;/small&gt;
  &lt;/p&gt;
&lt;/template&gt;

&lt;script&gt;
export default {
  name: 'MadeByFoot'
}
&lt;/script&gt;

/Footer/PoweredByFoot.vue

&lt;template&gt;
  &lt;div class=&quot;text-center &quot;&gt;
    &lt;p class=&quot;text-muted&quot;&gt;Powered by&lt;/p&gt;

    &lt;ul class=&quot;list-inline&quot;&gt;
      &lt;li class=&quot;list-inline-item mx-2&quot; v-for=&quot;(icon, idx) in icons&quot; :key=&quot;idx&quot;&gt;
        &lt;a :href=&quot;icon.href&quot; target=&quot;_blank&quot; :title=&quot;icon.href&quot;&gt;
          &lt;font-awesome-icon :icon=&quot;icon.classes&quot; class=&quot;fa-lg&quot; :style=&quot;{'color': icon.color}&quot;/&gt;
        &lt;/a&gt;
      &lt;/li&gt;
    &lt;/ul&gt;
  &lt;/div&gt;
&lt;/template&gt;

&lt;script&gt;
export default {
  name: 'PoweredByFoot',
  props: {
    icons: {
      required: true,
      type: Array
    }
  }
}
&lt;/script&gt;

Hemos creado el footer de nuestra app con algunos links de utilidad, íconos de Fontawesome, etc.

Para poder ver la barra de navegación y el footer en nuestra app, tenemos que dar de alta en el layout principal dichos componentes. Para ello, nos vamos a /layouts/MainLayout.vue y agregamos los componentes de Footer y NavBar que acabamos de crear:

&lt;template&gt;
  &lt;div class=&quot;container&quot;&gt;
    &lt;HeaderBar/&gt;

    &lt;router-view/&gt;

    &lt;FooterBar/&gt;
  &lt;/div&gt;
&lt;/template&gt;

&lt;script&gt;
import HeaderBar from '@/components/HeaderBar/Index'
import FooterBar from '@/components/FooterBar/Index'

export default {
  name: 'MainLayout',
  components: {
    HeaderBar,
    FooterBar
  }
}
&lt;/script&gt;

Si te fijas, en la consola hay un error. Abrimos el navegador y en la terminal también hay un error:

El error es el siguiente:

> 🚫 Unknown custom element: <font-awesome-icon> - did you register the component correctly? For recursive components, make sure to provide the "name" option.

Lo que quiere decir es que hay un componente, en concreto este <font-awesome-icon>, que estamos usando, pero que Vue no lo entiende, o no lo hemos dado de alta. Tal vez lo hayas visto, pero si no, en el footer que acabamos de crear estamos usando dicho componente para mostrar los íconos de los links.
Necesitamos hacer 2 cosas, primero instalar FontAwesome (con npm) y lo segundo dar de alta dicho componente. Las instrucciones para instalarlo las tienes en este enlace: https://fontawesome.com/how-to-use/on-the-web/using-with/vuejs. Vamos a seguir la documentación para instalar este paquete.

Para instalar, escribe lo siguiente desde tu terminal:

npm i --save @fortawesome/fontawesome-svg-core @fortawesome/free-solid-svg-icons @fortawesome/vue-fontawesome @fortawesome/free-brands-svg-icons

Estamos instalando varios paquetes a la vez y le estamos indicando que queremos que nos los guarde en nuestro package.json.
Una vez instalados vamos a nuestro archivo principal main.js y le agregamos el siguiente contenido:

import { library } from '@fortawesome/fontawesome-svg-core'
// Iconos de tipo &quot;Solid&quot;
import { faSkull, faCrown, faDungeon, faHatWizard, faHammer, faGem } from '@fortawesome/free-solid-svg-icons'
// Iconos de tipo &quot;Brand&quot; (marcas o logos de empresas)
import { faVuejs, faBootstrap, faFontAwesome, faGithub, faBattleNet } from '@fortawesome/free-brands-svg-icons'
// El componente que vamos a utilizar
import { FontAwesomeIcon } from '@fortawesome/vue-fontawesome'

// Le añadimos los iconos que acabamos de importar (todos, los de tipo solid y de tipo brand)
library.add(
  faSkull,
  faCrown,
  faDungeon,
  faHatWizard,
  faHammer,
  faGem,
  faVuejs,
  faBootstrap,
  faFontAwesome,
  faGithub,
  faBattleNet
)

Vue.component('font-awesome-icon', FontAwesomeIcon)

Nuestro fichero main.js completo quedaría así:

import Vue from 'vue'
import BootstrapVue from 'bootstrap-vue'

// Font Awesome
import { library } from '@fortawesome/fontawesome-svg-core'
import { faSkull, faCrown, faDungeon, faHatWizard, faHammer, faGem } from '@fortawesome/free-solid-svg-icons'
import { faVuejs, faBootstrap, faFontAwesome, faGithub, faBattleNet } from '@fortawesome/free-brands-svg-icons'
import { FontAwesomeIcon } from '@fortawesome/vue-fontawesome'

import App from './App.vue'
import router from './router'
import store from './store'

import 'bootstrap/dist/css/bootstrap.css'
import 'bootstrap-vue/dist/bootstrap-vue.css'

// CSS global
import './assets/css/main.styl'

// Le añadimos los iconos que acabamos de importar (todos, los de tipo solid y de tipo brand)
library.add(
  faSkull,
  faCrown,
  faDungeon,
  faHatWizard,
  faHammer,
  faGem,
  faVuejs,
  faBootstrap,
  faFontAwesome,
  faGithub,
  faBattleNet
)

Vue.use(BootstrapVue)
Vue.config.productionTip = false
Vue.component('font-awesome-icon', FontAwesomeIcon)

new Vue({
  router,
  store,
  methods: {
    // Nuestra función
    init () {
      console.log('Hola 🌝')
      store.dispatch('oauth/getToken')
    }
  },
  // Hook created
  created () {
    this.init()
  },
  render: h =&gt; h(App)
}).$mount('#app')

Ahora sí, Vue ya sabe como interpretar el componente que antes le parecía desconocido. Si abres la web de la aplicación, deberías ver algo como esto:

Por ahora tenemos un token (OAuth) necesario para las llamadas a las APIs de Blizzard, un componente Loading, dos tipos de layouts diferentes (uno que carga el componente Loading y otro donde se inyectan las vistas de nuestras rutas, que a su vez tiene un Header y un Footer bien estructurado en componentes). Además hemos visto como instalar varias librerías, entre ellas FontAwesome, y hemos visto cómo darla de alta en nuestra app Vue.

¡Ya podemos continuar por donde lo habíamos dejado antes! Nos vemos en la siguiente lectura.