/volt-fields

Provides controls for text and textarea fields with built in error reporting and bootstrap formatting

Primary LanguageHTML

Volt::Fields

Provides controls with the following:

  1. the necessary html for bootstrap
  2. mark the fields when the blur event happens
  3. display any marked errors below the field

Currently supported control types:

  • Text
  • Textarea
  • Select
  • Radio
  • Checkbox

How to Use

Setup

Include in your gemfile:

gem 'volt-fields'

Then use fields as tags in your views:

<:fields:text value="{{ model.first_name }}"/>

Text and Textarea

<:fields:text value="{{ model.first_name }}"/>

Select

Select fields accept either an array of options, or an array of {label: '', value: ''} hashes.

<:fields:select value="{{ model.role }}" options="{{ ['User', 'Admin', 'Something Else']}}"/>

Radio

For radio buttons, pass an options array of {label: '', value: ''} hashes.

<:fields:radio value="{{ model.active }}" options="{{[{label: 'Active', value: true},{label:'Inactive', value: false}]}}"/>

For inline radio buttons, use :fields:radio:inline.

Checkbox

For checkboxes, use 'checked' instead of 'value' to bind the checkbox to a boolean field.

<:fields:checkbox checked="{{ model.active }}"/>

For inline radio buttons, use :fields:radio:inline.