Back to Checkbox-guidelines

CSS ComponentThe latest version of this package is: 17.0.30-alpha.0, Opens in new window

Checkboxes allow the selection of multiple options from a set

This component provides .css, .styl, .less and .scss -files.

To be able to install this component, please refer to the Project Setup documentation.

View repository, Opens in new windowView package, Opens in new window
$ npm i @ids-core/checkbox@17.0.30-alpha.0
A paved road or a path?
Preview

Table of Contents

Edit this section, Opens in new window

Usage

Required markup

[...]
<div class='if input-wrapper'>
    <fieldset class='if'>
        <legend class='if'>A paved road or a path?</legend>
        <div class='if checkboxes [horizontal]'>
            <input
                id='checkboxes-implementation-checkbox-1'
                type='checkbox'
                class='if checkbox'
            />
            <label for='checkboxes-implementation-checkbox-1'>A path! A path!</label>
            <input
                id='checkboxes-implementation-checkbox-2'
                type='checkbox'
                class='if checkbox'
            />
            <label for='checkboxes-implementation-checkbox-2'>A path! A path!</label>
            <input
                id='checkboxes-implementation-checkbox-3'
                checked
                type='checkbox'
                class='if checkbox'
            />
            <label for='checkboxes-implementation-checkbox-3'>A path! A path!</label>
            <span
                class='if input-error'
                aria-live='polite'
            >A validation error</span>
            <span class='if input-help'>A helpful text</span>
        </div>
    </fieldset>
</div>
</form>
[...]
Edit this section, Opens in new window

Modifiers

Standalone

If you want to use a checkbox as a standalone component, i.e. just a checkbox without label, use the .standalone -class.

<form autocomplete="off" style="width: 100%">
    <div class="if input-wrapper">
        <div class="if checkboxes">
            <input
                checked
                type="checkbox"
                id="checkbox-standalone-checkbox2"
                class="if checkbox standalone"
                name="checkbox-standalone-checkbox2"
            />
            <label for="checkbox-standalone-checkbox2"></label>
        </div>
    </div>
</form>
Edit this section, Opens in new window

Tokens

All of the tokens can be used as preprocessor and CSS variables

Checkbox tokens

Name Value Is aliased in
$ids-checkbox-margin-right
 0.5rem
$ids-checkbox-height
 1.5rem
$ids-checkbox-width
 1.5rem
$ids-checkbox-background-color
 rgb(255, 255, 255)
$ids-checkbox-border
 0.0625rem solid rgb(110, 98, 94)
$ids-checkbox-border-radius
 0.25rem
$ids-checkbox-background-size
 1.5rem 1.5rem
$ids-checkbox-checked-border
 0.0625rem solid rgb(0, 84, 240)
$ids-checkbox-checked-background-color
 rgb(0, 84, 240)
$ids-checkbox-checked-background-image
 url('data:image/svg+xml,%3Csvg width=%2716%27 height=%2716%27 viewBox=%270 0 16 16%27 fill=%27none%27 xmlns=%27http://www.w3.org/2000/svg%27%3E%3Cg clip-path=%27url(%23clip0_1424_21)%27%3E%3Cpath d=%27M2 8.8L5.42857 12L14 4%27 stroke=%27%23faf9f7%27 stroke-width=%272.4%27 stroke-miterlimit=%2710%27 stroke-linecap=%27square%27/%3E%3C/g%3E%3Cdefs%3E%3CclipPath id=%27clip0_1424_21%27%3E%3Crect width=%2716%27 height=%2716%27 fill=%27white%27/%3E%3C/clipPath%3E%3C/defs%3E%3C/svg%3E%0A')
$ids-checkbox-checked-background-size
 1rem 1rem
$ids-checkbox-checked-focus-border
 0.0625rem solid rgb(18, 65, 162)
$ids-checkbox-checked-focus-background-color
 rgb(18, 65, 162)
$ids-checkbox-checked-hover-background-color
 rgb(18, 65, 162)
$ids-checkbox-checked-hover-border
 0.0625rem solid rgb(18, 65, 162)
$ids-checkbox-checked-active-background-color
 rgb(18, 65, 162)
$ids-checkbox-checked-active-border
 0.0625rem solid rgb(18, 65, 162)
