Form Elements




File Upload

File Upload


Custom


The id for the File Upload and the existing input you are choosing to wrap with our Kit with must match each other. This will ensure that the click on the button a.k.a, the underlying label's for, triggers the File Upload.

Error


Toggle

Default State



Disabled



Name and Value

Which of the following vehicles do you own?


Car

Bike

Custom checkbox input


Custom radio inputs

Select one option:


Walk

Bike

Ride

Toggle w/ Options


Form Pill

Form Pill User

Anna Black

Anna Black



Anna Black


Form Pill Size

Anna Black

Anna Black



Anna Black


Truncated Text

Form Pill Truncation
Princess Amelia Mignonette Grimaldi Thermopolis Renaldo

Princess Amelia Mignonette Grimaldi Thermopolis Renaldo

icon and a very long tag to show truncation

form pill long tag no tooltip show truncation


For Form Pills with longer text, the truncate global prop can be used to truncate the label within each Form Pill. See here for more information on the truncate global prop.

NOTE: For Rails Form Pills (not ones embedded within a React-rendered Typeahead or MultiLevelSelect), a unique id is required to enable the Tooltip functionality displaying the text or tag section of the Form Pill.

Wrapped Text

Form Pill Wrapped Text
Princess Amelia Mignonette Grimaldi Thermopolis Renaldo

Princess Amelia Mignonette Grimaldi Thermopolis Renaldo

icon and a very long tag to show wrapped text

form pill long tag no tooltip show wrapped text


For Form Pills with longer text, the wrapped prop can be used to wrap the label within each Form Pill.

Note: Avoid using the wrapped and small props together, as their styles conflict and may cause functionality issues.

Form Pill Tag

this is a tag


Example

THIS IS A TAG


By default textTransform = "none". If there is a need to enforce lowercase, please pass the textTransform = "lowercase prop.

Form Pill Icon

icon and tag


Form Pill Colors

Status Colors

Primary

Neutral

Success

Warning

Error

Info

Data Colors

Data 1

Data 2

Data 3

Data 4

Data 5

Data 6

Data 7

Data 8

Product Colors

Windows

Siding

Roofing

Doors

Gutters

Solar

Insulation

Accessories


The Status, Data, and Product colors highlighted above can be passed to the color prop. Primary is the default color. Form pills with a text tag, an avatar, or an icon with text tag can all receive the color prop.

Form

Default


Default + Validation


Validation displays an error with red border and red text below indicating that the user must fill out the field.

Default + Loading


Pressing Submit will trigger a loading state where the button content is replaced by a spinner icon and the submit button will be disabled.

With Optional Required Indicator


The required_indicator prop adds a red asterisk (*) to the input label, visually marking the field as required. This works with both label: true for auto-generated labels and label: "Custom Text" for custom labels.

While it's typically used alongside the required prop for HTML5 validation, you can use required_indicator independently if you're handling validation differently (e.g., client-side or backend validation).

Form Group

Default


Button




Full Width




Full Width is a prop that can be added to any of the Form Group options. This prop allows the Form Group to stretch the full width of the div.

Date Picker


Select


Selectable Card


Selectable Card Icon