README.md

@gov.au/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

yarn add @gov.au/control-input

npm install @gov.au/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://auds.service.gov.au/packages/control-input/tests/site/

⬆ back to top

---

Release History

• 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

};