@truecms/control-input

@truecms/control-input

Control inputs include radio buttons and checkboxes. They allow users to select one or more options.

Contents

• Install
• Usage
• Dependency graph
• Tests
• Release History
• License

Install

pnpm add @truecms/control-input

npm install @truecms/control-input

⬆ back to top

Usage

• React

⬆ back to top

React

Usage:

import { AUcheckbox, AUradio } from './control-input.js';

<AUradio label="Yes" name="has_email" value="yes" id="yes" />
<AUradio label="No" name="has_email" value="no" id="no" />
<AUradio label="Maybe" name="has_email" value="maybe" id="maybe" />

<AUcheckbox label="Has email?" name="has_email" id="has-email" />

All props:

<AUradio
  label="The label"  {/* The label of the radio button */}
  id="radio-ex"      {/* The id of the radio button*/}
  alt={ false }      {/* An alternate variation of the component */}
  small={ false }    {/* The small variation of the component */}
  dark={ false }     {/* The dark variation of the component */}
/>

<AUcheckbox
  label="The label"  {/* The label of the checkbox */}
  id="checkbox-ex"   {/* The id of the radio button*/}
  alt={ false }      {/* An alternate variation of the component */}
  small={ false }    {/* The small variation of the component */}
  dark={ false }     {/* The dark variation of the component */}
/>

(💡 additional props are spread onto the component)

For more details have a look at the usage example.

⬆ back to top

Dependency graph

control-input
└─ core

⬆ back to top

Tests

The visual test: https://design-system-components.truecms.com.au/packages/control-input/tests/site/

⬆ back to top

Release History

• v4.0.0 - 7f941cd: Document stewardship responsibilities under the TrueCMS organisation, lock the Node 22 baseline into the governance docs, and ship bundle parity plus dry-run release safeguards so Drupal 11 users and npm consumers remain supported

• v3.0.2 - Update core package dependency to use the latest version

• v3.0.1 - Remove --save-dev flag from readme instructions

• v3.0.0 - Use explicit labelling instead of implicit labelling for control inputs. Remove margin-top for control input block that is not followed by another control input block. Removed unused Fragment React import

• v2.2.2 - Fixed radio input underlapping svg on small inputs

• v2.2.1 - Removed uikit references

• v2.2.0 - Changed focus appearance on radio buttons to be round

• v2.1.7 - Replace checked attribute with defaultChecked on control inputs examples

• v2.1.6 - Update dependencies

• v2.1.5 - Removing web pack dev server, updating dependencies

• v2.1.4 - Fixed build scripts for Windows

• v2.1.3 - Replace node-sass with sass

• v2.1.2 - Change npm run watch browser-sync location

• v2.1.1 - Update dependencies

• v2.1.0 - Adjust spacing, size and lineheight and fixed errors

• v2.0.3 - Change homepage link

• v2.0.2 - Adding focus offset back to control inputs

• v2.0.1 - Fix dependencies

• v2.0.0 - Change to focus colour and border/muted color mix

• v1.0.0 - Moved to AU namespace, added new color themes and spacing

• v0.3.0 - Added pancake-react plugin, ES5 main file

• v0.2.0 - Added react component

• v0.1.1 - Fixed webkit render bug

• v0.1.0 - 💥 Initial version

⬆ back to top

License

Copyright (c) Commonwealth of Australia. Licensed under MIT.

⬆ back to top

};