unirer-bootstrap 0.2 → 0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9ceb76346c53617fa6906eb86dd6af2e45ea170f
-  data.tar.gz: 1af49fcbdf89e80c75d68a9ab2c1569dd16f85a1
+  metadata.gz: 82031e81a5620437b1b0e87cf61e6cf168eb0cef
+  data.tar.gz: f1e1b5beb7c2c069c790f20a177ef77d0ae5ff4f
 SHA512:
-  metadata.gz: 2aed5e6db75c440852012ecb5dc380a5f0616bd9995a21d00618e5c48a056d04aa09d185a64bd0ba76c38f25add347345837253124161788a45da69e02b7f791
-  data.tar.gz: f85efa36bf26a68831835c07a3d9ece9c2375ea5ce7292a44d7063d9216f43073479c7d2d585654216fa137b12dac9d73531d92866499d175e2e3be154519262
+  metadata.gz: 0ba674ac414a97ede719677691f33b66fe6e3ad903c1c5e19613b8fd747971b9fc32fe2734474e009ee962905e1be5df3377d749e5ab342f3fc2173ba0d12028
+  data.tar.gz: 99cb58e1652bc698d87b711105cc41d1aef2c170339783086ddd5301f7b5928e1576c42cb2f6279ac2d2bd1c50163a83ff36ae1dbbd687f9777daaa34642acdc

data/README.md

@@ -11,10 +11,73 @@ Unirer (统一资源表现)是一系列的资源表现引擎。Bootstrap 资源
 gem 'unirer-bootstrap'
 ```
 
-## Include the Concern in Controllers & Respond the Calls:
+## Render the Pre-defined Partials:
 ```erb
 <%= render partial: 'unirer/bootstrap/meta'   %>
 <%= render partial: 'unirer/bootstrap/script' %>
 <%= render partial: 'unirer/bootstrap/style'  %>
+<%= render partial: 'unirer/bootstrap/form_field', locals: { options: { model: model, form: f, name: :phone_number, type: :telephone_field } } %>
+```
+
+### Render the Meta
+The Meta partial includes the HTML meta tags for Bootstrap.
+```erb
+<%= render partial: 'unirer/bootstrap/meta' %>
+```
+
+The source codes of the Meta partial:
+```html
+<meta charset="UTF-8" />
+<meta name="format-detection" content="telephone=no" />
+<meta name="msapplication-tap-highlight" content="no" />
+<meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1, width=device-width, height=device-height" />
+<meta name="renderer" content="webkit" />
+<meta http-equiv="X-UA-Compatible" content="IE=edge" />
+```
+
+### Render the Script
+The Script partial includes the HTML script tags for jQuery, Bootstrap, and React. All the CDN servers of the JavaScript libraries are optimized for China only.
+```erb
+<%= render partial: 'unirer/bootstrap/script' %>
+```
+
+The source codes of the Script partial:
+```html
+<%= javascript_include_tag '//cdn.bootcss.com/jquery/2.2.0/jquery.min.js'          %>
+<%= javascript_include_tag '//cdn.bootcss.com/bootstrap/3.3.6/js/bootstrap.min.js' %>
+
+<%= javascript_include_tag '//cdn.bootcss.com/moment.js/2.11.1/moment-with-locales.min.js'                         %>
+<%= javascript_include_tag '//cdn.bootcss.com/bootstrap-datetimepicker/4.17.37/js/bootstrap-datetimepicker.min.js' %>
+
+<%= javascript_include_tag '//cdn.bootcss.com/react/0.14.6/react.min.js'     %>
+<%= javascript_include_tag '//cdn.bootcss.com/react/0.14.6/react-dom.min.js' %>
+```
+
+### Render the Style
+The Style partial includes the HTML style tags for Bootstrap and Font Awesome. All the CDN servers of the CSS libraries are optimized for China only.
+```erb
+<%= render partial: 'unirer/bootstrap/style' %>
+```
+
+The source codes of the Style partial:
+```html
+<%= stylesheet_link_tag '//cdn.bootcss.com/bootstrap/3.3.6/css/bootstrap.min.css',       media: 'all' %>
+<%= stylesheet_link_tag '//cdn.bootcss.com/font-awesome/4.5.0/css/font-awesome.min.css', media: 'all' %>
+
+<%= stylesheet_link_tag '//cdn.bootcss.com/bootstrap-datetimepicker/4.17.37/css/bootstrap-datetimepicker.min.css', media: 'all' %>
+```
+
+### Render the Form Field
+The Form Field partial includes the HTML form field tags for Rails Form Builder and Bootstrap.
+```erb
 <%= render partial: 'unirer/bootstrap/form_field', locals: { model: model, form: f, name: :phone_number, type: :tel_field } %>
 ```
+
+The 4 options are required: model, form, name, and type.
+Here are more options:
+- label: the customized label text.
+- label_class: the CSS class for the label tag.
+- field_class: the CSS class for the wrapper of the form control.
+- error_class: the CSS class for the validation error block of this field.
+- prefix: the HTML source codes of input group addon before the form control.
+- suffix: the HTML source codes of input group addon after the form control.

data/app/views/unirer/bootstrap/_form_field.html.erb

@@ -4,6 +4,7 @@
   name  = options[:name]
   type  = options[:type]||:text_field
 
+  label_text  = options[:label]
   label_class = [ 'control-label', options[:label_class]||'col-xs-2' ].flatten.join ' '
   field_class = [ options[:field_class]||'col-xs-10 input-group' ].flatten.join ' '
   error_class = [ options[:error_class]||'col-xs-offset-2 col-xs-10 text-danger' ].flatten.join ' '
@@ -22,7 +23,13 @@
 %>
 
 <div class='form-group'>
-  <%= form.label name, class: label_class %>
+
+  <% if label_text.present? %>
+    <%= form.label name, class: label_class do %><%= label_text %><% end %>
+  <% else %>
+    <%= form.label name, class: label_class %>
+  <% end %>
+
   <div class='<%= field_class %>'>
     <% if prefix.present? %>
       <span class='input-group-addon'><%= prefix %></span>
@@ -34,7 +41,9 @@
       <span class='input-group-addon'><%= suffix %></span>
     <% end %>
   </div>
+
   <% if model.errors[name].present? %>
     <p class='<%= error_class %>'><%= model.errors[name].first %></p>
   <% end %>
+
 </div>

data/lib/unirer/bootstrap/version.rb

@@ -1,5 +1,5 @@
 module Unirer
   module Bootstrap
-    VERSION = '0.2'.freeze
+    VERSION = '0.3'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unirer-bootstrap
 version: !ruby/object:Gem::Version
-  version: '0.2'
+  version: '0.3'
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-01-26 00:00:00.000000000 Z
+date: 2016-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails