README.md

JWT Cart

JWT Cart is a lightweight library that provides cart for shopping or just storing your own cart-items

Features

• Store all items in local storage
• Add/remove items callbacks
• Get JWT token with decoded cart items

Installation

• Run the below command to add jwt-cart to your exisitng or new project.

npm install --save jwt-cart

or

yarn add jwt-cart -S

• Import jwt-cart into your module to start using it.

import JwtCart from 'jwt-cart'

Adding JwtCart to HTML page using the traditional method

<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/jwt-cart"></script>

Files are delivered via the CDN service provided by jsdeliver

Documentation

1. Add form to items

<!-- Add item form -->
<form method="post" class="jwt-cart-item">
  <input type="hidden" name="id" value="{{ product.id }}"> <!-- This input is required! -->
  <input type="hidden" name="count" value="1">
  <button type="submit">Add item</button>
</form>

2. Setup Cart

  const onItemAdded = (form, item, items) => {
    // isInit is true 
    // your code
    // EXAMPLE: form.getElementsByTagName('button')[0].innerHTML = 'Remove product';
  }

  const onItemRemoved = (form, item, items) => {
    // your code
    // EXAMPLE: form.getElementsByTagName('button')[0].innerHTML = 'Add product';
  }
  
  const onBind = (form, item, items) => {
    // Call when item added during bind bindItems (page inizialized)
    // your code
    // EXAMPLE: form.getElementsByTagName('button')[0].innerHTML = 'Remove product';
  }

  const onChange = (items) => {
    // Call when local store was mutated
  }
  
  const jwtCart = new JwtCart('my-cart-key');

  jwtCart.onAdd(onItemAdded);
  jwtCart.onRemove(onItemRemoved);
  jwtCart.onBind(onBind);
  jwtCart.onChange(onChange);

  // This method scan page and bind forms with class "jwt-cart-item"
  jwtCart.bindItems();

Allowed methods

1. jwtCart.clearAll() - remove all items
2. jwtCart.addItem(item) - add item to cart, item is required an object which contains id and optional fields
3. jwtCart.removeItem(item) - remove item from cart, item is required an object which contains id

License

MIT © Hastes