Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

boundless-checkbox-group

Package Overview
Dependencies
Maintainers
1
Versions
11
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

boundless-checkbox-group

A controller view for managing the aggregate state of multiple, related checkboxes.

  • 1.1.0
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
14
increased by55.56%
Maintainers
1
Weekly downloads
 
Created
Source

CheckboxGroup

The most common use case for CheckboxGroup is a "select all" / children scenario. This particular configuration is built-in and is activated by passing the selectAll prop.

Installation

npm i boundless-checkbox-group --save

Then use it like:

/** @jsx createElement */

import { createElement, PureComponent } from 'react';
import CheckboxGroup from 'boundless-checkbox-group';
import { filter, map, merge, some } from 'lodash';

export default class CheckboxGroupDemo extends PureComponent {
    state = {
        items: [ {
            inputProps: {
                checked: false,
                name: 'likes-science',
            },
            label: 'Science',
        }, {
            inputProps: {
                checked: false,
                name: 'likes-math',
            },
            label: 'Mathematics',
        }, {
            inputProps: {
                checked: false,
                name: 'likes-tech',
            },
            label: 'Technology',
        }, {
            inputProps: {
                checked: false,
                name: 'likes-art',
            },
            label: 'Art',
        }, {
            inputProps: {
                checked: false,
                name: 'likes-sports',
            },
            label: 'Sports',
        } ],
    }

    mutateAll(delta) {
        this.setState({
            items: map(this.state.items, function transformer(item) {
                return merge({}, item, delta);
            }),
        });
    }

    mutateOne(name, delta) {
        this.setState({
            items: map(this.state.items, function transformer(item) {
                if (item.inputProps.name !== name) {
                    return item;
                }

                return merge({}, item, delta);
            }),
        });
    }

    handleAllChecked = () => {
        this.mutateAll({ inputProps: { checked: true } });
    }

    handleAllUnchecked = () => {
        this.mutateAll({ inputProps: { checked: false } });
    }

    handleChildChecked = (name) => {
        this.mutateOne(name, { inputProps: { checked: true } });
    }

    handleChildUnchecked = (name) => {
        this.mutateOne(name, { inputProps: { checked: false } });
    }

    renderFeedback() {
        if (some(this.state.items, { inputProps: { checked: true } })) {
            const liked = map(filter(this.state.items, { inputProps: { checked: true } }), 'label');
            const lastIndex = liked.length - 1;

            return (
                <p>You said you like: {liked.length === 1 ? liked[0] : [ liked.slice(0, lastIndex).join(', '), 'and', liked.slice(lastIndex) ].join(' ')}.</p>
            );
        }
    }

    render() {
        return (
            <div>
                <p>What subjects are you interested in?</p>
                <CheckboxGroup
                    className='checkbox-group-demo'
                    items={this.state.items}
                    selectAll={CheckboxGroup.selectAll.AFTER}
                    selectAllProps={{ label: 'All of the above' }}
                    onAllChecked={this.handleAllChecked}
                    onAllUnchecked={this.handleAllUnchecked}
                    onChildChecked={this.handleChildChecked}
                    onChildUnchecked={this.handleChildUnchecked} />
                    <br />
                {this.renderFeedback()}
            </div>
        );
    }
}

CheckboxGroup can also just be directly used from the main Boundless library. This is recommended when you're getting started to avoid maintaining the package versions of several components:

npm i boundless --save

the ES6 import statement then becomes like:

import { CheckboxGroup } from 'boundless';

Props

Note: only top-level props are in the README, for the full list check out the website.

Required Props

  • items · the data wished to be rendered, each item must conform to the Checkbox prop spec

    ExpectsDefault Value
    array[]

Optional Props

  • * · any React-supported attribute

    ExpectsDefault Value
    anyn/a
  • component · override the wrapper HTML element if desired

    ExpectsDefault Value
    string'div'
  • onAllChecked · called when all children become checked (not fired on first render), no return

    ExpectsDefault Value
    function() => {}
  • onAllUnchecked · called when all children become unchecked (not fired on first render), no return

    ExpectsDefault Value
    function() => {}
  • onChildChecked · called when a specific child has become checked, returns the child definition

    ExpectsDefault Value
    function() => {}
  • onChildUnchecked · called when a specific child has become checked, returns the child definition

    ExpectsDefault Value
    function() => {}
  • selectAll · renders a master checkbox that can manipulate the values of all children simultaneously

    ExpectsDefault Value
    CheckboxGroup.selectAll.BEFORE or CheckboxGroup.selectAll.AFTER or CheckboxGroup.selectAll.NONECheckboxGroup.selectAll.BEFORE
  • selectAllProps · must conform to the Checkbox prop spec

    ExpectsDefault Value
    object{}

Reference Styles

Stylus

You can see what variables are available to override in variables.styl.

// Redefine any variables as desired, e.g:
color-accent = royalblue

// Bring in the component styles; they will be autoconfigured based on the above
@require "node_modules/boundless-checkbox-group/style"

CSS

If desired, a precompiled plain CSS stylesheet is available for customization at /build/style.css, based on Boundless's default variables.

Keywords

FAQs

Package last updated on 06 Jun 2017

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc