vue-pjax

THIS IS AN EXPERIMENT THAT MIGHT NEVER GET A STABLE RELEASE

This package provides a Vue component and directive to progressively enhance your site with pjax.

<!--
    Clicking one of the links will replace `pjax-container`'s contents since
    it's name is linked to the `v-pjax` directive.
-->

<ul>
    <li><a href="/foo" v-pjax:content>Foo</a></li>
    <li><a href="/bar" v-pjax:content>Bar</a></li>
</ul>

<pjax-container name="content">
    Hello world!
</pjax-container>

<!-- `v-pjax` can also be bound to form submits. -->

<pjax-container name="my-form">
    <form method="post" v-pjax:my-form>
        <!-- ... -->
    </form>
</pjax-container>

Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.

Installation

You can install the package via npm:

$ npm install vue-pjax

This package requires your application to provide two peerDependencies: vue and vue-resource.

$ npm install vue@'^1.0.24' vue-resource@'^0.7.4'

Usage

To enable the pjax component and directive, the easiest way is to register the mixin in your root component:

import Vue from 'vue';
import VueResource from 'vue-resource';
import pjax from 'vue-pjax';

Vue.use(VueResource);

new Vue({
    el: 'body',
    mixins: [pjax],
});

If you prefer global components, you'll have to register them separately:

import { PjaxContainer, pjax } from 'vue-pjax';
import Vue from 'vue';
import VueResource from 'vue-resource';

Vue.use(VueResource);

Vue.component('pjax-container', PjaxContainer);
Vue.directive('pjax', pjax);

<pjax-container name="my-dynamic-section">
    No one
</pjax-container>

<a href="/hodor" v-pjax:my-dynamic-section>
    Replace 'No one' with Hodor's contents
</a>
<a href="/bran" v-pjax:my-dynamic-section>
    Replace 'No one' with Bran's contents
</a>

Forms:

<pjax name="my-dynamic-form">
    <form action="/submit" v-pjax:my-dynamic-form>
        <!-- Form submissions will replace `my-dynamic-form` with the server's response -->
    </form>
</pjax>

Why Vue?

Events
Resource
Recompilation

Change log

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please contact Freek Van der Herten instead of using the issue tracker.

Credits

About Spatie