yuzu

old school component management

Manage your HTML based components in style with progressive enhancement.

• Installation
  • As NPM Package
  • CDN Delivered <script>
  • ES2017 Syntax
• Browser Support
• Example
• Documentation
• Contributing

Installation

As NPM Package

npm install yuzu --save

# or

yarn add yuzu

CDN Delivered <script>

Add the following script tags before your code

<script src="https://unpkg.com/yuzu"></script>

Yuzu modules will be available in the global scope under the YZ namespace (YZ.Component, YZ.mount, etc.).

ES2017 Syntax

To provide maximum compatibility with every development environment, packages are transpiled to ES5. When used with a bundler like Webpack or rollup the module resolution system will automatically pick either the Commonjs or ESM version based on your configuration.

If you want to import the ES2017 version of a package you can do so by setting an alias on the bundler's configuration file:

Webpack

// webpack.config.js
 
module.exports = {
  // ...
+  resolve: {
+    alias: {
+      'yuzu': 'yuzu/dist/index.next.js'
+    }
+  }
}

Rollup

Use rollup-plugin-alias

// rollup.config.js
+ import path from 'path';
+ import alias from 'rollup-plugin-alias';
 
export default {
  input: './src/index.js',
  plugins: [
    // ...
+    alias({
+      'yuzu': path.resolve(__dirname, 'node_modules/yuzu/dist/index.next.js')
+    })
  ],
};

Browser Support

Yuzu works in all modern browsers. In order to make it work in browsers that don't support ES2015+ features (like IE11) you need to include the yuzu-polyfills package before any other yuzu* package.

If you're using a package bundler add this line at the very top of your entry point:

import 'yuzu-polyfills';

Example

<div class="counter"></div>

import { Component } from 'yuzu';
 
class Counter extends Component {
  state = { count: 0 };
  actions = {
    count(value) {
      this.$el.innerText = value;
    },
  };
 
  mounted() {
    this.interval = setInterval(() => {
      this.setState(({ count }) => ({
        count: count + 1,
      }));
    }, 1000);
  }
 
  beforeDestroy() {
    if (this.interval) {
      clearInterval(this.interval);
    }
  }
}
 
new Counter().mount('.counter');

Documentation

Learn more about Yuzu! Read the full documentation or browse the API.

Contributing

1. Fork it or clone the repo
2. Install dependencies yarn install
3. Code your changes and write new tests in the test folder.
4. Ensure everything is fine by running yarn build
5. Push it or submit a pull request :D