Setup main files
To start working on our smart home app we need to replace some code tht comes with the default Vue starter app.
Include zircle-ui within a vue project.
First, go to folder /src and replace the main.js code with the following one:
import Vue from 'vue'
import App from './App.vue'
import zircle from 'zircle'
import 'zircle/dist/zircle.css'
Vue.use(zircle)
Vue.config.productionTip = true
new Vue({
render: h => h(App)
}).$mount('#app')
In the main.js file we have added the highligthed lines:
The first two lines importzircle-ui and its css stylesheet file into vue.js.
The last line tells Vue to use zircle-ui as a plugin
TIP
This initial setup will be the same for all your zircle's projects.
Initial zircle-ui setup.
We need to edit the App.vue file and replace the code with this:
<template>
<z-canvas :views='$options.components'></z-canvas>
</template>
<script>
import home from './views/home'
export default {
components: {
home
},
mounted () {
this.$zircle.setView('home')
}
}
</script>
<style>
@import url('https://fonts.googleapis.com/css?family=Source+Sans+Pro:400,700');
@import url('https://use.fontawesome.com/releases/v5.1.0/css/all.css');
</style>
In the <template>
tag we added the zircle's z-canvas
component. All your zircle-ui stuff will be rendered inside this component. z-canvas
could be considered as a frame in where zircle-ui lives. For this reason whenever you start a zircle-ui project, you need to use it.
z-canvas
has just one property called views where you pass all your views. For the purposes of this tutorial we are going to put our views inside the components options of the Vue instance: $options.components. However there are many other ways to do that.
Let's figure out what happens inside the <script>
tag. Here we imported a no-yet-createdhome.vue
file from the /views folder.
Then we to included our home
view inside components
vue instance.
Finally, we use the [vue hook mounted]https://vuejs.org/v2/api/#mounted) to tell zircle-ui that the initial view is home
CSS style
For this app we are going to import a font from Google fonts and use some icon of Font Awesome.
Create your first zircle-ui view.
It is time to create the home.vue file. This is simply a mockup view, in the next section we are going to improve this view.
In you editor create a home.vue file into /src/views/ folder with the following code:
<template>
<z-view>
Welcome to Smart Home Dashboard
</z-view>
</template>
That's all, now check your browser. The app will now look much like this:
See
Next steps
For our app it is neccesary to creates a bunch of views files that will be place in the /src/views folder. In each view you will learn some features of zircle-ui.