List VueJS Questions & Answers
Click βif you like the project. Pull Requests are highly appreciated.
-
Vue.js is an open-source, progressive Javascript framework for building user interfaces that aim to be incrementally adoptable. The core library of VueJS is focused on the
view layer
only, and is easy to pick up and integrate with other libraries or existing projects. -
Below are the some of major features available with VueJS
- Virtual DOM: It uses virtual DOM similar to other existing frameworks such as ReactJS, Ember etc. Virtual DOM is a light-weight in-memory tree representation of the original HTML DOM and updated without affecting the original DOM.
- Components: Used to create reusable custom elements in VueJS applications.
- Templates: VueJS provides HTML based templates that bind the DOM with the Vue instance data
- Routing: Navigation between pages is achieved through vue-router
- Light weight: VueJS is light weight library compared to other frameworks
-
Lifecycle hooks are a window into how the library youβre using works behind-the-scenes. By using these hooks, you will know when your component is created, added to the DOM, updated, or destroyed. Let's look at lifecycle diagram before going to each lifecycle hook in detail,
- Creation(Initialization):
Creation Hooks allow you to perform actions before your component has even been added to the DOM. You need to use these hooks if you need to set things up in your component both during client rendering and server rendering. Unlike other hooks, creation hooks are also run during server-side rendering.
- beforeCreate: This hook runs at the very initialization of your component. hook observes data and initialization events in your component. Here, data is still not reactive and events that occur during the componentβs lifecycle have not been set up yet.
new Vue({ data: { count: 10 }, beforeCreate: function () { console.log('Nothing gets called at this moment') // `this` points to the view model instance console.log('count is ' + this.count); } }) // count is undefined
- created: This hook is invoked when Vue has set up events and data observation. Here, events are active and access to reactive data is enabled though templates have not yet been mounted or rendered.
Note: Remember that, You will not have access to the DOM or the target mounting element (this.$el) inside of creation hooksnew Vue({ data: { count: 10 }, created: function () { // `this` points to the view model instance console.log('count is: ' + this.count) } }) // count is: 10
- Mounting(DOM Insertion):
Mounting hooks are often the most-used hooks and they allow you to access your component immediately before and after the first render.
- beforeMount: The beforeMount allows you to access your component immediately before and after the first render.
new Vue({ beforeMount: function () { // `this` points to the view model instance console.log(`this.$el is yet to be created`); } })
- mounted: This is a most used hook and you will have full access to the reactive component, templates, and rendered DOM (via. this.$el). The most frequently used patterns are fetching data for your component.
<div id="app"> <p>Iβm text inside the component.</p> </div> new Vue({ el: β#appβ, mounted: function() { console.log(this.$el.textContent); // I'm text inside the component. } })
- Updating (Diff & Re-render):
Updating hooks are called whenever a reactive property used by your component changes, or something else causes it to re-render
- beforeUpdate: The beforeUpdate hook runs after data changes on your component and the update cycle begins, right before the DOM is patched and re-rendered.
<div id="app"> <p>{{counter}}</p> </div> ...// rest of the code new Vue({ el: '#app', data() { return { counter: 0 } }, created: function() { setInterval(() => { this.counter++ }, 1000) }, beforeUpdate: function() { console.log(this.counter) // Logs the counter value every second, before the DOM updates. } })
- updated: This hook runs after data changes on your component and the DOM re-renders.
<div id="app"> <p ref="dom">{{counter}}</p> </div> ...// new Vue({ el: '#app', data() { return { counter: 0 } }, created: function() { setInterval(() => { this.counter++ }, 1000) }, updated: function() { console.log(+this.$refs['dom'].textContent === this.counter) // Logs true every second } })
- Destruction (Teardown):
Destruction hooks allow you to perform actions when your component is destroyed, such as cleanup or analytics sending.
- beforeDestroy:
beforeDestroy
is fired right before teardown. If you need to cleanup events or reactive subscriptions, beforeDestroy would probably be the time to do it. Your component will still be fully present and functional.
new Vue ({ data() { return { message: 'Welcome VueJS developers' } }, beforeDestroy: function() { this.message = null delete this.message } })
- destroyed: This hooks is called after your component has been destroyed, its directives have been unbound and its event listeners have been removed.
new Vue ({ destroyed: function() { console.log(this) // Nothing to show here } })
- beforeDestroy:
- Creation(Initialization):
Creation Hooks allow you to perform actions before your component has even been added to the DOM. You need to use these hooks if you need to set things up in your component both during client rendering and server rendering. Unlike other hooks, creation hooks are also run during server-side rendering.
-
VueJS provides set of directives to show or hide elements based on conditions. The available directives are: v-if, v-else, v-else-if and v-show
1. v-if: The v-if directive adds or removes DOM elements based on the given expression. For example, the below button will not show if isLoggedIn is set to false.
<button v-if="isLoggedIn">Logout</button>
You can also control multiple elements with a single v-if statement by wrapping all the elements in a
<template>
element with the condition. For example, you can have both label and button together conditionally applied,<template v-if="isLoggedIn"> <label> Logout </button> <button> Logout </button> </template>
2. v-else: This directive is used to display content only when the expression adjacent v-if resolves to false. This is similar to else block in any programming language to display alternative content and it is preceded by v-if or v-else-if block. You don't need to pass any value to this. For example, v-else is used to display LogIn button if isLoggedIn is set to false(not logged in).
<button v-if="isLoggedIn"> Logout </button> <button v-else> Log In </button>
3. v-else-if: This directive is used when we need more than two options to be checked. For example, we want to display some text instead of LogIn button when ifLoginDisabled property is set to true. This can be achieved through v-else statement.
<button v-if="isLoggedIn"> Logout </button> <label v-else-if="isLoginDisabled"> User login disabled </label> <button v-else> Log In </button>
4. v-show: This directive is similar to v-if but it renders all elements to the DOM and then uses the CSS display property to show/hide elements. This directive is recommended if the elements are switched on and off frequently.
<span v-show="user.name">Welcome user,{{user.name}}</span>
-
Below are some of the main differences between between v-show and v-if directives,
- v-if only renders the element to the DOM if the expression passes whereas v-show renders all elements to the DOM and then uses the CSS display property to show/hide elements based on expression.
- v-if supports v-else and v-else-if directives whereas v-show doesn't support else directives.
- v-if has higher toggle costs while v-show has higher initial render costs. i.e, v-show has a performance advantage if the elements are switched on and off frequently, while the v-if has the advantage when it comes to initial render time.
- v-if supports
<template>
tab but v-show doesn't support.
-
The built-in v-for directive allows us to loop through items in an array or object. You can iterate on each element in the array or object.
- Array usage:
<ul id="list"> <li v-for="(item, index) in items"> {{ index }} - {{ item.message }} </li> </ul> var vm = new Vue({ el: '#list', data: { items: [ { message: 'John' }, { message: 'Locke' } ] } })
You can also use
of
as the delimiter instead ofin
, similar to javascript iterators.- Object usage:
<div id="object"> <div v-for="(value, key, index) in user"> {{ index }}. {{ key }}: {{ value }} </div> </div> var vm = new Vue({ el: '#object', data: { user: { firstName: 'John', lastName: 'Locke', age: 30 } } })
-
Every Vue application works by creating a new Vue instance with the Vue function. Generally the variable vm (short for ViewModel) is used to refer Vue instance. You can create vue instance as below,
var vm = new Vue({ // options })
As mentioned in the above code snippets, you need to pass options object. You can find the full list of options in the API reference.
-
You can achieve conditional group of elements(toggle multiple elements at a time) by applying v-if directive on
<template>
element which works as invisible wrapper(no rendering) for group of elements. For example, you can conditionally group user details based on valid user condition.<template v-if="condition"> <h1>Name</h1> <p>Address</p> <p>Contact Details</p> </template>
-
Vue always tries to render elements as efficient as possible. So it tries to reuse the elements instead of building them from scratch. But this behavior may cause problems in few scenarios. For example, if you try to render the same input element in both
v-if
andv-else
blocks then it holds the previous value as below,<template v-if="loginType === 'Admin'"> <label>Admin</label> <input placeholder="Enter your ID"> </template> <template v-else> <label>Guest</label> <input placeholder="Enter your name"> </template>
In this case, it shouldn't reuse. We can make both input elements as separate by applying key attribute as below,
<template v-if="loginType === 'Admin'"> <label>Admin</label> <input placeholder="Enter your ID" key="admin-id"> </template> <template v-else> <label>Guest</label> <input placeholder="Enter your name" key="user-name"> </template>
The above code make sure both inputs are independent and doesn't impact each other.
-
It is recommended not to use v-if on the same element as v-for. Because v-for directive has a higher priority than v-if. There are two cases where developers try to use this combination,
- To filter items in a list For example, if you try to filter the list using v-if tag,
<ul> <li v-for="user in users" v-if="user.isActive" :key="user.id" > {{ user.name }} <li> </ul>
This can be avoided by preparing the filtered list using computed property on the initial list
computed: { activeUsers: function () { return this.users.filter(function (user) { return user.isActive }) } } ...... // ...... // <ul> <li v-for="user in activeUsers" :key="user.id"> {{ user.name }} <li> </ul>
- To avoid rendering a list if it should be hidden For example, if you try to conditionally check if the user is to be shown or hidden
<ul> <li v-for="user in users" v-if="shouldShowUsers" :key="user.id" > {{ user.name }} <li> </ul>
This can be solved by moving the condition to a parent by avoiding this check for each user
<ul v-if="shouldShowUsers"> <li v-for="user in users" :key="user.id" > {{ user.name }} <li> </ul>
-
In order to track each nodeβs identity, and thus reuse and reorder existing elements, you need to provide a unique
key
attribute for each item with inv-for
iteration. An ideal value for key would be the unique id of each item. Let us take an example usage,<div v-for="item in items" :key="item.id"> {{item.name}} </div>
Hence, It is always recommended to provide a key with v-for whenever possible, unless the iterated DOM content is simple. Note: You shouldnβt use non-primitive values like objects and arrays as v-for keys. Use string or numeric values instead.
-
As the name suggests, mutation methods modifies the original array. Below are the list of array mutation methods which trigger view updates.
- push()
- pop()
- shift()
- unshift()
- splice()
- sort()
- reverse()
If you perform any of the above mutation method on the list then it triggers view update. For example, push method on array named 'items' trigger a view update,
vm.todos.push({ message: 'Baz' })
-
The methods which do not mutate the original array but always return a new array are called non-mutation methods. Below are the list of non-mutation methods,
- filter()
- concat()
- slice()
For example, lets take a todo list where it replaces the old array with new one based on status filter,
vm.todos = vm.todos.filter(function (todo) { return todo.status.match(/Completed/) })
This approach won't re-render the entire list due to VueJS implementation.
-
Vue cannot detect changes for the array in the below two cases,
- When you directly set an item with the index,For example,
vm.todos[indexOfTodo] = newTodo
- When you modify the length of the array, For example,
vm.todos.length = todosLength
You can overcome both the caveats using
set
andsplice
methods, Let's see the solutions with an examples,First use case solution
// Vue.set Vue.set(vm.todos, indexOfTodo, newTodoValue) (or) // Array.prototype.splice vm.todos.splice(indexOfTodo, 1, newTodoValue)
Second use case solution
vm.todos.splice(todosLength)
- When you directly set an item with the index,For example,
-
Vue cannot detect changes for the object in property addition or deletion., Lets take an example of user data changes,
var vm = new Vue({ data: { user: { name: 'John' } } }) // `vm.name` is now reactive vm.email = john@email.com // `vm.email` is NOT reactive
You can overcome this scenario using the Vue.set(object, key, value) method or Object.assign(),
Vue.set(vm.user, 'email', john@email.com); (or) vm.user = Object.assign({}, vm.user, { email: john@email.com })
-
You can also use integer type(say 'n') for v-for directive which repeats the element many times.
<div> <span v-for="n in 20">{{ n }} </span> </div>
It displays the number 1 to 20.
-
Just similar to v-if directive on template, you can also use a
<template>
tag with v-for directive to render a block of multiple elements. Let's take a todo example,<ul> <template v-for="todo in todos"> <li>{{ todo.title }}</li> <li class="divider"></li> </template> </ul>
-
You can use event handlers in vue similar to plain javascript. The method calls also support the special $event variable.
<button v-on:click="show('Welcome to VueJS world', $event)"> Submit </button> methods: { show: function (message, event) { // now we have access to the native event if (event) event.preventDefault() console.log(message); } }
-
Normally, javascript provides event.preventDefault() or event.stopPropagation() inside event handlers. You can use methods provided by vue, but these methods are meant for data logic instead of dealing with DOM events. Vue provides below event modifiers for v-on and these modifiers are directive postfixes denoted by a dot.
- .stop
- .prevent
- .capture
- .self
- .once
- .passive
Let's take an example of stop modifier,
<!-- the click event's propagation will be stopped --> <a v-on:click.stop="methodCall"></a>
You can also chain modifiers as below,
<!-- modifiers can be chained --> <a v-on:click.stop.prevent="doThat"></a>
-
Vue supports key modifiers on
v-on
for handling keyboard events. Let's take an example of keyup event with enter keycode.<!-- only call `vm.show()` when the `keyCode` is 13 --> <input v-on:keyup.13="show">
Remembering all the key codes is really difficult. It supports the full list of key codes aliases
- .enter
- .tab
- .delete (captures both βDeleteβ and βBackspaceβ keys)
- .esc
- .space
- .up
- .down
- .left
- .right
Now the above keyup code snippet can be written with aliases as follows,
<input v-on:keyup.enter="submit"> // (OR) <!-- with shorthand notation--> <input @keyup.enter="submit">
The use of keyCode events is deprecated and may not be supported in new browsers.
-
You can define custom key modifier aliases via the global
config.keyCodes
. There are few guidelines for the properties- You can't use camelCase. Instead you can use kebab-case with double quotation marks
- You can define multiple values in an array format
Vue.config.keyCodes = { f1: 112, "media-play-pause": 179, down: [40, 87] }
-
Vue supports below modifiers to trigger mouse or keyboard event listeners when the corresponding key is pressed,
- .ctrl
- .alt
- .shift
- .meta
Lets take an example of control modifier with click event,
<!-- Ctrl + Click --> <div @click.ctrl="doSomething">Do something</div>
-
Vue supports below mouse button modifiers
- .left
- .right
- .middle
For example, the usage of
.right
modifier as below<button v-if="button === 'right'" v-on:mousedown.right="increment" v-on:mousedown.left="decrement" />
-
You can use the
v-model
directive to create two-way data bindings on form input, textarea, and select elements. Lets take an example of it using input component,<input v-model="message" placeholder="Enter input here"> <p>The message is: {{ message }}</p>
Remember, v-model will ignore the initial
value
,checked
orselected
attributes found on any form elements. So it always use the Vue instance data as the source of truth. -
There are three modifiers supported for v-model directive.
1. lazy: By default, v-model syncs the input with the data after each input event. You can add the lazy modifier to instead sync after change events.
<!-- synced after "change" instead of "input" --> <input v-model.lazy="msg" >
2. number: If you want user input to be automatically typecast as a number, you can add the number modifier to your v-model. Even with type="number", the value of HTML input elements always returns a string. So, this typecast modifier is required.
<input v-model.number="age" type="number">
3. trim: If you want whitespace from user input to be trimmed automatically, you can add the trim modifier to your v-model.
<input v-model.trim="msg">
-
Components are reusable Vue instances with a name. They accept the same options as new Vue, such as data, computed, watch, methods, and lifecycle hooks(except few root-specific options like el). Lets take an example of counter component,
// Define a new component called button-counter Vue.component('button-counter', { template: '<button v-on:click="count++">You clicked me {{ count }} times.</button>' data: function () { return { count: 0 } }, })
Let's use this component inside a root Vue instance created with new Vue
<div id="app"> <button-counter></button-counter> </div> var vm = new Vue({ el: '#app' });
-
Props are custom attributes you can register on a component. When a value is passed to a prop attribute, it becomes a property on that component instance. You can pass those list of values as props option and use them as similar to data variables in template.
Vue.component('todo-item', { props: ['title'], template: '<h2>{{ title }}</h2>' })
Once the props are registered, you can pass them as custom atrtributes.
<todo-item title="Learn Vue conceptsnfirst"></todo-item>
-
Every component must have a single root element when template has more than one element. In this case, you need to wrap the elements with a parent element.
<div class="todo-item"> <h2>{{ title }}</h2> <div v-html="content"></div> </div>
Otherwise there will an error throwing, saying that "Component template should contain exactly one root element...".
-
If you want child wants to communicate back up to the parent, then emit an event from child using
$event
object to parent,Vue.component('todo-tem', { props: ['todo'], template: ` <div class="todo-item"> <h3>{{ todo.title }}</h3> <button v-on:click="$emit('increment-count', 1)"> Add </button> <div v-html="todo.description"></div> </div> ` })
Now you can use this todo-item in parent component to access the count value.
<ul v-for="todo in todos"> <li> <todo-item v-bind:key="todo.id" v-bind:todo="todo" v-on:increment-count="total += 1"></todo-item> </li> </ul> <span> Total todos count is {{total}}</span>
-
The custom events can also be used to create custom inputs that work with v-model. The inside the component must follow below rules,
- Bind the value attribute to a value prop
- On input, emit its own custom input event with the new value. Let's take a custom-input component as an example,
Vue.component('custom-input', { props: ['value'], template: ` <input v-bind:value="value" v-on:input="$emit('input', $event.target.value)" > ` })
Now you can use
v-model
with this component,<custom-input v-model="searchInput"></custom-input>
-
Vue implements a content distribution API using the element to serve as distribution outlets for content created after after the current Web Components spec draft. Let's create an alert component with slots for content insertion,
Vue.component('alert', { template: ` <div class="alert-box"> <strong>Error!</strong> <slot></slot> </div> ` })
Now you can insert dynamic content as below,
<alert> There is an issue with in application. </alert>
-
The components which are globally registered can be used in the template of any root Vue instance (new Vue) created after registration. In the global registration, the components created using Vue.component as below,
Vue.component('my-component-name', { // ... options ... })
Let's take multiple components which are globally registered in the vue instance,
Vue.component('component-a', { /* ... */ }) Vue.component('component-b', { /* ... */ }) Vue.component('component-c', { /* ... */ }) new Vue({ el: '#app' })
The above components can be used in the vue instance,
<div id="app"> <component-a></component-a> <component-b></component-b> <component-c></component-c> </div>
Remember that the components can be used in subcomponents as well.
-
Due to global registration, even if you don't use the component it could still be included in your final build. So it will create unnecessary javascript in the application. This can be avoided using local registration with the below steps,
- First you need to define your components as plain JavaScript objects
var ComponentA = { /* ... */ } var ComponentB = { /* ... */ } var ComponentC = { /* ... */ }
Locally registered components will not be available in sub components. In this case, you need to add them in components section
var ComponentA = { /* ... */ } var ComponentB = { components: { 'component-a': ComponentA }, // ... }
- You can use the components in the components section of the vue instance,
new Vue({ el: '#app', components: { 'component-a': ComponentA, 'component-b': ComponentB } })
-
In local registration, you need to create each component in components folder(optional but it is recommended) and import them in another component file components section. Let's say you want to register component A and B in component C, the configuration seems as below,
import ComponentA from './ComponentA' import ComponentB from './ComponentC' export default { components: { ComponentA, ComponentB }, // ... }
Now both ComponentA and ComponentB can be used inside ComponentCβs template.
In global registration, you need to export all common or base components in a separate file. But some of the popular bundlers like
webpack
make this process simpler by usingrequire.context
to globally register base components in the below entry file(one-time).import Vue from 'vue' import upperFirst from 'lodash/upperFirst' import camelCase from 'lodash/camelCase' const requireComponent = require.context( // The relative path of the components folder './components', // Whether or not to look in subfolders false, // The regular expression used to match base component filenames /Base[A-Z]\w+\.(vue|js)$/ ) requireComponent.keys().forEach(fileName => { // Get component config const componentConfig = requireComponent(fileName) // Get PascalCase name of component const componentName = upperFirst( camelCase( // Strip the leading `./` and extension from the filename fileName.replace(/^\.\/(.*)\.\w+$/, '$1') ) ) // Register component globally Vue.component( componentName, // Look for the component options on `.default`, which will // exist if the component was exported with `export default`, // otherwise fall back to module's root. componentConfig.default || componentConfig ) })
-
You can declare props with type or without type. But it is recommended to have prop types because it provides the documentation for the component and warns the developer for any incorrect data type being assigned.
props: { name: String, age: Number, isAuthenticated: Boolean, phoneNumbers: Array, address: Object }
As mentioned in the above code snippet, you can list props as an object, where the propertiesβ names and values contain the prop names and types, respectively.
-
All props follows a one-way-down binding between the child property and the parent one. i.e, When the parent property is updated then that latest prop value will be passed down to the child, but not the otherway(child to parent) around. The child component should not mutate the prop otherwise it throws a warning in the console. The possible mutation cases can be solved as below,
- When you try to use parent prop as initial value for child property:
In this case you can define a local property in child component and assign parent value as initial value
props: ['defaultUser'], data: function () { return { username: this.defaultUser } }
- When you try to transform the parent prop:
You can define a computed property using the propβs value,
props: ['environment'], computed: { localEnvironment: function () { return this.environment.trim().toUpperCase() } }
-
A non-prop attribute is an attribute that is passed to a component, but does not have a corresponding prop defined. For example, If you are using a 3rd-party custom-input component that requires a
data-tooltip
attribute on the input then you can add this attribute to component instance,<custom-input data-tooltip="Enter your input" />
If you try to pass the props from parent component the child props with the same names will be overridden. But props like
class
andstyle
are exception to this, these values will be merged in the child component.//Child component <input type="date" class="date-control"> //Parent component <custom-input class="custom-class" />
-
Vue provides validations such as types, required fields, default values along with customized validations. You can provide an object with validation requirements to the value of props as below, Let's take an example of user profile Vue component with possible validations,
Vue.component('user-profile', { props: { // Basic type check (`null` matches any type) age: Number, // Multiple possible types identityNumber: [String, Number], // Required string email: { type: String, required: true }, // Number with a default value minBalance: { type: Number, default: 10000 }, // Object with a default value message: { type: Object, // Object or array defaults must be returned from // a factory function default: function () { return { message: 'Welcome to Vue' } } }, // Custom validator function location: { validator: function (value) { // The value must match one of these strings return ['India', 'Singapore', 'Australia'].indexOf(value) !== -1 } } } })
-
The v-model directive on a component uses value as the prop and input as the event, but some input types such as
checkboxes
andradio buttons
may need to use the value attribute for a server side value. In this case, it is preferred to customize model directive. Let's take an example of checkbox component,Vue.component('custom-checkbox', { model: { prop: 'checked', event: 'change' }, props: { checked: Boolean }, template: ` <input type="checkbox" v-bind:checked="checked" v-on:change="$emit('change', $event.target.checked)" > ` })
Now you can use v-model on this customized component as below,
<custom-checkbox v-model="selectFramework"></custom-checkbox>
The selectFramework property will be passed to the checked prop and same property will be updated when custom checkbox component emits a change event with a new value.
-
There are many ways Vue provides transition effects when items are inserted, updated, or removed from the DOM. Below are the possible ways,
- Automatically apply classes for CSS transitions and animations
- Integrate 3rd-party CSS animation libraries. For example, Animate.css
- Use JavaScript to directly manipulate the DOM during transition hooks
- Integrate 3rd-party JavaScript animation libraries. For example, Velocity.js
-
Vue Router is a official routing library for single-page applications designed for use with the Vue.js framework. Below are their features,
- Nested route/view mapping
- Modular, component-based router configuration
- Route params, query, wildcards
- View transition effects powered by Vue.js' transition system
- Fine-grained navigation control
- Links with automatic active CSS classes
- HTML5 history mode or hash mode, with auto-fallback in IE9
- Restore scroll position when going back in history mode
-
It is easy to integrate vue router in the vue application. Let us see the example with step by step instructions.
Step 1: Configure router link and router view in the template
<script src="https://unpkg.com/vue/dist/vue.js"></script> <script src="https://unpkg.com/vue-router/dist/vue-router.js"></script> <div id="app"> <h1>Welcome to Vue routing app!</h1> <p> <!-- use router-link component for navigation using `to` prop. It rendered as an `<a>` tag --> <router-link to="/home">Home</router-link> <router-link to="/services">Services</router-link> </p> <!-- route outlet in which component matched by the route will render here --> <router-view></router-view> </div>
Step 2: Import Vue and VueRouter packages and then apply router
import Vue from 'vue'; import VueRouter from 'vue-router'; Vue.use(VueRouter)
Step 3: Define or import route components.
const Home = { template: '<div>Home</div>' } const Services = { template: '<div>Services</div>' }
Step 4: Define your route where each one maps to a component
const routes = [ { path: '/home', component: Home }, { path: '/services', component: Services } ]
Step 5: Create the router instance and pass the
routes
optionconst router = new VueRouter({ routes // short for `routes: routes` })
Step 6: Create and mount the root instance.
const app = new Vue({ router }).$mount('#app')
Now you are able to navigate different pages(Home, Services) with in Vue application.
-
Sometimes it may be required to map routes to the same component based on a pattern. Let's take a user component with the mapped URLs like
/user/john/post/123
and/user/jack/post/235
using dynamic segments,const User = { template: '<div>User {{ $route.params.name }}, PostId: {{ route.params.postid }}</div>' } const router = new VueRouter({ routes: [ // dynamic segments start with a colon { path: '/user/:name/post/:postid', component: User } ] })
-
When you navigate from one URL to other(mapped with a single component) using routes with params then the same component instance will be reused. Even though it is more efficient than destroying the old instance and then creating a new one, the lifecycle hooks of the component will not be called. This problem can be solved using either of the below approaches,
- Watch the $route object:
const User = { template: '<div>User {{ $route.params.name }} </div>', watch: { '$route' (to, from) { // react to route changes... } } }
- Use beforeRouteUpdate navigation guard: This is only available since 2.2 version.
const User = { template: '<div>User {{ $route.params.name }} </div>', beforeRouteUpdate (to, from, next) { // react to route changes and then call next() } }
Note that the beforeRouteEnter guard does NOT have access to
this
. Instead you can pass a callback tonext
to access the vm instance. -
Sometimes the URL might be matched by multiple routes and the confusion of which route need to be mapped is resolved by route matching priority. The priority is based on order of routes configuration. i.e, The route which declared first has higher priority.
const router = new VueRouter({ routes: [ // dynamic segments start with a colon { path: '/user/:name', component: User } // This route gets higher priority { path: '/user/:name', component: Admin } { path: '/user/:name', component: Customer } ] })
-
Generally, the app is composed of nested components which are nested multiple levels deep. The segments of a URL corresponds to a certain structure of these nested components. To render components into the nested outlet, you need to use the
children
option inVueRouter
constructor config. Let's take a user app composed of profile and posts nested components with respective routes. You can also define a default route configuration when there is no matching nested route.const router = new VueRouter({ routes: [ { path: '/user/:id', component: User, children: [ { // UserProfile will be rendered inside User's <router-view> when /user/:id/profile is matched path: 'profile', component: UserProfile }, { // UserPosts will be rendered inside User's <router-view> when /user/:id/posts is matched path: 'posts', component: UserPosts }, // UserHome will be rendered inside User's <router-view> when /user/:id is matched { path: '', component: UserHome }, ] } ] })
-
Single File Components are an easy concept to understand. Earlier you might heard about all three parts(HTML, JavaScript and CSS) of your application kept in different components. But Single File Components encapsulate the structure, styling and behaviour into one file. In the beginning, it seems strange to have all three parts in one file, but it actually makes a lot more sense. Let's take an example of Singile File Components
<template> <div> <h1>Welcome {{ name }}!</h1> </div> </template> <script> module.exports = { data: function() { return { name: 'John' } } } </script> <style scoped> h1 { color: #34c779; padding: 3px; } </style>
-
As for the latest modern UI development, separation of concerns is not equal to separation of file types. So it is preferred to divide codebase layers into loosely-coupled components and compose them instead of dividing the codebase into three huge layers that interweave with one another. This way makes Single File Components more cohesive and maintainable by combining template, logic and styles together inside a component. You can also still maintain javascript and CSS files separately with hot-reloading and pre-compilation features. For example,
<template> <div>This section will be pre-compiled and hot reloaded</div> </template> <script src="./my-component.js"></script> <style src="./my-component.css"></style>
-
The Single File Components solve the common problems occurred in a javascript driven application with a .vue extension. The list of issues are,
- Global definitions force unique names for every component
- String templates lack syntax highlighting and require ugly slashes for multiline HTML
- No CSS support means that while HTML and JavaScript are modularized into components, CSS is conspicuously left out
- No build step restricts us to HTML and ES5 JavaScript, rather than preprocessors like Pug (formerly Jade) and Babel
-
Filters can be used to apply common text formatting. These Filters should be appended to the end of the JavaScript expression, denoted by the βpipeβ symbol. You can use them in two specific cases:
- mustache interpolations
- v-bind expressions
For example, Let's define a local filter named capitalize in a componentβs options
filters: { capitalize: function (value) { if (!value) return '' value = value.toString() return value.charAt(0).toUpperCase() + value.slice(1) } }
Now you can use the filter in either mustache interpolation or v-bind expression,
<!-- in mustaches --> {{ username | capitalize }} <!-- in v-bind --> <div v-bind:id="username | capitalize"></div>
-
You can define filters in two ways,
- Local filters: You can define local filters in a componentβs options. In this case, filter is applicable to that specific component.
filters: { capitalize: function (value) { if (!value) return '' value = value.toString() return value.charAt(0).toUpperCase() + value.slice(1) } }
- Global filters: You can also define a filter globally before creating the Vue instance. In this case, filter is applicable to all the components with in the vue instance,
Vue.filter('capitalize', function (value) { if (!value) return '' value = value.toString() return value.charAt(0).toUpperCase() + value.slice(1) }) new Vue({ // ... })
-
You can chain filters one after the other to perform multiple manipulations on the expression. The generic structure of filter chain would be as below,
{{ message | filterA | filterB | filterB ... }}
In the above chain stack, you can observe that message expression applied with three filters, each separated by a pipe(|) symbol. The first filter(filterA) takes the expression as a single argument and the result of the expression becomes an argument for second filter(filterB) and the chain continue for remaining filters. For example, if you want to transform date expression with a full date format and uppercase then you can apply dateFormat and uppercase filters as below,
{{ birthday | dateFormat | uppercase }}
-
Yes, you can pass arguments for a filter similar to a javascript function. The generic structure of filter parameters would be as follows,
{{ message | filterA('arg1', arg2) }}
In this case, filterA takes message expression as first argument and the explicit parameters mentioned in the filter as second and third arguments. For example, you can find the exponential strength of a particular value
{{ 2 | exponentialStrength(10) }} // prints 2 power 10 = 1024
-
Plugins provides global-level functionality to Vue application. The plugins provide various services,
- Add some global methods or properties. For example, vue-custom-element
- Add one or more global assets (directives, filters and transitions). For example, vue-touch
- Add some component options by global mixin. For example, vue-router
- Add some Vue instance methods by attaching them to Vue.prototype.
- A library that provides an API of its own, while at the same time injecting some combination of the above. For example, vue-router
-
The Plugin is created by exposing an
install
method which takes Vue constructor as a first argument along with options. The structure of VueJS plugin with possible functionality would be as follows,MyPlugin.install = function (Vue, options) { // 1. add global method or property Vue.myGlobalMethod = function () { // some logic ... } // 2. add a global asset Vue.directive('my-directive', { bind (el, binding, vnode, oldVnode) { // some logic ... } ... }) // 3. inject some component options Vue.mixin({ created: function () { // some logic ... } ... }) // 4. add an instance method Vue.prototype.$myMethod = function (methodOptions) { // some logic ... } }
-
You can use plugin by passing your plugin to Vue's use global method. You need to apply this method before start your app by calling new Vue().
// calls `MyPlugin.install(Vue, { someOption: true })` Vue.use(MyPlugin) new Vue({ //... options })
-
Mixin gives us a way to distribute reusable functionalities in Vue components. These reusable functions are merged with existing functions. A mixin object can contain any component options. Let us take an example of mixin with
created
lifecycle which can be shared across components,const myMixin = { created(){ console.log("Welcome to Mixins!") } } var app = new Vue({ el: '#root', mixins: [myMixin] })
Note: Multiple mixins can be specified in the mixin array of the component.
-
Sometimes there is a need to extend the functionality of Vue or apply an option to all Vue components available in our application. In this case, mixins can be applied globally to affect all components in Vue. These mixins are called as global mixins. Let's take an example of global mixin,
Vue.mixin({ created(){ console.log("Write global mixins") } }) new Vue({ el: '#app' })
In the above global mixin, the mixin options spread across all components with the console running during the instance creation. These are useful during test, and debugging or third party libraries. At the same time, You need to use these global mixins sparsely and carefully, because it affects every single Vue instance created, including third party components.
-
Using Vue CLI, mixins can be specified anywhere in the project folder but preferably within
/src/mixins
for ease of access. Once these mixins are created in a.js
file and exposed with theexport
keyword, they can be imported in any component with theimport
keyword and their file paths. -
When a mixin and the component itself contain overlapping options, the options will be merged based on some strategies.
- The data objects undergo a recursive merge, with the componentβs data taking priority over mixins in cases of overlapping or conflicts.
var mixin = { data: function () { return { message: 'Hello, this is a Mixin' } } } new Vue({ mixins: [mixin], data: function () { return { message: 'Hello, this is a Component' } }, created: function () { console.log(this.$data); // => { message: "Hello, this is a Component'" } } })
- The Hook functions which are overlapping merged into an array so that all of them will be called. Mixin hooks will be called before the componentβs own hooks.
const myMixin = { created(){ console.log("Called from Mixin") } } new Vue({ el: '#root', mixins:[myMixin], created(){ console.log("Called from Component") } }) //Called from Mixin //Called from Component
- The options that expect object values(such as methods, components and directives) will be merged into the same object. In this case, the componentβs options will take priority when there are conflicting keys in these objects.
var mixin = { methods: { firstName: function () { console.log('John') }, contact: function () { console.log('+65 99898987') } } } var vm = new Vue({ mixins: [mixin], methods: { lastName: function () { console.log('Murray') }, contact: function () { console.log('+91 893839389') } } }) vm.firstName() // "John" vm.lastName() // "Murray" vm.contact() // "+91 893839389"
-
Vue uses the default strategy which overwrites the existing value while custom options are merged. But if you want a custom option merged using custom login then you need to attach a function to
Vue.config.optionMergeStrategies
For the example, the structure ofmyOptions
custom option would be as below,Vue.config.optionMergeStrategies.myOption = function (toVal, fromVal) { // return mergedVal }
Let's take below Vuex 1.0 merging strategy as an advanced example,
const merge = Vue.config.optionMergeStrategies.computed Vue.config.optionMergeStrategies.vuex = function (toVal, fromVal) { if (!toVal) return fromVal if (!fromVal) return toVal return { getters: merge(toVal.getters, fromVal.getters), state: merge(toVal.state, fromVal.state), actions: merge(toVal.actions, fromVal.actions) } }
-
Custom Directives are tiny commands that you can attach to DOM elements. They are prefixed with v- to let the library know you're using a special bit of markup and to keep syntax consistent. They are typically useful if you need low-level access to an HTML element to control a bit of behavior. Let's create a custom focus directive to provide focus on specific form element during page load time,
// Register a global custom directive called `v-focus` Vue.directive('focus', { // When the bound element is inserted into the DOM... inserted: function (el) { // Focus the element el.focus() } })
Now you can use v-focus directive on any element as below,
<input v-focus>
-
You can also register directives locally(apart from globally) using directives option in component as below,
directives: { focus: { // directive definition inserted: function (el) { el.focus() } } }
Now you can use v-focus directive on any element as below,
<input v-focus>
-
A directive object can provide several hook functions,
- bind: This occurs once the directive is attached to the element.
- inserted: This hook occurs once the element is inserted into the parent DOM.
- update: This hook is called when the element updates, but children haven't been updated yet.
- componentUpdated: This hook is called once the component and the children have been updated.
- unbind: This hook is called only once when the directive is removed.
Note: There are several arguments that can be passed to the above hooks.
-
All the hooks have
el
,binding
, andvnode
as arguments. Along with that, update and componentUpdated hooks exposeoldVnode
, to differentiate between the older value passed and the newer value. Below are the arguments passed to the hooks,el
: The element the directive is bound to and it can be used to directly manipulate the DOM.binding
: An object containing the following properties.name
: The name of the directive, without thev-
prefix.value
: The value passed to the directive. For example inv-my-directive="1 + 1"
, the value would be 2.oldValue
: The previous value, only available in update and componentUpdated. It is available whether or not the value has changed.expression
: The expression of the binding as a string. For example inv-my-directive="1 + 1"
, the expression would be "1 + 1".arg
: The argument passed to the directive, if any. For example in v-my-directive:foo, the arg would be "foo".modifiers
: An object containing modifiers, if any. For example in v-my-directive.foo.bar, the modifiers object would be{ foo: true, bar: true }
.
vnode
: The virtual node produced by Vueβs compiler.oldVnode
: The previous virtual node, only available in the update and componentUpdated hooks.
The arguments can be represented diagrammatically across the hooks as below,
-
A directive can take any valid javascript expression. So if you want to pass multiple values then you can pass in a JavaScript object literal. Let's pass object literal to an avatar directive as below
<div v-avatar="{ width: 500, height: 400, url: 'path/logo', text: 'Iron Man' }"></div>
Now let us configure avatar directive globally,
Vue.directive('avatar', function (el, binding) { console.log(binding.value.width) // 500 console.log(binding.value.height) // 400 console.log(binding.value.url) // path/logo console.log(binding.value.text) // "Iron Man" })
-
In few cases, you may want the same behavior on
bind
andupdate
hooks irrespective of other hooks. In this situation you can use function shorthand,Vue.directive('theme-switcher', function (el, binding) { el.style.backgroundColor = binding.value })
-
In VueJS, the templates are very powerful and recommended to build HTML as part of your application. However, some of the special cases like dynamic component creation based on input or slot value can be achieved through render functions. Also, these functions gives the full programmatic power of javascript eco system.
-
Render function is a normal function which receives a
createElement
method as itβs first argument used to create virtual nodes. Internally Vue.js' templates actually compile down to render functions at build time. Hence templates are just syntactic sugar of render functions. Let's take an example of simple Div markup and corresponding render function, The HTML markup can be written in template tag as below,<template> <div :class="{'is-rounded': isRounded}"> <p>Welcome to Vue render functions</p> </div> </template>
and the compiled down or explicit render function would appear as below,
render: function (createElement) { return createElement('div', { 'class': { 'is-rounded': this.isRounded } }, [ createElement('p', 'Welcome to Vue render functions') ]); },
Note: The react components are built with render functions in JSX.
-
The createElement accepts few arguments to use all the template features. Let us see the basic structure of createElement with possible arguments,
// @returns {VNode} createElement( // An HTML tag name, component options, or async function resolving to one of these. // Type is {String | Object | Function} // Required. 'div', // A data object corresponding to the attributes you would use in a template. //Type is {Object} // Optional. { // Normal HTML attributes attrs: { id: 'someId' }, // Component props props: { myProp: 'somePropValue' }, // DOM properties domProps: { innerHTML: 'This is some text' }, // Event handlers are nested under `on` on: { click: this.clickHandler }, // Similar to `v-bind:style`, accepting either a string, object, or array of objects. style: { color: 'red', fontSize: '14px' }, //Similar to `v-bind:class`, accepting either a string, object, or array of strings and objects. class: { classsName1: true, classsName2: false }, .... }, // Children VNodes, built using `createElement()`, or using strings to get 'text VNodes'. // Type is {String | Array} // Optional. [ 'Learn about createElement arguments.', createElement('h1', 'Headline as a child virtual node'), createElement(MyComponent, { props: { someProp: 'This is a prop value' } }) ] )
see details of the date object in official doc.
-
All virtual nodes(VNodes) in the component tree must be unique.i.e, You can't write duplicated nodes in a straightforward way. If you want to duplicate the same element/component many times then you should use factory function. The below render function is invalid where you are trying to duplicate h1 element 3 times,
render: function (createElement) { var myHeadingVNode = createElement('h1', 'This is a Virtual Node') return createElement('div', [ myHeadingVNode, myHeadingVNode, myHeadingVNode ]) }
You can make duplicates with factory function,
render: function (createElement) { return createElement('div', Array.apply(null, { length: 3 }).map(function () { return createElement('h1', 'This is a Virtual Node') }) ) }
-
VueJS provides proprietary alternatives and plain javascript usage for the template features. Let's list down them in a table for comparision,
Templates Render function Conditional and looping directives: v-if and v-for Use JavaScriptβs if/else and map concepts Two-way binding: v-model Apply own JS logic with value binding and event binding Capture Event modifiers: .passive, .capture, .once and .capture.once or .once.capture &, !, ~ and ~! Event and key modifiers: .stop, .prevent, .self, keys(.enter, .13) and Modifiers Keys(.ctrl, .alt, .shift, .meta) Use javascript solutions: event.stopPropagation(), event.preventDefault(), if (event.target !== event.currentTarget) return, if (event.keyCode !== 13) return and if (!event.ctrlKey) return Slots: slot attributes Render functions provide this.$slots and this.$scopedSlots instance properties -
The functional components are just simple functions to create simple components just by passing a context. Every functional component follows two rules,
- Stateless: It doesnβt keep any state by itself
- Instanceless: It has no instance, thus no this
You need to define
functional: true
to make it functional. Let's take an example of functional components,Vue.component('my-component', { functional: true, // Props are optional props: { // ... }, // To compensate for the lack of an instance, // we are now provided a 2nd context argument. render: function (createElement, context) { // ... } })
Note: The functional components are quite popular in React community too.
-
Even though ReactJS and VueJS are two different frameworks there are few similarities(apart from the common goal of utilized in interface design) between them.
- Both frameworks are based on the Virtual DOM model
- They provide features such Component-based structure and reactivity
- They are intended for working with the root library, while all the additional tasks are transferred to other libraries(routing, state management etc).
-
Even though VueJS and ReactJS share few common features there are many difference between them. Let's list down them in a table format.
Feature VueJS ReactJS Type JavaScript MVC Framework JavaScript Library Platform Primarily focused on web development Both Web and Native Learning Curve A steep learning curve and requires deep knowledge A steep learning curve and requires deep knowledge Simplicity Vue is simpler than React React is more complex than Vue Bootstrap Application Vue-cli CRA (Create React App) -
Vue has the following advantages over React
- Vue is smaller and faster
- The convenient templates ease the process of developing
- It has simpler javascript syntax without learning JSX
-
React has the following advantages over Vue
- ReactJS gives more flexibility in large apps developing
- Easy to test
- Well-suited for mobile apps creation
- The eco system is quite big and well matured.
-
The the syntax of Vue and Angular is common at some points because Angular is the basis for VueJS development in the beginning. But there are many differences between VueJS and Angular as listed,
Feature VueJS AngularJS Complexity Easy to learn, simple API and design The framework is bit huge and need some learning curve on typescript etc Binding of Data One-way binding Two-way binding Learning Curve A steep learning curve and requires deep knowledge A steep learning curve and requires deep knowledge Founders Created by Former Google Employee Powered by Google Initial Release February 2014 September 2016 Model Based on Virtual DOM(Document Object Model) Based on MVC(Model-View-Controller) Written in JavaScript TypeScript -
The dynamic component is used to dynamically switch beetween multiple components using element and pass data to v-bind:is attribute. Let's create a dynamic component to switch between different pages of a website,
new Vue({ el: '#app', data: { currentPage: 'home' }, components: { home: { template: "<p>Home</p>" }, about: { template: "<p>About</p>" }, contact: { template: "<p>Contact</p>" } } })
Now you can use the dynamic component which holds the current page,
<div id="app"> <component v-bind:is="currentPage"> <!-- component changes when currentPage changes! --> <!-- output: Home --> </component> </div>
-
Keep-alive tag is an abstract component used to preserve component state or avoid re-rendering. When you wrapped tag around a dynamic component, it caches the inactive component instances without destroying them. Let's see the example usage of it,
<!-- Inactive components will be cached! --> <keep-alive> <component v-bind:is="currentTabComponent"></component> </keep-alive>
When there are multiple conditional children, it requires that only one child is rendered at a time.
<!-- multiple conditional children --> <keep-alive> <comp-a v-if="a > 1"></comp-a> <comp-b v-else></comp-b> </keep-alive>
Note: Remember that keep-alive tag doesnβt render a DOM element itself, and doesnβt show up in the component parent chain.
-
In large applications, we may need to divide the app into smaller chunks and only load a component from the server when itβs needed. To make this happen, Vue allows you to define your component as a factory function that asynchronously resolves your component definition. These components are known as async component. Let's see an example of async component using webpack code-splitting feature,
Vue.component('async-webpack-example', function (resolve, reject) { // Webpack automatically split your built code into bundles which are loaded over Ajax requests. require(['./my-async-component'], resolve) })
Vue will only trigger the factory function when the component needs to be rendered and will cache the result for future re-renders
-
Async component factory is useful to resolve the component asynchronously. The async component factory can return an object of the below format.
const AsyncComponent = () => ({ // The component to load (should be a Promise) component: import('./MyComponent.vue'), // A component to use while the async component is loading loading: LoadingComponent, // A component to use if the load fails error: ErrorComponent, // Delay before showing the loading component. Default: 200ms. delay: 200, // The error component will be displayed if a timeout is // provided and exceeded. Default: Infinity. timeout: 3000 })
-
If you keep an
inline-template
on a child component then it will use its inner content as a template instead of treating as reusable independent content.<my-component inline-template> <div> <h1>Inline templates</p> <p>Treated as component component owne content</p> </div> </my-component>
Note: Even though this inline-templates gives more flexibility for template authoring, it is recommended to define template using template property or tag inside .vue component.
-
Apart from regular templates and inline templates, you can also define templates using a script element with the type
text/x-template
and then referencing the template by an id. Let's create a x-template for simple use case as below,<script type="text/x-template" id="script-template"> <p>Welcome to X-Template feature</p> </script>
Now you can define the template using reference id,
Vue.component('x-template-example', { template: '#script-template' })
-
The Components that can recursively invoke themselves in their own template are known as recursive components.
Vue.component('recursive-component', { template: `<!--Invoking myself!--> <recursive-component></recursive-component>` });
Recursive components are useful for displaying comments on a blog, nested menus, or basically anything where the parent and child are the same, eventhough with different content.
Note: Remember that recursive component can lead infinite loops with
max stack size exceeded
error, so make sure recursive invocation is conditional(for example, v-if directive). -
In complex applications, vue components will actually be each otherβs descendent and ancestor in the render tree. Let's say componentA and componentB included in their respective templates which makes circular dependency,
//ComponentA <div> <component-b > </div>
//ComponentB <div> <component-b > </div>
This can be solved by either registering(or wait until) the child component in
beforeCreate
hook or using webpack's asynchronous import while registering the component,Solution1:
beforeCreate: function () { this.$options.components.componentB = require('./component-b.vue').default }
Solution2:
components: { componentB: () => import('./component-b.vue') }
-
Some environments(Google Chrome Apps) prohibits the usage of
new Function()
for evaluating expressions and the full builds of vue applications depends on this feature to compile templates. Due to this reason, the full builds of VueJS application are not CSP complaint. In this case you can use runtime-only builds with Webpack + vue-loader or Browserify + vueify technology stack through which templates will be precompiled into render functions. This way you can make sure VueJS applications are 100% CSP complaint. -
There are two types of builds provided by VueJS,
1. Full: These are the builds that contain both the compiler and the runtime.
2. Runtime Only: These builds doesn't include compiler but the code is responsible for creating Vue instances, rendering and patching virtual DOM. These are about 6KB lighter min+gzip.
-
Below are the list of different builds of VueJS based on type of build,
Type UMD CommonJS ES Module (for bundlers) ES Module (for browsers) Full vue.js vue.common.js vue.esm.js vue.esm.browser.js Runtime only vue.runtime.js vue.runtime.common.js vue.runtime.esm.js NA Full (production) vue.min.js NA NA vue.esm.browser.min.js Runtime-only (production) vue.runtime.min.js NA NA NA -
You can configure vueJS in webpack using alias as below,
module.exports = { // ... resolve: { alias: { 'vue$': 'vue/dist/vue.esm.js' // 'vue/dist/vue.common.js' for webpack 1 } } }
-
The compiler is is responsible for compiling template strings into JavaScript render functions. For example, the below code snippet shows the difference of templates which need compiler and not,
// this requires the compiler new Vue({ template: '<div>{{ message }}</div>' }) // this does not new Vue({ render (h) { return h('div', this.message) } })
-
DevTools is a browser extension allowing you to inspect and debug your Vue applications in a more user-friendly interface. You can find the below extensions for different browsers or environments,
- Chrome Extension
- Firefox Addon
- Standalone Electron app (works with any environment)
The DevTools plugins can be used as shown in the below snapshot,
Note:
- If the page uses a production/minified build of Vue.js, devtools inspection is disabled by default so the Vue pane won't show up.
- To make it work for pages opened via
file://
protocol, you need to check "Allow access to file URLs" for this extension in Chrome's extension management panel.
-
It supports all ECMAScript5 complaint browsers as mentioned in this url. VueJS doesn't support IE8 browser and below, because it uses ECMAScript 5 features that are un-shimmable(require support from the underlying JS engine) in IE8.
-
VueJS is available in jsdelivr, unpkg and cdnjs etc CDNs. Normally you can use them for prototyping or learning purposes. For example, you can use them using jsdelivr with latest versions as below,
<script src="https://cdn.jsdelivr.net/npm/vue@2.6.7/dist/vue.js"></script>
You can use it for native ES modules as below,
<script type="module"> import Vue from 'https://cdn.jsdelivr.net/npm/vue@2.6.7/dist/vue.esm.browser.js' </script>
Note: You can remove version number to get latest version.
-
It is extremely rare situation of having to manually force an update despite the fact that no reactive data has changed. i.e, To force the Vue instance to re-render manually. You can do it force update using vm.$forceUpdate() API method.
Note: It does not affect all child components but only the instance itself and child components with inserted slot content.
-
If you want to render
a lot of static content
then you need to make sure it only evaluated once and then cached thereafter. In this case, you can usev-once
directive by wrapping at the root level. The example usage of v-once directive would be as below,Vue.component('legal-terms', { template: ` <div v-once> <h1>Legal Terms</h1> ... a lot of static content goes here... </div> ` })
Note: It is recommended not to overuse unless there is slow rendering due to lot of static content.
-
The root instance(new Vue()) can be accessed with the
$root
property. Let's see the usage of root instance with an example. First let's create a root instance with properties and methods as below,// The root Vue instance new Vue({ data: { age: 26 }, computed: { fullName: function () { /* ... */ } }, methods: { interest: function () { /* ... */ } } })
Now you can access root instance data and it's methods with in subcomponents as below,
// Get root data this.$root.age // Set root data this.$root.age = 29 // Access root computed properties this.$root.fullName // Call root methods this.$root.interest()
It is recommend using Vuex to manage state instead of using root instance as a global store.
-
Below are the top 10 organizations using VueJS for their applications or products,
- Facebook - Used on marketing side of its Newsfeed
- Netflix - Used in two internal apps for building movie streaming interfaces
- Adobe - Used for Portfolio, a custom website builder designed to help users showcase their creative work
- Xiaomi - Used for products where it sells from consumer electronics to software
- Alibaba - Provide their apps an excellent experience to its customers
- WizzAir - A budget airline WizzAir used for their customers user interface
- EuroNews
- Laracasts
- GitLab
- Laracasts
-
When the default render function encounters an error then you can use rennderError as an alternative render output. The error will be passed to renderError as the second argument. The example usage of renderError is as below,
new Vue({ render (h) { throw new Error('An error') }, renderError (h, err) { return h('div', { style: { color: 'red' }}, err.stack) } }).$mount('#app')
-
The $parent object refers to the immediate outer scope. The parent will be accessible as
this.$parent
for the child, and the child will be pushed into the parentβs $children array. It establishes a parent-child relationship between the two instances(parent and child). You can access parent data and properties similar to $root. -
Vuex is a state management pattern + library (Flux-inspired Application Architecture) for Vue.js applications. It serves as a centralized store for all the components in an application, with rules ensuring that the state can only be mutated in a predictable fashion.
-
The state management has state, view and actions as major components. The pattern followed by these components in a application is known as State Management Pattern. Below are the components in a detail,
- The state, which is the source of truth that drives our app
- The view, which is just a declarative mapping of the state
- The actions, which are the possible ways the state could change in reaction to user inputs from the view. Let us take a counter example which follows state management pattern with the above 3 components,
new Vue({ // state data () { return { count: 0 } }, // view template: ` <div>{{ count }}</div> `, // actions methods: { increment () { this.count++ } } })
-
Vue.js has a one-way data flow model, through the props property. The same concept can be represented in vuex has below,
-
Vue loader is a loader for webpack that allows you to author Vue components in a format called Single-File Components (SFCs). For example, it authors HelloWorld component in a SFC,
<template> <div class="greeting">{{ message }}</div> </template> <script> export default { data () { return { message: 'Hello world for vueloader!' } } } </script> <style> .greeting { color: blue; } </style>
-
Vue Loader's configuration is a bit different from other loaders by adding Vue Loader's plugin to your webpack config. The vue loader plugin is required for cloning any other rules(js and css rules) defined and applying them to the corresponding language blocks(<script> and <style>) in .vue files. For example, the simple demonistration of webpack configuration for vue loader would be as below,
// webpack.config.js const VueLoaderPlugin = require('vue-loader/lib/plugin') module.exports = { mode: 'development', module: { rules: [ { test: /\.vue$/, loader: 'vue-loader' }, // this will apply to both plain `.js` files and `<script>` blocks in `.vue` files { test: /\.js$/, loader: 'babel-loader' }, // this will apply to both plain `.css` files and `<style>` blocks in `.vue` files { test: /\.css$/, use: [ 'vue-style-loader', 'css-loader' ] } ] }, plugins: [ // make sure to include the plugin for cloning and mapping them to respective language blocks new VueLoaderPlugin() ] }
-
Below are the list of Asset URL transform rules
- ** Absolute path**: If the URL is an absolute path (for example, /images/loader.png)then it will be preserved as-is.
- ** Relative path**: If the URL starts with
.
(for example, ./images/loader.png) then it will be interpreted as a relative module request and resolved based on the folder structure on your file system. - ** URLs starts with ~ symbol **: If the URL starts with
~
symbol(for example, ./some-node-package/loader.png) then it is interpreted as a module request. This way it can reference assets inside node modules too. - ** URLs starts with @ symbol**: If the URL starts with
@
symbol then it is interpreted as a module request. This is useful if your webpack config has an alias for @, which by default points to/src
path.
-
Vue-loader
will automatically infer the proper loaders to use based on thelang
attribute of a language block and the rules defined in webpack config. You can use pre-processors such as SASS,LESS, Stylus and PostCSS using vuejs loader. -
Scoped CSS is a mechanism in VueJS Single File Components(SFC) that prevents styles from leaking out of the current component and affecting other unintended components on your page. i.e, When a <style> tag has the scoped attribute, its CSS will apply to elements of the current component only. It uses PostCSS to transform scoped css to plain CSS. Let's take an example usage of scoped css,
<style scoped> .greeting { color: green; } </style> <template> <div class="greeting">Let's start Scoped CSS</div> </template>
The above code will be converted to plain CSS,
<style scoped> .greeting[data-v-f3f3eg9] { color: green; } </style> <template> <div class="greeting" data-v-f3f3eg9>Let's start Scoped CSS</div> </template>
-
Yes, You can include both scoped and non-scoped styles in the same component. If you don't mention scoped attribute then it will become global style.
<style> /* global styles */ </style> <style scoped> /* local styles */ </style>
-
In scoped css, if you need to modify the styles of a child component using deep selectors(i,e from parent scoped css) then you need to use >>> combinator. For example, the scoped deep selector on parent scoped css would be as below,
<style scoped> .class1 >>> .class2 { /* ... */ } </style>
It will be converted as,
.class1[data-v-f3f3eg9] .class2 { /* ... */ }
Note: If you preprocessors such as SASS then it may not be able to processs >>> properly. In such cases use the /deep/ or ::v-deep combinator instead >>> combinator.
-
The parent component's styles will not leak into child components. But a child component's root node will be affected by both the parent's scoped CSS and the child's scoped CSS. i.e, your child component's root element has a class that also exists in the parent component, the parent component's styles will leak to the child. Anyway this is by design so that the parent can style the child root element for layout purposes. For example, the background color property of parent component leaked into child component as below, //parent.vue
<template> <div class="wrapper"> <p>parent</p> <ChildMessageComponent/> </div> </template> <script> import ChildMessageComponent from "./components/child"; export default { name: "App", components: { ChildMessageComponent } }; </script> <style scoped> .wrapper { background: blue; } </style>
//child.vue
<template> <div class="wrapper"> <p>child</p> </div> </template> <script> export default { name: "Hello, Scoped CSS", }; </script> <style scoped> .wrapper { background: red; } </style>
Now the background color of child wrapper is going to be blue instead red.
-
The scoped css style doesn't impact v-html directive's dynamically generated content. In this case, you can use deep selectors to solve this styling issue.
-
Yes, vue-loader provides first-class integration with CSS Modules as an alternative for simulated scoped CSS.
-
No, templates (or any Vue-specific HTML) are ONLY allowed in .vue files and render functions are required in other cases.
-
Below are the steps to use css modules in VueJS,
- ** Enable CSS modules:** CSS Modules must be enabled by passing modules: true option to css-loader
// webpack.config.js { module: { rules: [ // ... other rules omitted { test: /\.css$/, use: [ 'vue-style-loader', { loader: 'css-loader', options: { // enable CSS Modules modules: true, // customize generated class names localIdentName: '[local]_[hash:base64:8]' } } ] } ] } }
- ** Add module attribute:** Add the module attribute to your
<style>
<style module> .customStyle { background: blue; } </style>
- ** Inject CSS modules:** You can inject CSS modules object with computed property $style
<template> <div :class="$style.blue"> Background color should be in blue </p> </template>
It can work with object/array syntax of :class binding.
-
Yes,You can use preprocessors with CSS Modules. For example, sass-loader can configured in webpack file for sass preprocessor.
// webpack.config.js -> module.rules { test: /\.scss$/, use: [ 'vue-style-loader', { loader: 'css-loader', options: { modules: true } }, 'sass-loader' ] }
-
You can customize the name of the injected computed property by giving the module attribute a value. This will be helpful to avoid overwriting injected styled if you have more than one <style> tags in a single *.vue component. For example, you can use module attribute as below,
<style module="a"> /* identifiers injected as a */ </style> <style module="b"> /* identifiers injected as b */ </style>
-
Hot reloading is not about reloading the page when you edit any .vue file. Instead, when you edit a *.vue file, all instances of that component will be swapped in without reloading the page. It improves the development experience when you are tweaking the templates or styling of your components.
-
Hot Reload is always enabled except below situations:
- webpack target is node (SSR)
- webpack minifies the code
- process.env.NODE_ENV === 'production'
-
You can use
hotReload: false
option to disable the Hot Reload explicitly. It can be configured as below,module: { rules: [ { test: /\.vue$/, loader: 'vue-loader', options: { hotReload: false // disables Hot Reload } } ] }
-
The vue loader plugin internally uses hot reloading. If you are scaffolding project with
vue-cli
, hot reloading comes out of the box but if you are manually setting up the project then hot reloading is enabled by default withwebpack-dev-server --hot
command. -
Below are the state preservation rules in hot reloading, 1.When editing the
<template>
of a component, instances of the edited component will re-render in place, preserving all current private state. 2.When editing the<script>
part of a component, instances of the edited component will be destroyed and re-created in place. 3.When editing the<style>
hot reload operates on its own via vue-style-loader without affecting application state. -
You can create functional components by adding functional attribute to template block,
<template functional> <div>{{ props.msg }}</div> </template>
-
If you need to access properties defined globally on
Vue.prototype
then you can access them on parent,<template functional> <div>{{ parent.$someProperty }}</div> </template>
-
You can perform testing in two ways,
- ** Using vue-cli:** It offers pre-configured unit testing and e2e testing setups
- ** Manual setup:** You can manually setting up unit tests for *.vue files using either mocha-webpack or jest
-
The stylelint linter supports linting style parts of Vue single file components. You can run linter on particular vue file as below
stylelint MyComponent.vue
Other option is configuring stylelint-webpack-plugin in webpack. It can be configured as a dev dependency.
// webpack.config.js const StyleLintPlugin = require('stylelint-webpack-plugin'); module.exports = { // ... other options plugins: [ new StyleLintPlugin({ files: ['**/*.{vue,htm,html,css,sss,less,scss,sass}'], }) ] }
-
The official
eslint-plugin-vue
supports linting both the template and script parts of Vue single file components. You can configure plugin in your ESLint config,// .eslintrc.js module.exports = { extends: [ "plugin:vue/essential" ] }
You can run linter on particular component as below,
eslint --ext js,vue MyComponent.vue
-
You can use
eslint-loader
for *.vue files in order to automatically linted on save during development. It can be installed as npm module,npm install -D eslint eslint-loader
After that you need to add it as pre-loader,
// webpack.config.js module.exports = { // ... other options module: { rules: [ { enforce: 'pre', test: /\.(js|vue)$/, loader: 'eslint-loader', exclude: /node_modules/ } ] } }
-
CSS Extraction is used to extract all the processed CSS in all Vue components into a single CSS file. For webpack4, you need to install below npm command,
npm install -D mini-css-extract-plugin
You can configure this plugin in webpack as below,
// webpack.config.js var MiniCssExtractPlugin = require('mini-css-extract-plugin') module.exports = { // other options... module: { rules: [ // ... other rules omitted { test: /\.css$/, use: [ process.env.NODE_ENV !== 'production' ? 'vue-style-loader' : MiniCssExtractPlugin.loader, 'css-loader' ] } ] }, plugins: [ // ... Vue Loader plugin omitted new MiniCssExtractPlugin({ filename: 'style.css' }) ] }
-
You can define custom language blocks inside *.vue files based on the
lang
attribute of the block, the block's tag name, and the rules in your webpack config. You can also useresourceQuery
to match a rule against a custom block with no lang. For example, to match against custom blocks.{ module: { rules: [ { resourceQuery: /blockType=message/, loader: 'loader-to-use' } ] } }
-
Below are the list of major stylelint features
- It has more than 160 built-in rules to catch errors, apply limits and enforce stylistic conventions
- Understands latest CSS syntax including custom properties and level 4 selectors
- It extracts embedded styles from HTML, markdown and CSS-in-JS object & template literals
- Parses CSS-like syntaxes like SCSS, Sass, Less and SugarSS
- Supports Plugins for reusing community plugins and creating own plugins
-
Vuex enforces below rules to structure any application.
- Application-level state is centralized in the store.
- The only way to mutate the state is by committing mutations, which are synchronous transactions.
- Asynchronous logic should be encapsulated in, and can be composed with actions. The project structure for any non-trivial application would be as below,
-
Yes, Vuex supports hot-reloading for mutations, modules, actions and getters during development. You need to use either webpack's hot module replacement API or browserify's hot module replacement plugin.
-
The store.hotUpdate() API method is used for mutations and modules. For example, you need to configure vuex store as below,
// store.js import Vue from 'vue' import Vuex from 'vuex' import mutations from './mutations' import myModule from './modules/myModule' Vue.use(Vuex) const state = { message: "Welcome to hot reloading" } const store = new Vuex.Store({ state, mutations, modules: { moduleA: myModule } }) if (module.hot) { // accept actions and mutations as hot modules module.hot.accept(['./mutations', './modules/newMyModule'], () => { // Get the updated modules const newMutations = require('./mutations').default const newMyModule = require('./modules/myModule').default //swap in the new modules and mutations store.hotUpdate({ mutations: newMutations, modules: { moduleA: newMyModule } }) }) }
-
Since mutations are just functions that completely rely on their arguments it will be easier to test. You need to keep mutations inside your store.js file and should also export the mutations as a named export apart from default export. Let's take an example of increment mutations,
// mutations.js export const mutations = { increment: state => state.counter++ }
And test them using mocha and chai as below,
// mutations.spec.js import { expect } from 'chai' import { mutations } from './store' // destructure assign `mutations` const { increment } = mutations describe('mutations', () => { it('INCREMENT', () => { // mock state const state = { counter: 10 } // apply mutation increment(state) // assert result expect(state.counter).to.equal(11) }) })
-
It is easier to test getters similar to mutations. It is recommended to test these getters if they have complicated computation. Let's take a simple todo filter as a getter
// getters.js export const getters = { filterTodos (state, status) { return state.todos.filter(todo => { return todo.status === status }) } }
And the test case for above getter as follows,
// getters.spec.js import { expect } from 'chai' import { getters } from './getters' describe('getters', () => { it('filteredTodos', () => { // mock state const state = { todos: [ { id: 1, title: 'design', status: 'Completed' }, { id: 2, title: 'testing', status: 'InProgress' }, { id: 3, title: 'development', status: 'Completed' } ] } // mock getter const filterStatus = 'Completed' // get the result from the getter const result = getters.filterTodos(state, filterStatus) // assert the result expect(result).to.deep.equal([ { id: 1, title: 'design', status: 'Completed' }, { id: 2, title: 'development', status: 'Completed' } ]) }) })
-
By proper mocking, you can bundle tests with webpack and run them on node without having depenceny on Browser API. It involves 2 steps,
- Create webpack config: Create webpack config with proper .babelrc
// webpack.config.js module.exports = { entry: './test.js', output: { path: __dirname, filename: 'test-bundle.js' }, module: { loaders: [ { test: /\.js$/, loader: 'babel-loader', exclude: /node_modules/ } ] } }
- ** Run testcases:** First you need to bundle and then run them using mocha as below,
webpack mocha test-bundle.js
-
Below are the steps to run tests in real browser,
- Install
mocha-loader
. - Configure webpack config entry point to 'mocha-loader!babel-loader!./test.js'.
- Start webpack-dev-server using the config.
- Go to localhost:8080/webpack-dev-server/test-bundle to see the test result
- Install
-
In strict mode, whenever Vuex state is mutated outside of mutation handlers, an error will be thrown. It make sure that all state mutations can be explicitly tracked by debugging tools. You can just enable this by passing
strict: true
while creating the vuex store.const store = new Vuex.Store({ // ... strict: true })
-
No, it is not recommended to use strict mode in production environment. Strict mode runs a synchronous deep watcher on the state tree for detecting inappropriate mutations and it can be quite expensive when you perform large amount of mutations. i.e, It can impact performance if you enable in production mode. Hence it should be handled through build tools,
const store = new Vuex.Store({ // ... strict: process.env.NODE_ENV !== 'production' })
-
The vuex plugin is an option hat exposes hooks for each mutation. It is a normal function that receives the store as the only argument. You can create your own plugin or use built-in plugins. The plugin skeleton would be as below,
const myPlugin = store => { // called when the store is initialized store.subscribe((mutation, state) => { // called after every mutation. // The mutation comes in the format of `{ type, payload }`. }) }
After that plugin can be configured for plugins options as below,
const store = new Vuex.Store({ // ... plugins: [myPlugin] })
-
Similar to components you can't mutate state directly but they can trigger changes by by committing mutations. This way a plugin can be used to sync a data source to the store. For example, createWebSocketPlugin plugin is used to sync a websocket data source to the store.
export default function createWebSocketPlugin (socket) { return store => { socket.on('data', data => { store.commit('receiveData', data) }) store.subscribe(mutation => { if (mutation.type === 'UPDATE_DATA') { socket.emit('update', mutation.payload) } }) } }
And then configure plugin in vuex store as below
const plugin = createWebSocketPlugin(socket) const store = new Vuex.Store({ state, mutations, plugins: [plugin] })
-
A Vuex "store" is basically a container that holds your application state. The store creation is pretty straightforward. Below are the list of instructions to use vuex in an increment application,
- Configure vuex in vuejs ecosystem
import Vuex from "vuex"; Vue.use(Vuex)
- Provide an initial state object and some mutations
// Make sure to call Vue.use(Vuex) first if using a module system const store = new Vuex.Store({ state: { count: 0 }, mutations: { increment (state) { state.count++ } } })
- Trigger state change with commit and access state variables,
store.commit('increment') console.log(store.state.count) // -> 1
-
Below are the two major differences between vuex store and plain global object
- Vuex stores are reactive: If the store's state changes then vue components will reactively and efficiently get updated
- Cannot directly mutate the store's state: The store's state is changed by explicitly committing mutations to ensure that every state change leaves a track-able record for tooling purpose
-
We want to explicitly track application state in order to implement tools that can log every mutation, take state snapshots, or even perform time travel debugging. So we need to commit a mutation instead of changing store's state directly.
-
Vuex's single state tree is single object contains all your application level state and serves as the "single source of truth". It does not conflict with modularity when you split state and mutations into sub modules.
-
You can install vuex using npm or yarn as below,
npm install vuex --save (or) yarn add vuex
In a module system, you must explicitly install Vuex via Vue.use()
import Vue from 'vue' import Vuex from 'vuex' Vue.use(Vuex)
(OR) You can also install it using CDN links such as unpkg.cpm which provides NPM-based CDN links. Just include vuex after Vue and it will install itself automatically.
<script src="https://unpkg.com/vue.js"></script> <script src="https://unpkg.com/vuex.js"></script>
Note: You can use a specific version/tag via URLs like https://unpkg.com/vuex@2.0.0. If you don't mention any version then it will point to latest version.
-
Yes, Vuex requires Promise. If your supporting browsers do not implement Promise (e.g. IE), you can use a polyfill library, such as es6-promise using npm or yarn.
npm install es6-promise --save # NPM yarn add es6-promise # Yarn
After that import into anywhere in your application,
import 'es6-promise/auto'
-
Since Vuex stores are reactive, you can retrieve" state from store by simply returning store's state from within a computed property. i.e, Whenever store state changes, it will cause the computed property to re-evaluate, and trigger associated DOM updates. Let's take a hello word component which display store's state in the template,
// let's create a hello world component const Greeting = { template: `<div>{{ greet }}</div>`, computed: { greet () { return store.state.msg } } }
-
Vuex provides a mechanism to "inject" the store into all child components from the root component with the store option. It will be enabled by vue.use(vuex). For example, let's inject into our app component as below,
const app = new Vue({ el: '#app', // provide the store using the "store" option. // this will inject the store instance to all child components. store, components: { Greeting }, template: ` <div class="app"> <greeting></greeting> </div> ` })
Now the store will be injected into all child components of the root and will be available on them as this.$store
// let's create a hello world component const Greeting = { template: `<div>{{ greet }}</div>`, computed: { greet () { return this.$store.state.msg } } }
-
In Vuex application, creating a computed property every time whenever we want to access the store's state property or getter is going to be repetitive and verbose, especially if a component needs more than one state property. In this case, we can make use of the mapState helper of vuex which generates computed getter functions for us. Let's take an increment example to demonstrate mapState helper,
// in full builds helpers are exposed as Vuex.mapState import { mapState } from 'vuex' export default { // ... computed: mapState({ // arrow functions can make the code very succinct! username: state => state.username, // passing the string value 'username' is same as `state => state.username` usernameAlias: 'username', // to access local state with `this`, a normal function must be used greeting (state) { return this.localTitle + state.username } }) }
We can also pass a string array to mapState when the name of a mapped computed property is the same as a state sub tree name
computed: mapState([ // map this.username to store.state.username 'username' ])
-
You can use object spread operator syntax in order to combine mapState helper(which returns an object) with other local computed properties. This way it simplify merging techniques using utilities.
computed: { localComputed () { /* ... */ }, // mix this into the outer object with the object spread operator ...mapState({ // ... }) }
-
No, if a piece of state strictly belongs to a single component, it could be just fine leaving it as local state. i.e, Eventhough vuex used in the application, it doesn't mean that you need to keep all the local state in vuex store. Other the code becomes more verbose and indirect although it makes your state mutations more explicit and debuggable.
-
Vuex getters acts as computed properties for stores to compute derived state based on store state. Similar to computed properties, a getter's result is cached based on its dependencies, and will only re-evaluate when some of its dependencies have changed. Let's take a todo example which as completedTodos getter to find all completed todos,
const store = new Vuex.Store({ state: { todos: [ { id: 1, text: 'Vue course', completed: true }, { id: 2, text: 'Vuex course', completed: false }, { id: 2, text: 'Vue Router course', completed: true } ] }, getters: { completedTodos: state => { return state.todos.filter(todo => todo.completed) } } })
**Note:**Getters receive state as first argument.
-
You can access values of store's getter object(store.getters) as properties. This is known as property style access. For example, you can access todo's status as a property,
store.getters.todosStatus
The getters can be passed as 2nd argument for other getters. For example, you can derive completed todo's count based on their status as below,
getters: { completedTodosCount: (state, getters) => { return getters.todosStatus === 'completed' } }
Note: The getters accessed as properties are cached as part of Vue's reactivity system.
-
You can access store's state in a method style by passing arguments. For example, you can pass user id to find user profile information as below,
getters: { getUserProfileById: (state) => (id) => { return state.users.find(user => user.id === id) } }
After that you can access it as a method call,
store.getters.getUserProfileById(111); {id: '111', name: 'John', age: 33}
-
The mapGetters is a helper that simply maps store getters to local computed properties. For example, the usage of getters for todo app would be as below,
import { mapGetters } from 'vuex' export default { computed: { // mix the getters into computed with object spread operator ...mapGetters([ 'completedTodos', 'todosCount', // ... ]) } }
-
Vuex mutations are similar to any events with a string
type
and ahandler
. The handler function is where we perform actual state modifications, and it will receive the state as the first argument. For example, the counter example with increment mutation would be as below,const store = new Vuex.Store({ state: { count: 0 }, mutations: { increment (state) { // mutate state state.count++ } } })
You can't directly invoke mutation instead you need to call
store.commit
with its type. The above mutation would be triggered as folowsstore.commit('increment')
-
You can also pass payload for the mutation as an additional argument to
store.commit
. For example, the counter mutation with payload object would be as below,mutations: { increment (state, payload) { state.count += payload.increment } }
And then you can trigger increment commit
store.commit('increment', { increment: 20 })
Note: You can also pass primitives as payload.
-
You can also commit a mutation is by directly using an object that has a type property.
store.commit({ type: 'increment', value: 20 })
Now the entire object will be passed as the payload to mutation handlers(i.e, without any changes to handler signature).
mutations: { increment (state, payload) { state.count += payload.value } }
-
Since a Vuex store's state is made reactive by Vue, the same reactivity caveats of vue will apply to vuex mutations. These are the rules should be followed for vuex mutations,
- It is recommended to initialize store's initial state with all desired fields upfront
- Add new properties to state Object either by set method or object spread syntax
Vue.set(stateObject, 'newProperty', 'John')
(OR)
state.stateObject = { ...state.stateObject, newProperty: 'John' }
-
You need to remember that mutation handler functions must be synchronous. This is why because any state mutation performed in the callback is essentially un-trackable. It is going to be problematic when the devtool will need to capture a "before" and "after" snapshots of the state during the mutations.
mutations: { someMutation (state) { api.callAsyncMethod(() => { state.count++ }) } }
-
You can commit mutations in components with either this.$store.commit('mutation name') or mapMutations helper to map component methods to store.commit calls. For example, the usage of mapMutations helper on counter example would be as below,
import { mapMutations } from 'vuex' export default { methods: { ...mapMutations([ 'increment', // map `this.increment()` to `this.$store.commit('increment')` // `mapMutations` also supports payloads: 'incrementBy' // map `this.incrementBy(amount)` to `this.$store.commit('incrementBy', amount)` ]), ...mapMutations({ add: 'increment' // map `this.add()` to `this.$store.commit('increment')` }) } }
-
No, it is not mandatory. But you might observed that State management implementations such Flux and Redux use constants for mutation types. This convention is just a preference and useful to take advantage of tooling like linters, and putting all constants in a single file allows your collaborators to get an at-a-glance view of what mutations are possible in the entire application. For example, the mutations can be declared as below,
// mutation-types.js export const SOME_MUTATION = 'SOME_MUTATION'
And you can configure them in store as follows,
// store.js import Vuex from 'vuex' import { SOME_MUTATION } from './mutation-types' const store = new Vuex.Store({ state: { ... }, mutations: { // ES2015 computed property name feature to use a constant as the function name [SOME_MUTATION] (state) { // mutate state } } })
-
In Vuex, mutations are synchronous transactions. But if you want to handle asynchronous operations then you should use actions.
-
Actions are similar to mutations, but there are two main differences,
- Mutations perform mutations on the state, actions commit mutations.
- Actions can contain arbitrary asynchronous operations unlike mutations.
-
Vuex provides actions property similar mutations property in order to define action handlers. These action handlers receive context object as an argument which has same properties and methods of store instance. Let's see counter example to demonstrate increment action which commits respective mutation,
const store = new Vuex.Store({ state: { count: 0 }, mutations: { increment (state) { state.count++ } }, actions: { increment (context) { context.commit('increment') } } })
-
Actions are simply triggered with the store.dispatch method as below,
store.dispatch('increment')
-
Yes, actions support both payload and object style format similar to mutations.
// dispatch with a payload store.dispatch('incrementAsync', { amount: 10 }) // dispatch with an object store.dispatch({ type: 'incrementAsync', amount: 10 })
-
Styled components is basically used for ReactJS applications. If you want to use for VueJS applications, there is vuejs styled components library available under styled component library. VueJS Styled component is a javascript library for stying vuejs applications.
-
You can dispatch actions in components with this.$store.dispatch('action name'), or use the mapActions helper which maps component methods to store.dispatch calls. For example, you can dispatch increment actions in counter component as below,
import { mapActions } from 'vuex' export default { // ... methods: { ...mapActions([ 'increment', // map `this.increment()` to `this.$store.dispatch('increment')` // `mapActions` also supports payloads: 'incrementBy' // map `this.incrementBy(amount)` to `this.$store.dispatch('incrementBy', amount)` ]), ...mapActions({ add: 'increment' // map `this.add()` to `this.$store.dispatch('increment')` }) } }
-
You can write multiple actions together to handle more complex async flows either by chaining promises or async/await. i.e,
store.dispatch
can handle Promise returned by the triggered action handler and it also returns Promise. Let's take two actions to see how they are combined and handled async flows,actions: { actionOne ({ commit }) { return new Promise((resolve, reject) => { setTimeout(() => { commit('first mutation') resolve() }, 1000) }) }, actionTwo ({ dispatch, commit }) { return dispatch('actionA').then(() => { commit('second mutation') }) } }
As per the above example, When you try to dispatch actionTwo it dispatchs actionOne first and then commits respective mutation. You can still simplify with async/await as below,
actions: { async actionOne ({ commit }) { commit('first mutation', await getDataAsPromise()) }, async actionTwo ({ dispatch, commit }) { await dispatch('actionOne') // wait for `actionA` to finish commit('second mutation', await getSomeDataAsPromise()) } }
-
If you keep all state of our application in a single big state, the store can get really bloated. To solve this problem, Vuex allows us to divide our store into modules. Here, each module can contain its own state, mutations, actions, getters, and even nested modules. Let's take an example with multiple modules, configuring them in vuex and accessing different modules,
const moduleOne = { state: { ... }, mutations: { ... }, actions: { ... }, getters: { ... } } const moduleTwo = { state: { ... }, mutations: { ... }, actions: { ... }, getters: { ... } } const store = new Vuex.Store({ modules: { one: moduleOne, two: moduleTwo } }) store.state.one // -> `moduleOne's state store.state.one // -> `moduleTwo's state
-
When you use modules the local state will be available to mutations, getters and actions in different ways.
- Both mutations and getters will receive module local state as first argument.
const moduleOne = { state: { count: 0 }, mutations: { increment (state) { state.count++; // Here state refers local module state } }, getters: { average (state) { return state.count / 2 } } }
- In actions, local state will be available as first argument.
const moduleOne = { actions: { incrementConditional ({ state, commit, rootState }) { if (state.count < rootState.count) { commit('increment') } } } }
-
By default, actions, mutations and getters inside modules are still registered under the global namespace. Because of that multiple modules react to the same mutation/action type.
-
Sometime you may need to create multiple instances of a module. For example, it is needed in the below cases,
- If multiple stores that use the same module
- Register the same module multiple times in the same store. In those cases, you need to assign to a variable and export it for reusability,
const MyReusableModule = { // state // mutations, actions, getters... }
Check out contribution guidelines πCONTRIBUTING.md
MIT License
Copyright (c) 2019 Asif Vora
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.