Skip to content

Alpine.js plugin for cleanly making multiple client side pages with expanded reactivity.

License

Notifications You must be signed in to change notification settings

BanceDev/alpine-pages

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Alpine Pages

Alpine Pages is a plugin desinged to make it simpler to make multiple "pages" for your Alpine SPA. This is achieved by allowing you to make fully reactive html and css inside your Alpine.data, enabling you to use alpine in more freeform ways and preventing clutter in your html documents.

Install

With a CDN

<script
  defer
  src="https://unpkg.com/alpinejs-pages@latest/dist/pages.min.js"
></script>

<script defer src="https://unpkg.com/[email protected]/dist/cdn.min.js"></script>

With a Package Manager

yarn add -D alpinejs-pages

npm install -D alpinejs-pages
import Alpine from "alpinejs";
import pages from "alpinejs-pages";

Alpine.plugin(pages);

Alpine.start();

Example

To create a page, just add a page function to an Alpine.data. This function needs to return a string of html that will make up your page. You may also make a styles function that will create scoped css for your page. The plugin automatically handles reactivity for embedding format strings. That way if any member of your data updates the page or styles will update with it.

document.addEventListener("alpine:init", () => {
  Alpine.data("home", () => ({
    message: "hello",
    color: "red",
    styles() {
      return `
        h2 {
          color: ${this.color};
        }
      `;
    },
    page() {
      return `<h2>${this.message}</h2>`;
    },
  }));
});

In the HTML you first need to add your data to the scope. Then to render the page just attach the x-page property to an html tag and it will fill in the inner html with your page. Since the page functions as a sort of template you can also make multiple instances of the page if you want by attaching the x-page attribute to multiple html tags within your data scope.

<div x-data="home">
  <button @click="message = 'goodbye'">goodbye</button>
  <div x-page></div>
</div>

About

Alpine.js plugin for cleanly making multiple client side pages with expanded reactivity.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published