/parcel-plugin-vue

📦 Make Parcel surport Vue single file components.

Primary LanguageJavaScript

parcel-plugin-vue npm david-dm

Stability: 1 - Experimental This feature is still under active development and subject to non-backwards compatible changes, or even removal, in any future version. Use of the feature is not recommended in production environments.

Make Parcel surport Vue single file components.

【What's the Parcel】【What's the Vue】【What's the Vue single file components】

Using Plugin

Using plugins in Parcel could not be any simpler. All you need to do is install them and save in your package.json. Plugins should be named with the prefix parcel-plugin-, e.g. parcel-plugin-foo. Any dependencies listed in package.json with this prefix will be automatically loaded during initialization.

You must node >= 8

npm i parcel-plugin-vue -D

Examples

Make some issues clear

You Should install parcel-bundler yourself

The plugins for parcel-bundler need a same version of parcel-bundler at runtime.

You Should install vue / vue-template-compiler yourself

You can choose the version of Vue yourself.

But the version of vue-template-compiler must be eq the version of Vue.

I will move the 'vue-template-compiler' to peerDependencies from devDependencies at next version.

You Should config Babel yourself

Default, Vue rely on Babel so that need install 'babel-plugin-transform-runtime' and 'babel-preset-es2015'.

But 'babel-preset-es2015' will be replace by 'babel-preset-env'.

So, We recommend more:

Make and edit the file '.babelrc' yourself.

Custom Compilers

The plugin for Vue is using built-in compiler compiles the other lang.

Those compilers are:

coffee,babel less,sass,scss,stylus jade,pug

That will allow you to use other parcel plugins to process a part of a Vue component at next version.

But now, you need do it yourself, I'm sorry for this.

You can make a file named 'vue.config.js', edit and save it

var TypeScriptAsset = require('parcel-bundler/src/assets/TypeScriptAsset.js');

module.exports = {
    customCompilers: {
        ts: function (content, cb, compiler, filePath) {
            let ts = new TypeScriptAsset(filePath, {}, {});
            ts.contents = content;
            ts.process().then((res) => {
                cb(null, res.js);
            });
        }
    }
};

For 'vue.config.js', you can refer to https://www.npmjs.com/package/vueify#configuring-options

This Plugin only support '*.vue'

When you meet this:

[Vue warn]: You are using the runtime-only build of Vue where the template compiler is not available. Either pre-compile the templates into render functions, or use the compiler-included build.

Maybe in your code:

import Vue from 'vue';

new Vue({
  el: '#app',
  template: '...', // This is reason for Error 
  ...
});

You should change to:

import Vue from 'vue/dist/vue.esm.js';

new Vue({
  el: '#app',
  template: '...',
  ...
});

or We recommend more:

import Vue from 'vue';
import YourVue from 'YourVue.vue';

const app = new Vue({
  el: '#app',
  render: h => h(Index)
});