lib/uberkit/form.rb lib/uberkit/forms/builder.rb lib/uberkit/forms/helper.rb @@ -16,6 +16,78 @@ To install it as a plugin (Rails 2.1 or later): script/plugin install git://github.com/mbleigh/uberkit.git +UberForms +--------- + +UberForms provide a simple context for building forms in a DRYer +manner by abstracting the markup into a simple, CSS-styleable +format. It is available as a form builder as Uberkit::Forms::Builder, +but is likely more useful when used in one of the helper forms: +uberform_for or remote_uberform_for. + +=== Basic Example + +<% uberform_for :user do |f| %> + <%= f.text_field :login %> + <%= f.password_field :password %> + <%= f.submit "Submit"%> +<% end %> + +Becomes... + +<form method="post" class="uberform" action="/users"> + <div class="field_row"> + <label for="user_login">Login:</label> + <input type="text" size="30" name="user[login]" id="user_login" class="text_field"/> + <br/> + </div> + <div class="field_row"> + <label for="user_password">Password:</label> + <input type="password" size="30" name="user[password]" id="user_password" class="password_field"/> + <br/> + </div> + <button type="submit">Submit</button> +</form> + +=== Labels, Help, and Descriptions + +You can pass options into a given field to set a custom label, +some help text, or a description of the field. + +<%= f.text_field :login, :label => "Username", + :help => "Only a-z and underscores.", + :description => "The name you will use to log in." %> + +Becomes... + +<div class="field_row"> + <label for="user_login">Username:</label> + <input type="text" size="30" name="user[login]" label="Username" id="user_login" help="Only a-z and underscores." description="The name you will use to log in." class="text_field"/> + <span class="help">Only a-z and underscores.</span> + <span class="description">The name you will use to log in.</span> + <br/> +</div> + +=== Custom Fields + +Maybe the built-in form helpers won't do it for you. In that case, you +can use the custom helper to insert arbitrary HTML that still plays +nice with the rest of UberForms: + +<% f.custom :label => "State", :for => "user_state" do |f| %> + <%= state_select :user, :state %> +<% end %> + +Becomes... + +<div class="field_row"> + <label for="user_state">State:</label> + <div class="pseudo_field"> + <select id="user_state">...</select> + </div> + <br/> +</div> + UberMenu -------- README @@ -1,2 +1,3 @@ require 'uberkit/displayer' -require 'uberkit/menu' \ No newline at end of file +require 'uberkit/menu' +require 'uberkit/form' \ No newline at end of file lib/uberkit.rb @@ -1,11 +1,11 @@ Gem::Specification.new do |s| s.name = "uberkit" - s.version = "0.0.1" - s.date = "2008-07-07" + s.version = "0.0.2" + s.date = "2008-07-14" s.summary = "A Rails plugin for a common set of UI tools and helpers for building interfaces." s.email = "michael@intridea.com" s.homepage = "http://www.actsascommunity.com/projects/uberkit" - s.description = "UberKit is a set of tools for common UI problems in Rails including menus." + s.description = "UberKit is a set of tools for common UI problems in Rails including menus and forms." s.has_rdoc = false s.authors = ["Michael Bleigh"] s.files = [ "MIT-LICENSE", uberkit.gemspec 7894d8aa1f5a74cced5e2ecd9abf2b3fff08f8e0 Michael Bleigh michael@intridea.com http://github.com/ajsharp/uberkit/commit/c219287abaab27727a995d82106764a982a705ca c219287abaab27727a995d82106764a982a705ca 2008-07-14T12:20:26-07:00 2008-07-14T12:20:26-07:00 Added UberForms to the Uberkit. c3ba08525c99bd14b6a54645aa513e251326ec17 Michael Bleigh michael@intridea.com