$ids-checkbox-checked-active-background-image
 url('data:image/svg+xml,%3Csvg width=%2716%27 height=%2716%27 viewBox=%270 0 16 16%27 fill=%27none%27 xmlns=%27http://www.w3.org/2000/svg%27%3E%3Cg clip-path=%27url(%23clip0_1424_21)%27%3E%3Cpath d=%27M2 8.8L5.42857 12L14 4%27 stroke=%27%23faf9f7b3%27 stroke-width=%272.4%27 stroke-miterlimit=%2710%27 stroke-linecap=%27square%27/%3E%3C/g%3E%3Cdefs%3E%3CclipPath id=%27clip0_1424_21%27%3E%3Crect width=%2716%27 height=%2716%27 fill=%27white%27/%3E%3C/clipPath%3E%3C/defs%3E%3C/svg%3E%0A')
$ids-checkbox-checked-disabled-background-color
 rgba(110,98,94,0.4)
$ids-checkbox-checked-disabled-background-image
 url('data:image/svg+xml,%3Csvg width=%2716%27 height=%2716%27 viewBox=%270 0 16 16%27 fill=%27none%27 xmlns=%27http://www.w3.org/2000/svg%27%3E%3Cg clip-path=%27url(%23clip0_1424_21)%27%3E%3Cpath d=%27M2 8.8L5.42857 12L14 4%27 stroke=%27%23f1ece8%27 stroke-width=%272.4%27 stroke-miterlimit=%2710%27 stroke-linecap=%27square%27/%3E%3C/g%3E%3Cdefs%3E%3CclipPath id=%27clip0_1424_21%27%3E%3Crect width=%2716%27 height=%2716%27 fill=%27white%27/%3E%3C/clipPath%3E%3C/defs%3E%3C/svg%3E%0A')
$ids-checkbox-checked-invalid-background-color
 rgb(187, 50, 12)
$ids-checkbox-checked-invalid-border
 0.0625rem solid rgb(187, 50, 12)
$ids-checkbox-focus-border
 0.0625rem solid rgb(51, 30, 17)
$ids-checkbox-focus-outline
 0.125rem dotted rgb(0, 84, 240)
$ids-checkbox-focus-outline-offset
 0.125rem
$ids-checkbox-invalid-focus-border
 0.125rem solid rgb(187, 50, 12)
$ids-checkbox-invalid-border
 0.125rem solid rgb(187, 50, 12)
$ids-checkbox-label-font-size
 16px
$ids-checkbox-label-line-height
 1.25rem
$ids-checkbox-label-color
 rgb(51, 30, 17)
$ids-checkbox-standalone-label-height
 1.5rem
$ids-checkbox-standalone-label-width
 1.5rem
$ids-checkbox-standalone-margin-right
 0
$ids-checkbox-hover-border
 0.125rem solid rgb(51, 30, 17)
$ids-checkbox-active-border
 0.125rem solid rgb(18, 65, 162)
$ids-checkbox-disabled-label-color
 rgba(110,98,94,0.6)
$ids-checkbox-disabled-background-color
 rgb(250, 249, 247)
$ids-checkbox-disabled-border
 0.0625rem solid rgba(110, 98, 94, 0.3)
Edit this section, Opens in new window

Changelog

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

16.0.0 (2023-01-10)

⚠ BREAKING CHANGES

  • Checkboxes - smaller with rounded corners. Checked state - thicker checkmark,

filled background.Radio-buttons - smaller buttons, rounded focus.

  • Merged PR 93047: feat(checkbox radio-buttons): style improvements for checkboxes and radio-but... (0ddda18), closes #672478 #672478

14.22.2 (2022-05-03)

Miscellaneous chores

  • package locks: update package locks (813eac7)

14.20.1 (2022-04-19)

Miscellaneous chores

  • changelog: regenerate all CHANGELOG.md files (64ab385) , closes #586342
  • changelog: regenerate all changelogs after updating changelog generation (70789c9) , closes #587270

14.18.3 (2022-04-13)

Bug Fixes

  • changelog: generate new CHANGELOG.md files for root and packages (349fda4) , closes #586063 . We regenerate the files to include all relevant commits and to use conventional-commits at 100%

14.16.0 (2022-04-07)

Bug Fixes

  • 🐛 Add missing imports for global CSS Variables (fbf6f06) , closes #582437

14.9.0 (2022-03-03)

Miscellaneous chores

14.8.1 (2022-02-23)

Bug Fixes

  • 🐛 Add missing imports of typography CSS variables (e716c65) , closes #559412

reinstall (d425056)

bootstrap (9a713df)

merge (2b1c5f1)

reinstall (5221600)

reinstall (147df55)

14.3.0 (2022-02-09)

Bug Fixes

  • Use correct vars and mixins (f879b28)

  • Add engines for all packages (e95dfff)

reinstall (afce1f2)

reinstall (67f3140)

  • Add changelog.md to files (3338314)

