0.1.0 • Published 6 years ago

react-form-suffixes-select v0.1.0

Weekly downloads
-
License
MIT
Repository
-
Last release
6 years ago

react-form-suffixes-select

MIT Licence

A React select component that displays name suffixes (II, Sr, PhD) for react forms and fires a callback when a new one is selected.

Installation

yarn add react-form-suffixes-select

- or -

npm install react-form-suffixes-select

Usage

1 . Require react-form-suffixes-select after installation

import SuffixesSelect from "react-form-suffixes-select";

2 . Include react-form-suffixes-select component

onSuffixSelect = (event, prefix) => {
    // event {SyntheticEvent<HTMLSelectElement>} - React HTML event
    // prefix {Object} - Object representing the suffix
    // suffix.label {string} - The display label of the selected suffix
    // suffix.code {string} - The two or three letter abbreviation of the suffix (unique to the collection)
}

<SuffixesSelect onChange={this.onSuffixSelect} />

Parameters

ParameterTypeDescription
onChangefunctionCallback with the selected suffix. Parameters are the HTML event and an object with the format { label: 'Sr', code: 'SR' }
defaultOptionTextstringThe label to display for the default/unselected option. A user selecting this option will not fire the callback. (default: "Suffix")
hasDefaultOptionbooleanToggle the default option on or off (default: true)
styleObjectJavascript object with camelCased CSS properties rather than a CSS string. Standard React styles
classNamestringA CSS class name. The presence of this attribute will override all default styles. So it's all or none

Build

yarn run build
npm run build

Test

yarn run test
npm run test

Lint

yarn run lint
npm run lint

Flow

yarn run flow
npm run flow

License

MIT