# Foundation Rails Helper [](http://travis-ci.org/sgruhier/foundation_rails_helper)
Gem for Rails 4.1+ applications that use the excellent Zurb Foundation framework.
* [Zurb Foundation](https://github.com/zurb/foundation)
* [Zurb Foundation Rails](https://github.com/zurb/foundation-rails)
So far it includes:
* A custom FormBuilder that generates a form using the Foundation framework classes. It replaces the current `form_for`, so there is no need to change your Rails code. Error messages are properly displayed.
* A `display_flash_messages` helper method that uses Zurb Foundation Alerts UI.
#### Compatibility
* Only Rails 4.1/4.2/5 and Foundation 5 are fully supported
* Some features may work with Foundation 4 and older, but results may vary, and markup which exists only for those versions will be gradually removed
* Legacy branches exist for Rails 3 and 4.0 (see the rails3 and rails4.0 branches). These are not actively supported, and fixes are not retroactively applied, but pull requests are welcome.
## Screenshots
### Forms
A classic devise sign up view will look like this:
```erb
<%= form_for(resource, :as => resource_name, :url => registration_path(resource_name)) do |f| %>
<%= f.email_field :email, label: 'E-mail' %>
<%= f.password_field :password %>
<%= f.password_field :password_confirmation %>
<%= f.submit %>
<% end %>
```
<table>
<thead>
<tr>
<th>Form</th>
<th>Form with errors</th>
</tr>
</thead>
<tbody>
<tr>
<td valign='top'>
<img src="https://cloud.githubusercontent.com/assets/1400414/5994195/d9b467ce-aa1e-11e4-914c-f696724b53ed.png"/>
</td>
<td valign='top'>
<img src="https://cloud.githubusercontent.com/assets/1400414/5994196/dbf4bc0a-aa1e-11e4-8c18-b7d3b1b370dc.png"/>
</td>
</tr>
</tbody>
</table>
### Flash messages
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'foundation-rails'
gem 'foundation_rails_helper', '~> 1.2.0'
```
And then execute:
```bash
$ bundle
```
### Flash Messages
To use the built in flash helper, add `<%= display_flash_messages %>` to your layout file (eg. *app/views/layouts/application.html.erb*).
## Usage
### form_for
Form_for wraps the standard rails form_for helper.
```erb
<%= form_for @user do |f| %>
...
<% end %>
```
generates:
```html
<form accept-charset="UTF-8" action="/users" class="new_user" id="new_user" method="post">
...
</form>
```
### text_field and Field Helpers
Field helpers add a label element and an input of the proper type.
```ruby
f.text_field :name
```
generates:
```html
<label for="user_email">Name</label>
<input id="user_name" name="user[name]" type="text">
```
Preventing the generation of labels can be accomplished two ways. To disable on a form element:
```ruby
f.text_field :name, label: false
```
For all form elements, add the option: `auto_labels: false` to the form helper.
Change the label text and add a class on the label:
```ruby
f.text_field :name, label: 'Nombre', label_options: { class: 'large' }
```
If the hint option is specified
```ruby
f.text_field :name, hint: "I'm a text field"
```
an additional span element will be added after the input element:
```html
<span class="hint">I'm a text field</span>
```
### Submit Button
The 'submit' helper wraps the rails helper and sets the class attribute to "small radius success button" by default.
```ruby
f.submit
```
generates:
```html
<input class="small radius success button" name="commit" type="submit" value="Create User">
```
Specify the class option to override the default classes.
### Errors
On error,
```ruby
f.email_field :email
```
generates:
```html
<label class="error" for="user_email">Email</label>
<input class="error" id="user_email" name="user[email]" type="email" value="">
<small class="error">can't be blank</small>
```
The class attribute of the 'small' element will mirror the class attribute of the 'input' element.
If the `html_safe_errors: true` option is specified on a field, then any HTML you may have embedded in a custom error string will be displayed with the html_safe option.
### Prefix and Postfix
Simple prefix and postfix span elements can be added beside inputs.
```ruby
f.text_field :name, prefix { value: 'foo', small: 2, large: 3 }
```
generates
```html
<div class="row collapse">
<div class="small-2 large-3 columns">
<span class="prefix">foo</span>
</div>
<div class="small-10 large-9 columns">
<input type="text" name="user[name]" id="user_name">
</div>
</div>
```
## Configuration
Add an initializer file to your Rails app: *config/initializers/foundation_rails_helper.rb*
containing the following block:
```ruby
FoundationRailsHelper.configure do |config|
# your options here
end
```
Currently supported options:
### Submit Button Class
To use a different class for the [submit button](https://github.com/sgruhier/foundation_rails_helper#submit-button) used in `form_for`, add a config named **button_class**:
```ruby
# Default: 'small radius success button'
config.button_class = 'large secondary button'
```
Please note, the button class can still be overridden by an options hash.
### Ignored Flash Keys
The flash helper assumes all flash entries are user-viewable messages.
To exclude flash entries which are used for storing state
(e.g. [Devise's `:timedout` flash](https://github.com/plataformatec/devise/issues/1777))
you can specify a blacklist of keys to ignore with the **ignored_flash_keys** config option:
```ruby
# Default: []
config.ignored_flash_keys = [:timedout]
```
## Contributing
See the [CONTRIBUTING](CONTRIBUTING.md) file.
## Copyright
Sébastien Gruhier (http://xilinus.com, http://v2.maptimize.com) - MIT LICENSE - 2015
[](https://bitdeli.com/free "Bitdeli Badge")