Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A buch of helpers to clean up your haml views and forms.
Ruby
tree: 015c3b424c

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
king_form
king_format
king_list
lib
spec
.gitignore
CHANGELOG.rdoc
Gemfile
MIT-LICENSE
README.rdoc
Rakefile
VERSION
king_views.gemspec

README.rdoc

KingViews

KingViews where extracted from SalesKing(www.SalesKing.eu) and consist of three different view helpers, KingForm( dl or labeled forms, enhanced inputs ), KingList( dl, tables ) and KingFormat( date, money, percent )

This stuff is not tested with rails 3.0 and testing is still stuck in SalesKing .. leaving space for forks.

Install

You must use HAML for your views .. the cure for erb eye cancer

gem install king_views

KingForm

Clean up your forms with helpers in rails haml views, with support for:

  • dl or labeled forms

  • shorter syntax for inputs

  • fieldset support (section)

  • labels auto translated when present in I18n or Gettext

  • info-text for auto translated info after each input

  • bundle a couple of inputs under one label or dt incl. css class based counter for the wrapper

  • based on rails action view helpers so all parameters are passed through(nearly all) to the original versions

Also see README in KingForm: github.com/salesking/king_views/tree/master/king_form/

Example

- dl_form_for @payment, :url => 'a path', :html => { :method => :post } do |f|
  -f.section do
    = f.hidden :lock_version
    = f.text :amount, :class => 'required', :value=> 'a custom val'
    = f.date :date, :title => t(:'from'), :info=>'Help me'
    = f.selection :payment_method
    - f.bundle 'status' do
      = f.radio :new_status, :closed, :checked=>true
      %span=t(:'status.closed')
      = f.radio :new_status, :open
      %span= t(:'activerecord.attributes.document.enum.status.open')
  -f.actions do
    = f.submit t(:'form.save')
    = secondary_link_to t(:'link.cancel'), parent_path

KingList

Use KingList for an easy markup inside your lists and detail views. Its not as extensive as KingForm and only provides the following:

  • easy to use tables for listings

  • dl-helper for detail views

  • action_icons & action_buttons(forms) for css enabled icon markup

Also see README in KingList: github.com/salesking/king_views/tree/master/king_list/

Quick Example

# Definition list for detail views
- dl_for @invoice do |f|
  = f.show :number
  = f.show :date # auto-formated date field see KingFormat
  = f.show :total # auto-formated money field see KingFormat

# table with header-klick sorting disabled and icons in first column
- table_for(@payments,{:sorting => false} ) do |t, payment|
  - t.action_column do
    = action_icon :edit, edit_payment_path(payment)
    = action_button 'delete', {:url=> 'some-path', :title => t(:'link.delete'), :method => :delete, :class=>'delete'}
  = t.column :date
  = t.column :amount, :td_options => {opt=>val}

KingFormat

Provides a semi-automatic formatting of date, money, percent fields. The field types are defined inside each model. And the view helpers will show a nice output.

Also see README github.com/salesking/king_views/tree/master/king_format/

Example:

#define date fields you model definition
class Invoice < ActiveRecord::Base
  has_date_fields :date, :valid_until
  has_money_fields :total, :price
end
# see above for usage in views

License

Copyright © 2009,2010 Georg Leciejewski, released under the MIT-LICENSE

Something went wrong with that request. Please try again.