# j-ShoppingCart

> j-ShoppingCart: singleton; apoya el descuento

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: es
Content-SHA256: e07bd183508ae39139ec5b4d2763adfb31a6d4d45412c9ba318222aaff9e2361
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

- singleton
- admite descuento
- los datos se almacenan en localStorage

__Configuración__:

- `discount {Number}` un descuento en porcentaje (opcional, predeterminado: `0`)
- Caducidad de datos `expiration {String}` (predeterminado: `6 days`)

__Salida__:

```js
{
	items: [
		{
			name: String,
			price: Number,
			total: Number,
			count: Number,
			date: Date
		}
	],
	price: Number,
	total: Number,
	count: Number
}
```

### Métodos

- `instance.add(id, price, count, [name])` agrega un nuevo producto o aumenta el recuento si el producto existe
- `instance.upd(id, [count], [price], [name])` actualiza los datos del producto.
- `instance.buy(id, price, count, [name])` crea/actualiza el producto
- `instance.rem(id)` elimina el producto
- `instance.has(id)` comprueba el producto
- `instance.read(id)` lee el producto
- `instance.clear()` borra todos los productos
- `instance.clean()` elimina todos los productos con recuento cero
- `instance.sync(function(array_id_products, meta) {})` crea datos para sincronización con el servidor

### Eventos globales

- `ON('shoppingcart.add', function(item) {})`
- `ON('shoppingcart.upd', function(item) {})`
- `ON('shoppingcart.rem', function(id) {})`
- `ON('shoppingcart.sum', function(data) {})`
- `ON('shoppingcart.clear', function() {})`

Úselo con `<ui-component name="shoppingcart">`. Cuando el componente aún no está cargado, jComponent lo descarga en el primer uso desde la dirección en `DEF.fallback` (el CDN Componentator de forma predeterminada). Autor: Peter Širka. Fuente: repositorio de componentes Componentator, licencia MIT.

```html example.html
<ui-component name="shoppingcart" path="common.shoppingcart"></ui-component>

<script>
	var common = {};
</script>
```