Reinstall (a2abf51)

14.2.2 (2021-12-10)

Code Refactoring

reinstall (885c74b)

  • fix changelogs manually (b1232b4)

reinstall (545a069)

reinstall (e149c2c)

13.12.3 (2021-11-09)

⚠ BREAKING CHANGES

  • 🧨 The scope for If Design System npm packages has now changed from @if-design-system to @ids-core. We have also renamed the repository from if-design-system to ids-core
  • 🧨 Util is now renamed to Utils
  • 🧨 We have now changed the navigation structure for the documentation site. Please update any saved links!
  • 🧨 Navigation structure has now changed. Please see release notes!

Documentation Updates

  • ✏️ Documentation adjustments (73c09e3) , closes #467386

  • ✏️ Move position of the quick links (5cb0897)

  • ✏️ Remove unneeded margins for shortcuts (36c7e8d)

  • ✏️ Split out CSS documentation (1c21fa7) , closes #467386

  • ✏️ Update links and change navigation structure (0bfd27d) , closes #490579

Code Refactoring

  • 💡 Categorize components (9965266) , closes #490579

  • 💡 Reduce spacing tokens, use correct size tokens (97aa461)

  • 💡 Rename scope and repository (3ea5423)

  • 💡 Use new navigation structure for documentation (415aee5) , closes #490579

  • another change in the structure (38a0d2e)

Miscellaneous chores

bootstrap (6fc1ed8)

  • fix all old references to util (d57bf17)

  • prepare for merge (0184490)

reinstall (da80dba)

  • Rename scope and repo (257684e)

  • use correct version for utils (49e72d9)

13.11.0 (2021-10-19)

Features

  • 🎸 Input field hot reload (eac76b7)

13.9.2 (2021-09-30)

Bug Fixes

  • 🐛 Complete the pseudo-element fix (1dcee2c)

13.7.0 (2021-09-22)

Documentation Updates

  • ✏️ Update linking layout and naming (15c383b)

13.6.3 (2021-09-17)

Bug Fixes

13.6.0 (2021-09-08)

Documentation Updates

  • Use default shortcut listing for demo links (a746602)

13.5.1 (2021-09-07)

Bug Fixes

Documentation Updates

  • ✏️ USe wider examples for data sizes (67cd1f5)

  • 🤖 Rearrange diffs for test, use grey color for unaffected (1834399)

  • continue to fix form input widths (b66977e)

  • 🤖 Use node v14 (4009973)

bootstrap (d23e139)

  • 🤖 Use correct order for diff (cc6a4fd)

12.14.1 (2021-08-12)

Miscellaneous chores

  • 🤖 Add ci task to package.json without tests (21222e0) , closes #457627

12.13.1 (2021-08-11)

Bug Fixes

  • 🐛 Whitelist docs dir for npm packaging (1a5cfd0) , closes #457621

12.12.1 (2021-08-10)

Bug Fixes

  • 🐛 fix typo (d97331a)

  • 🤖 Remove .gitignore, use npm package.json files instead, ignore zip files for npm pack (49f0269) , closes #412081 . This will whitelist files to be used in "npm pack"

  • 🤖 Reinstall (e660696)

  • 🤖 Update published date (61e7ccf)

12.6.0 (2021-05-27)

Bug Fixes

  • 🐛 Manually set firstPublished and lastModified (e83af7d)

  • 🐛 We don't need lastModified (e458a12)

12.0.0 (2021-05-05)

⚠ BREAKING CHANGES

  • 🧨 All of the mixins have now been renamed
  • 🧨 Notification is now renamed to Alert Banner
  • 🧨 This extracts the Hero variation with no image into a separate, design updated component named Header
  • 🧨 Footer is now renamed to Global Footer
  • 🧨 The Dropdown Component is now renamed to Dropdown Select. Dropdown is a pattern.
  • 🧨 Crosslinks have seized to exist. They are all extracted into separate components. This commit converts crosslink buttons into the new component Shortcuts
  • 🧨 Selection controls is no more. Has ceased to be. Bereft of life, it rests in peace. This is an ex-component. The component is split into Radio Buttons, Toggle Control and Checkbox

Features

  • 🎸 Extract components from selection control (50607a4) , closes #336508

  • 🎸 Rename and extract and update hero with no image to (384eb77) , closes #336508 . Header component

Bug Fixes

  • 🐛 Use correct data size for largest (3357893)

Documentation Updates

  • ✏️ Update documentation for selection controls (46d15e9)

Code Refactoring

rebuild (7edb430)

Edit this section, Opens in new window
Contact us, Opens in new window