https://github.com/salesking/king_views

A buch of helpers to clean up your haml views and forms.
https://github.com/salesking/king_views

Last synced: about 2 months ago
JSON representation

A buch of helpers to clean up your haml views and forms.

• Host: GitHub
• URL: https://github.com/salesking/king_views
• Owner: salesking
• License: mit
• Created: 2010-04-15T23:15:07.000Z (over 14 years ago)
• Default Branch: master
• Last Pushed: 2015-12-03T13:19:07.000Z (about 9 years ago)
• Last Synced: 2024-10-04T08:37:28.593Z (3 months ago)
• Language: Ruby
• Homepage: https://www.salesking.eu
• Size: 252 KB
• Stars: 3
• Watchers: 3
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.rdoc
  • Changelog: CHANGELOG.rdoc
  • License: MIT-LICENSE

Awesome Lists containing this project

README

        
= KingViews

KingViews where extracted from SalesKing(https://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: http://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: http://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 http://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 (c) 2009,2010 Georg Leciejewski, released under the MIT-LICENSE