Skip to content

A Collection is an array of objects with a primary key property. It can quantify each item inside collection, motived by shopping cart needed functionalities. It can optionally also trigger an update callback function given as constructor optional argument.

License

Notifications You must be signed in to change notification settings

enriquerene/objs-collection

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Collection

A Collection is an array of objects with a primary key property. It can quantify each item inside collection, motived by shopping cart needed functionalities. It can optionally also trigger an update callback function given as constructor optional argument.

Table of Contents

Support

If you need some help or found bug you can open an issue.

Installation

There are some installation ways. You can choose the best way for you.

NPM (recommended)

This way requires NodeJS installed:

$ npm install collection

or using Yarn

$ yarn add collection

Git

Clone the repo into your project:

$ git clone https://github.com/enriquerene/collection.git

Zip

Dowload the package and uncpack it into your project: Dowload ZIP

Usage

Here we cover how to properly use Collection library. Collection identify uniquely each item via primaryKey with default value 'id'. I's possible set whole items list as array of objects via items setter or pushing one object at time via push method. You can set a default quantity for incoming objects. The Collection instance optionally can receive a second argument used as update collection items callback. The default behavior does not include callback, you must pass an one parameter function to constructor. Let's see some examples:

checking-primary-key

The objects must own primaryKey property and have unique values. Use primaryKey to work with:

import Collection from 'collection';

const coll = new Collection();

console.log(coll.primaryKey); // 'id'
coll.primaryKey = 'uniqueKey';
console.log(coll.primaryKey); // 'uniqueKey'

push-one-at-time

Push items into items collection using push.

import Collection from 'collection';

const coll = new Collection();

coll.push({id:1});
coll.push({id:2});
coll.push({id:3});
console.log(coll.items); // [{id:1}, {id:2}, {id:3}]

set-entire-items-list

Set items to the array you want to be the items collection:

import Collection from 'collection';

const coll = new Collection();

coll.items = [{id:1}, {id:2}, {id:3}];
console.log(coll.items); // [{id:1}, {id:2}, {id:3}]

Reset Collection items

Set items to empty array to "clear/reset" collection:

import Collection from 'collection';

const coll = new Collection();

coll.push({id:1});
console.log(coll.items); // [{id:1}]
coll.items = [];
console.log(coll.items); // []

Working with callback

Set a callback and instantiate an Collection object:

import Collection from 'collection';

const updateCallback = (_v) => { console.log(_v) };
const coll = new Collection(updateCallback);

coll.push({id:1}); // console logs '[{id:1}]'

Plan

Some features what are expected for future versions:

Contribute

If you have something good to share in this project, you are welcome. Just do a pull request with your code.

Author

You can find more projects from Collection's author. Learn more about in (https://enriquerene.com.br)[https://enriquerene.com.br].

About

A Collection is an array of objects with a primary key property. It can quantify each item inside collection, motived by shopping cart needed functionalities. It can optionally also trigger an update callback function given as constructor optional argument.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published