king_views 1.0.4 → 1.0.5

data/CHANGELOG.rdoc

@@ -0,0 +1,8 @@
+= King Views Changelog
+
+2010.08.31
+
+* dropped support for KingList table cell alignment option, so instead of t.column :name, align=>:right go for :class=>:right and 'right' will be set as class on both th and td
+* more KingList documentation
+
+.. older read git commit messages

data/VERSION

@@ -1 +1 @@
-1.0.4
+1.0.5

data/king_list/README.rdoc

@@ -1,16 +1,25 @@
 = KingList
 
-King List provides helpers to be used in table listings and detail views.
-It has function for action icons, buttons, actions links and icons with hidden
-forms used to simulate PUT or DELETE requests
+King List provides helpers for table listings and detail views.
+It has function to create list(ul) with action icons(li+hidden a), buttons,
+actions links(li+a) and icons with hidden forms used to simulate PUT or DELETE
+requests.
+All of those output ul->li->a structure with some css classes, so they need to be
+formated via css (Examples follow, see salesking.eu for now).
 
-== Example
+You also get automatic lookup of translations (I18n) for active record objects and
+their fields.
+
+== Examples
 Please read the files in lib/  for further documentation and examples
 
-A tabled view
-  - table_for(@object) do
+Build a table for an array of AR objects
+  - table_for(@ar_objects) do |t, obj|
     = t.column :firstname
     = t.column :lastname, :sorting=>false
+    = t.column :number, :link=>true # links content to the object
+    = t.column :email, :value=>"custom content #{obj.email}", :title=>'custom th'
+    = t.column :created_at, :class=>'rgt', :sort_fields=>'users.updated_at,users.created_at'
 
 A definition list view
   - dl_for current_object do |f|
@@ -18,4 +27,11 @@ A definition list view
     = f.show :created_at
     = f.show :updated_at
 
+== Dependencies
+
+* haml
+* activerecord
+* I18n
+* king_format(included in this gem)
+
 Copyright (c) 2009 Georg Leciejewski, released under the MIT license

data/king_list/lib/king_list/builder/table.rb

@@ -21,7 +21,7 @@ module KingList
       # options<Hash{Hash, Symbol=>String}>:: A bunch of options to customize the th, td or content of the column
       #
       # ==== Options hash:
-      #   :object   => The record to use. If not set the current_object is used
+      #   :object   => The record to use. If not set, the current_object is used
       #   :value    => cell content (if not set, it will be determined by calling field_name on object/current_record) => @client.name
       #   :link     => if set, the value is wrapped in a link_to with the given link (if TRUE, the current object is used)
       #   :row_link => if set, the value is wrapped in a link_to with the given link (if TRUE, the current object is used)
@@ -32,7 +32,7 @@ module KingList
       #       :class:: the class to set on the th
       #   :td_options{Symbol=>String}:: options for the <td>
       #     :class:: the class to set on the th
-      #   :align    => classes used for alignment. Values are :left or :right
+      #   :class    => class as Symbol or String used on TH and TD used f.ex. for alignment.
       def column(field_name, options = {})
         options = options.deep_clone # for not changing outer variable
         th_options = options[:th_options] || {}
@@ -41,10 +41,11 @@ module KingList
         # Use given object from options (or current_record as default)
         object = options.has_key?(:object) ? options.delete(:object) : current_record
 
-        # Cell alignment
-        align = options.delete(:align)
-        (th_options[:class] ||= '') << " #{align}" if align == :right
-        (td_options[:class] ||= '') << " #{align}" if align == :right
+        # :class given so add to TH and TD f.ex cell alignment :class=>'rgt'
+        if css_class = options.delete(:class)
+          (th_options[:class] ||= '') << " #{css_class}"
+          (td_options[:class] ||= '') << " #{css_class}"
+        end
 
         self.current_column_number += 1
 
@@ -77,37 +78,29 @@ module KingList
               # otherwise just plain text (no sorting link)
               title = title_text
             end
-            #mark the first and last columns with css classes
+            # mark the first and last columns with css classes
             if self.current_column_number == 1
               (th_options[:class] ||= '') << ' first'
             elsif self.current_column_number == self.number_of_columns
-              (th_options[:class] ||= '') <<  ' last'
+              (th_options[:class] ||= '') << ' last'
             end
            @template.capture_haml do
             @template.haml_tag(:th, title.to_s, th_options)
-          end
-            
+          end            
 
           when :content
             # Use given value (or formatted value as default)
             value = options.delete(:value) || @template.formatted_value(object, field_name, value)
 
             # If link option is set, then link to this
-            #
-            # ===Example
-            #
+            # === Example            #
             # :link => true : uses current object show link
-            #
             # :link => nil or blank no linking
-            #
             if link = options.delete(:link)
-              #link to current_oject if true given
+              # link to current_oject if true given
               link = object if link == true
-              if (!value.blank?) && (!link.blank?) #link and linked text is present
-                value = @template.link_to(value, link)
-              else #leave col text empty
-                value = ''
-              end
+              # link and linked text is present else leave col text empty
+              value = (!value.blank? && !link.blank?) ? @template.link_to(value, link) : ''
             end
 
             # If row_link option is set, then link to the current object
@@ -122,7 +115,6 @@ module KingList
           @template.capture_haml do
             @template.haml_tag(:td, value.to_s, td_options)
           end
-#          @template.haml_concat
         end # case mode
       end
 

data/king_list/lib/king_list/list_helper.rb

@@ -43,7 +43,7 @@ module KingList
     # generates a fieldset with optional legend
     #
     # === Example haml
-    #  - section :caption => _('legend.user.details'), :class => 'my_css_class' do
+    #  - section :caption => t('legend.user.details'), :class => 'my_css_class' do
     #    %p= "This is the content"
     #
     # => # <fieldset>

data/king_views.gemspec

@@ -5,18 +5,19 @@
 
 Gem::Specification.new do |s|
   s.name = %q{king_views}
-  s.version = "1.0.4"
+  s.version = "1.0.5"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Georg Leciejewski"]
-  s.date = %q{2010-08-16}
+  s.date = %q{2010-08-31}
   s.description = %q{Clean up your Forms using king_form for dl or labeled forms. Use king_list for an easy markup of tables in your lists and dl-enabled listings in your detail views. }
   s.email = %q{gl@salesking.eu}
   s.extra_rdoc_files = [
     "README.rdoc"
   ]
   s.files = [
-    "MIT-LICENSE",
+    "CHANGELOG.rdoc",
+     "MIT-LICENSE",
      "README.rdoc",
      "Rakefile",
      "VERSION",

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: king_views
 version: !ruby/object:Gem::Version 
-  hash: 31
+  hash: 29
   prerelease: false
   segments: 
   - 1
   - 0
-  - 4
-  version: 1.0.4
+  - 5
+  version: 1.0.5
 platform: ruby
 authors: 
 - Georg Leciejewski
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-08-16 00:00:00 +02:00
+date: 2010-08-31 00:00:00 +02:00
 default_executable: 
 dependencies: []
 
@@ -28,6 +28,7 @@ extensions: []
 extra_rdoc_files: 
 - README.rdoc
 files: 
+- CHANGELOG.rdoc
 - MIT-LICENSE
 - README.rdoc
 - Rakefile