http-vue-loader

Load .vue files directly from your html/js. No node.js environment, no build step.

examples

my-component.vue

<template>
	<div class="hello">Hello {{who}}</div>
</template>

<script>
module.exports = {
	data: function() {
		return {
			who: 'world'
		}
	}
}
</script>

<style>
.hello {
	background-color: #ffe;
}
</style>

myFile.html

using httpVueLoader()

...
<script type="text/javascript">

	new Vue({
		components: {
			'my-component': httpVueLoader('my-component.vue')
		},
		...

or, using httpVueLoaderRegister()

...
<script type="text/javascript">

	httpVueLoaderRegister(Vue, 'my-component.vue');

	new Vue({
		components: [
			'my-component'
		},
		...

or, using httpVueLoader as a plugin

...
<script type="text/javascript">

	Vue.use(httpVueLoader);

	new Vue({
		components: {
			'my-component': 'url:my-component.vue'
		},
		...

or, using an array

	new Vue({
		components: [
			'url:my-component.vue'
		},
		...

Features

http-vue-loader only supports text/x-template for <template>, text/javascript for <script> and text/css for <style>.
<template>, <script> and <style> support the src attribute.
<style scoped> is supported.
module.exports may be a promise.

Browser Support


Latest ✔	Latest ✔	?	?	Latest ✔	9+ ✔

Requirements

Vue.js 2 (compiler and runtime)
es6-promise (optional, except for IE, Chrome < 33, FireFox < 29, ... )

API

httpVueLoader(`url`)

url: any url to a .vue file

httpVueLoaderRegister(`vue`, `url`)

vue: a Vue instance
url: any url to a .vue file

httpVueLoader.httpRequest(`url`)

This is the default httpLoader.

Use axios instead of the default http loader:

httpVueLoader.httpRequest = function(url) {
	
	return axios.get(url)
	.then(function(res) {
		
		return res.data;
	})
	.catch(function(err) {
		
		return Promise.reject(err.status);
	});
}

How it works

http request the vue file
load the vue file in a document fragment
process each section (template, script and style)
return a promise to Vue.js (async components)
then Vue.js compiles and cache the component

Notes

The aim of http-vue-loader is to quickly test .vue components without any compilation step.
However, for production, I recommend to use webpack module bundler with vue-loader, webpack-simple is a good minimalist webpack config you should look at.
BTW, see also why Vue.js doesn't support templateURL.

Caveat

Due to the lack of suitable API in Google Chrome and Internet Explorer, syntax errors in the <script> section are only reported on FireFox.

Credits

Franck Freiburger

xatgithub/http-vue-loader