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.
We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.
You're free to use this package (it's MIT-licensed), but if it makes it to your production environment you are required to send us a postcard from your hometown, mentioning which of our package(s) you are using.
Our address is: Spatie, Kruikstraat 22, 2018 Antwerp, Belgium.
The best postcards will get published on the open source page on our website.
You can install the package via npm:
$ npm install vue-pjax
or yarn:
$ yarn add 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'
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>
- Events
- Resource
- Recompilation
Please see CHANGELOG for more information what has changed recently.
Please see CONTRIBUTING for details.
If you discover any security related issues, please contact Freek Van der Herten instead of using the issue tracker.
Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.
The MIT License (MIT). Please see License File for more information.