Project

attribute_pair_generator

0.0
No commit activity in last 3 years
No release in over 3 years
attribute_pair_generatorlivingsocial/attribute-pair-generatorHomepageDocumentationSource CodeBug TrackerWiki
Easily generate form fields and object information fields with labels.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
7,642
Stars
1
Forks
1
Watchers
43
 Releases
Current version
1.1.0
Total releases
2
First release
2013-11-27
Latest release
2014-07-24
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
0
Merged Pull Requests
1
Pull Request Acceptance Rate
100%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2014-01-26
Reverse Dependencies
0

 Dependencies

Development

faker
>= 0
nokogiri
~> 1.6
rake
>= 0
rspec
~> 2.0

Runtime

actionpack
>= 3.0.0
 Project Readme

Attribute Pair Generator

  • Easily generate form fields and object information fields with labels.
  • Maintain consistent form structure without lots of html overhead:

Using APG, this...

<% apg = AttributePairGenerator.new(foo) %>
<%= form_tag foo_path(foo.id), method: :put do -%>
  <dl>
    <%= apg.text_field(attr: :title, help: "the title of your foo") %>
    <%= apg.date(attr: :starts_at) %>
    <%= apg.plain_text(attr: :status) %>
  </dl>
<% end %>

generates...

<form accept-charset="UTF-8" action="/foo" method="post">
  <dl>
    <dt>
      <label for"title">title</label>
    </dt>
    <dd>
      <input id="title" name="title" type="text" value="bar">
      <span class="help-inline">the title of your foo</span>
    </dd>
    <dt>
      <label for"starts_at">starts at</label>
    </dt>
    <dd>
      <input class="datepicker" id="starts_at" name="starts_at" type="text" value="2013-10-30 05:00:00 +0000">
      <span class="help-inline"></span>
    </dd>
    <dt>
      <label for"status">status</label>
    </dt>
    <dd>
      approved
      <span class="help-inline"></span>
    </dd>
  </dl>
</form>

Installation

Add this line to your application's Gemfile:

gem 'attribute_pair_generator'

And then execute:

$ bundle

Or install it yourself as:

$ gem install attribute_pair_generator

Common Usage

Call any of the apg methods, and pass in a hash of options, common options include:

  • attr: using this option alone, you get the label to be a humanized version of the attr, and the value to be the attr called on the initialized object (if it exists)
  • label: override the label
  • value: override the value
  • help: help text shown after the value
  • field_options: pass in options to the content_tag for the main desired element (e.g. tag, input, textarea, checkbox)
  • dd_options: pass in options to the content_tag for the dd (value)
  • prefix: give a prefix to input elements' names and values
  • disabled: disable the input element or link

Examples

link

apg.link(title: "foo", url: "http://example.com")

plain text

apg.plain_text(label: 'contract dates', value: date_field_range('contract', 'contract'))

date (can be used with jqueryui datepicker)

apg.date(attr: :starts_at)

select dropdown

apg.select(attr: :lead_editor, value: editor_id, collection: [["Tom", 0], ["Dick", 1], ["Harry", 2]])

checkbox

apg.checkbox(attr: :ops_complete, disabled: !can_mark_ops_complete?)

text field

apg.text_field(attr: :long_title)
apg.text_field(prefix: 'tax', attr: :id, value: '', disabled: true)

text area

apg.text_area(attr: :email_addresses, value: email_addresses.join("\n"), help: "Email addresses. One per line")

radio buttons

apg.radio(attr: :review_source, collection: [[nil, 'none'], 'Review Site'], dd_options: {class: 'horizontal-layout'})

Authors

License

Attribute Pair Generator is released under the MIT License.