Skip to content

📁 The / baraja-js / plugin React component wrapper.

License

Notifications You must be signed in to change notification settings

nuxy/react-baraja-js

Repository files navigation

React Baraja-JS

npm version Install size

Preview

Baraja is a JavaScript plugin that allows to move elements in a card-like fashion and spreads them like one would spread a deck of cards on a table. It uses CSS transforms for rotating and translating the items.

There are several options available that will create various spreading possibilities of the items, for example, moving the items laterally or rotating them in a fan-like way.

Checkout the demo for examples of use.

Dependencies

Installation

Add to an existing React project using YARN.

$ yarn add react-baraja-js

Usage

import React    from 'react';
import BarajaJS from 'react-baraja-js'; // or '../dist/react-baraja-js';

const cards = [
  {
    imageSrc: 'path/to/image1.png',
    title: 'card 1',
    details: 'this is card 1'
  },
  {
    imageSrc: 'path/to/image2.png',
    title: 'card 2',
    details: 'this is card 2'
  },
  {
    imageSrc: 'path/to/image3.png',
    title: 'card 3',
    details: 'this is card 3'
  },
  {
    imageSrc: 'path/to/image4.png',
    title: 'card 4',
    details: 'this is card 4'
  },

  // add more cards ...
]

export default class Demo extends React.Component {
  constructor() {
    super();

    this.state = {
      fan: {}
    };
  }

  // Fan right
  fanEvent() {
    this.setState({
      fan: {
        direction: 'right',
        easing: 'ease-out',
        origin: {
          x: 25,
          y: 100
        },
        speed: 500,
        range: 90,
        center: true
      }
    });
  }

  render() {
    return (
      <React.Fragment>
        <BarajaJS fan={fan}>
          {cards.map(({imageSrc, title, details}, index) => {
            return (
              <React.Fragment key={index}>
                <img src={imageSrc} alt={title} />
                <h4>{title}</h4>
                <p>{details}</p>
              </React.Fragment>
            );
          })}
        </BarajaJS>

        <button id="fan-button" onClick={() => this.fanEvent()}>Fan right</button>
      </React.Fragment>
    );
  }
};

Component Props

Name Type Description
id String Default baraja-js
options Object Override animation defaults.
add String Card item HTML markup.
fan Object Configure fan options.
close Boolean Close the deck if true
last Boolean Show last card if true
next Boolean Show next card if true

Documentation

Developers

CLI options

Run ESLint on project sources:

$ npm run lint

Transpile ES6 sources (using Babel) and minify to a distribution:

$ npm run build

Bundle demo sources (using Webpack):

$ npm run webpack

Contributions

If you fix a bug, or have a code you want to contribute, please send a pull-request with your changes. (Note: Before committing your code please ensure that you are following the Node.js style guide)

Versioning

This package is maintained under the Semantic Versioning guidelines.

License and Warranty

This package is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

Baraja-JS is provided under the terms of the MIT license

Demo and proof-of-concept by Codrops [LICENSE]

Demo background patterns by Subtle Patterns [LICENSE]

Demo card illustrations by Jason Custer

Author

Marc S. Brooks