This is a simplified cheatsheet along with some tips for people who often works with Vue.js.
- Expressions
- Directives
- List Rendering
- Binding
- Actions / Events
- Component Anatomy
- Custom Events
- Life Cycle Hooks
- Using a Single Slot
- Multiple slots
- Libraries You Should Know
- Tips
- Contribution
- Donate
<div id="app">
<p>I have a {{ product }}</p>
<p>{{ product + 's' }}</p>
<p>{{ isWorking ? 'YES' : 'NO' }}</p>
<p>{{ product.getExpiryDate() }}</p>
</div>
Element inserted/removed based on truthiness:
<p v-if="inStock">{{ product }}</p>
<p v-else-if="onSale">...</p>
<p v-else>...</p>
Toggles the display: none CSS property:
<p v-show="showProductDetails">
...
</p>
Two-way data binding:
<input v-model="firstName">
v.model.lazy="..." // Syncs input after change event
v.model.number="..." // Always returns a number
v.model.trim="..." // Strips whitespace
<li v-for="item in items" :key="item.id">
{{ item }}
</li>
To access the position in the array:
<li v-for="(item, index) in items">...</li>
To iterate through objects:
<li v-for="value in object">...</li>
<li v-for="(value, index) in object">...</li>
<li v-for="(value, name, index) in object">...</li>
Using v-for with a component:
<cart-product v-for="item in products" :product="item" :key="item.id">
<a v-bind:href="url">...</a>
<a :href="url">...</a> // Shorthand
True or false will add or remove attribute:
<button :disabled="isButtonDisabled">...</button>
If isActive is truthy, the class 'active' will appear:
<div :class="{ active: isActive }">...</div>
Style color set to value of activeColor:
<div :style="{ color: activeColor }">...</div>
Passing arguments to a computed binding:
<template>
<ProductComponent :cost="product_type('product_2')"></ProductComponent>
</template>
<script>
import ProductComponent from @/components/ProductComponent
export default {
components: { ProductComponent },
data() {
return {
products: {
product_1: '100',
product_2: '200',
product_3: '300'
}
}
},
computed: {
product_type() {
// Argument passed to arrow function, NOT computed function declaration.
return (product_id) => { // Arrow function to allow 'this' instance to be accessible.
return this.products[product_id] // Square bracket notation for 'any' type variable
}
}
}
}
</script>
Calls addToCart method on component:
<button v-on:click="addToCart">...</button>
<button @click="addToCart">...</button> // Shorthand
Arguments can be passed:
<button @click="addToCart(product)">...</button>
To prevent default behaviour (e.g. page reload):
<form @submit.prevent="addProduct">...</form>
Only trigger once:
<img @mouseover.once="showImage">
.stop // Stop all event propagation
.self // Only trigger if event.target is element itself
Keyboard entry example:
<input @keyup.enter="submit">
Call onCopy when control-c is pressed:
<input @keyup.ctrl.c="onCopy">
Key modifiers:
.tab
.delete
.esc
.space
.up
.down
.left
.right
.ctrl
.alt
.shift
.meta
Mouse modifiers:
.left
.right
.middle
<template>
<span>{{ message }}</span>
</template>
<script>
import ProductComponent from '@/components/ProductComponent'
import ReviewComponent from '@/components/ReviewComponent'
export default {
components: { // Components that can be used in the template
ProductComponent,
ReviewComponent
},
props: { // The parameters the component accepts
message: String,
product: Object,
email: {
type: String,
required: true,
default: 'none',
validator: function (value) {
// Should return true if value is valid
}
}
},
data: function () { // Must be a function
return {
firstName: 'Vue',
lastName: 'Mastery'
}
},
computed: { // Return cached values until dependencies change
fullName: function () {
return `${this.firstName} ${this.lastName}`
}
},
watch: { // Called when firstName changes value
firstName: function (value, oldValue) { /* ... */ }
},
methods: { /* ... */ }
}
</script>
Use props (above) to pass data into child components, custom events to pass data to parent elements.
Set listener on component, within its parent:
<button-counter v-on:incrementBy="incWithVal">...</button-counter>
Inside parent component:
methods: {
incWithVal: function (toAdd) { ... }
}
Inside button-counter template:
this.$emit('incrementyBy', 5)
beforeCreate
created
beforeMount
mounted
beforeUpdate
updated
beforeDestroy
destroyed
Component template MyComponent
:
<div>
<h2>I'm a title</h2>
<slot>
Only displayed if no slot content
</slot>
</div>
Use of MyComponent
with custom data for the slot:
<my-component>
<p>This will go in the slot</p>
</my-component>
Component AppLayout
template:
<div class="container">
<header>
<slot name="header"></slot>
</header>
<main>
<slot>Default content</slot>
</main>
<footer>
<slot name="footer"></slot>
</footer>
</div>
Use of AppLayout
with custom data for the slots:
<app-layout>
<h1 slot="header">Page title</h1>
<p>The main content</p>
<p slot="footer">Contact info</p>
</app-layout>
Command line interface for rapid Vue development.
Navigation for a Single-Page Application.
Browser extension for debugging Vue applications.
Library for server side rendering, code-splitting, hot-reloading, static generation and more.
<script>
export default {
data () {
return {
someVar: ''
}
},
mounted () {
this.someVar: {
level1: {
level2: {
level3: 'something old'
}
}
}
},
methods : {
changeSomeVar () {
this.someVar.level1.level2.level3 = 'something new'
}
}
}
</script>
That method looks like it should work, say you have an input that matches someVar.level1.level2.level3
, if you ran this method it would not update the model. Instead you need to use Vue.set
or in a SPC (Single Page Component) you'd just use this.$set
:
<script>
export default {
// ...
methods : {
changeSomeVar () {
this.$set(this.someVar.level1.level2, 'level3', 'new value here')
}
}
}
</script>
This could start a flame war, some Vue fan will tell you to start with an event bus and work your way up, but Vuex is modular enough that you can use it on small and large apps alike. If you're building a SPA there's no chance you'll have fun without Vuex, you're going to implement a lot of the same functionality in your event bus, and making any other developer who works on the project's life a living hell.
A good primer on vuex can be found here: WTF is Vuex? A Beginner’s Guide To Vue’s Application Data Store
Here's a simple use case, say you have an order form that pops up. If for some reason the user closes the order form and reopens it you might find some of the fields won't allow edits, or they have stale data, or if you're triggering the popup via a select box it might not work right. Honestly it's a major headache.
One trick is to re-render your components. The easiest method I've found to do that is whenever a modal or some other component is registered on the DOM pass it a key, or on mount make it generate a random one. A good key could just be to use Date.now()
or moment.js
to generate a UTC timestamps and use that.
The key tells Vue that this is a NEW instance, forget about the old one, and let's start over.
Essentially a prop is data that you pass INTO the component from a parent component or on initializing the root component for the first time.
Data is the reactive properties defined on the instance. I find it to be a good practice if you ever think you'll need to update the value or use it re-actively to create a new value on mount that is a duplicate of the prop. So say you have a prop called colorProp
, you might have a value in data called just color
, then in your mounted()
method have this.color
set to colorProp
.
You may start out just letting users wait without knowing what's going on but this is going to get dirty fast. Especially when you bring Vuex and multiple data points into the mix. It's best to have a single global loader setup that triggers whenever the global loading property from Vuex is updated. This way you can always toggle it properly and make sure to un-toggle it.
One caveat is though - be sure you catch all errors - especially when using axios and promises and be sure to end the loading message on errors so users can go back, fix things and resubmit the form.
The example below is a bad example on how you should be using filters:
<template>
<div>
<!-- Bad idea -->
<input type="text" ..> ${{ moneyVar | money }}
</div>
</template>
<script>
export default {
data() {
moneyVar: 3.50
},
filters: {
money: function (value) {
if (!value) {
return '0.00'
}
return '$' + parseFloat(value).toFixed(2)
}
}
}
</script>
We should make it a global filter:
<script>
Vue.filter('money', function (value) {
if (!value) {
return '0.00'
}
return '$' + parseFloat(value).toFixed(2)
})
</script>
- Report issues
- Open pull request with improvements
- Spread the word
- Reach out to me directly at mauriurraco@gmail.com