https://github.com/airblade/air_budd_form_builder
[Deprecated] A form builder that generates semantic HTML as advocated by Andy Budd in CSS Mastery.
https://github.com/airblade/air_budd_form_builder
Last synced: 5 months ago
JSON representation
[Deprecated] A form builder that generates semantic HTML as advocated by Andy Budd in CSS Mastery.
- Host: GitHub
- URL: https://github.com/airblade/air_budd_form_builder
- Owner: airblade
- License: mit
- Created: 2008-09-29T17:18:23.000Z (about 17 years ago)
- Default Branch: master
- Last Pushed: 2011-02-02T11:10:29.000Z (over 14 years ago)
- Last Synced: 2025-04-30T18:09:10.629Z (5 months ago)
- Language: Ruby
- Homepage:
- Size: 217 KB
- Stars: 34
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.markdown
- License: MIT-LICENSE
Awesome Lists containing this project
README
AirBuddFormBuilder
==================
*Please note I am no longer working on this. It did the job admirably for a long time, but I now use [Simple Form](https://github.com/plataformatec/simple_form) instead.*
A form builder that generates semantic HTML as advocated by Andy Budd in [CSS Mastery][1].
It generates [Wufoo-style][2] buttons and links for submitting the form, cancelling it, etc. These buttons and links use several icons from the [FAMFAMFAM set][3]. You can choose not to use them if you don't want to.
[1]: http://www.cssmastery.com
[2]: http://particletree.com/features/rediscovering-the-button-element/
[3]: http://famfamfam.com/lab/icons/silk/
Please send feedback to boss@airbladesoftware.com.
HAML
====
Thanks to [David Baldwin][4], this form builder can be used with HAML.
[4]: http://www.baldwindigital.net
ERB Example
===========
app/views/projects/new.html.erb:
<% airbudd_form_for @project do |f| %>
<%= f.text_field :title, :required => true, :label => "Article's Title" %>
<% f.buttons do |b| %>
<%= b.save %>
<%= b.cancel :url => projects_path %>
<% end %>
<% end %>
This renders:
Article's Title:
(required)
And if the field's value is invalid:
Article's Title:
(required)
can't be blank
See Mr Budd's good book for discussion of the HTML and the CSS to go with it.
Required fields
===============
Thanks to Bill, the form builder automatically detects required fields (by looking for :validates_presence_of in the model) and marks them up appropriately.
Configuration
=============
Thanks to Dan Webb, whose [Enhanced Form Builder](http://svn.danwebb.net/external/rails/plugins/enhanced_form_builder/lib/enhanced_form_builder/form_builder.rb) configuration I borrowed.
You can configure the form builder at three levels: app-wide, per-form, and per-field. The per-field configuration differs slightly from the other two.
* App-wide:
config/initializers/form_builder.rb:
AirBlade::AirBudd::FormBuilder.default_options.merge!({
:required_signifier => '*',
:label_suffix => '',
})
* Per form:
In your form:
- airbudd_form_for @member do |f|
- f.required_signifier = '*'
= f.text_field :name
* Per field:
On a form field:
= f.text_field :name, :required => true, :suffix => ''
See the comments in the form builder's code for the exact configuration options available.
To Do
=====
* Incorporate cxpartners' excellent [Web forms design guidelines](http://www.cxpartners.co.uk/thoughts/web_forms_design_guidelines_an_eyetracking_study.htm).
* Fix `country_select` so it handles priority countries and options. It's currently broken.
* Wrapper for `options_group_from_collection_for_select`.
* DRY way to show consistent form links, e.g. edit, outside a form.
- include `link_to_function`, `link_to_remote`, etc.
- Cf `AirBlade::AirBudd::FormHelper#link_to_form`.
- Do we need to wrap buttons/links in a div? (Probably semantically good to do so?)
* Two read-only field helpers: one for within a form, containing the value so it can be submitted, and one for the 'show' page, so we can use the same markup and CSS (c.f. http://tomayko.com/writings/administrative-debris)..
* Example CSS:
- for Wufoo-style buttons and links.
- for CSS Mastery XHTML.
* Summary error messages.
* Consider how to handle multiple actions, e.g. 'save & create another', 'save & keep editing'. See Brandon Keepers's [with_action plugin](http://opensoul.org/2007/7/16/handling-forms-with-multiple-buttons).
Copyright (c) 2007 Andrew Stewart, released under the MIT license.
Save
Cancel