halorgium-actionpack 3.0.pre
Sign up to get free protection for your applications and to get access to all the features.
- data/CHANGELOG +5179 -0
- data/MIT-LICENSE +21 -0
- data/README +409 -0
- data/lib/abstract_controller.rb +16 -0
- data/lib/abstract_controller/base.rb +158 -0
- data/lib/abstract_controller/callbacks.rb +113 -0
- data/lib/abstract_controller/exceptions.rb +12 -0
- data/lib/abstract_controller/helpers.rb +151 -0
- data/lib/abstract_controller/layouts.rb +250 -0
- data/lib/abstract_controller/localized_cache.rb +49 -0
- data/lib/abstract_controller/logger.rb +61 -0
- data/lib/abstract_controller/rendering_controller.rb +188 -0
- data/lib/action_controller.rb +72 -0
- data/lib/action_controller/base.rb +168 -0
- data/lib/action_controller/caching.rb +80 -0
- data/lib/action_controller/caching/actions.rb +163 -0
- data/lib/action_controller/caching/fragments.rb +116 -0
- data/lib/action_controller/caching/pages.rb +154 -0
- data/lib/action_controller/caching/sweeping.rb +97 -0
- data/lib/action_controller/deprecated.rb +4 -0
- data/lib/action_controller/deprecated/integration_test.rb +2 -0
- data/lib/action_controller/deprecated/performance_test.rb +1 -0
- data/lib/action_controller/dispatch/dispatcher.rb +57 -0
- data/lib/action_controller/metal.rb +129 -0
- data/lib/action_controller/metal/benchmarking.rb +73 -0
- data/lib/action_controller/metal/compatibility.rb +145 -0
- data/lib/action_controller/metal/conditional_get.rb +86 -0
- data/lib/action_controller/metal/configuration.rb +28 -0
- data/lib/action_controller/metal/cookies.rb +105 -0
- data/lib/action_controller/metal/exceptions.rb +55 -0
- data/lib/action_controller/metal/filter_parameter_logging.rb +77 -0
- data/lib/action_controller/metal/flash.rb +162 -0
- data/lib/action_controller/metal/head.rb +27 -0
- data/lib/action_controller/metal/helpers.rb +115 -0
- data/lib/action_controller/metal/hide_actions.rb +47 -0
- data/lib/action_controller/metal/http_authentication.rb +312 -0
- data/lib/action_controller/metal/layouts.rb +171 -0
- data/lib/action_controller/metal/mime_responds.rb +317 -0
- data/lib/action_controller/metal/rack_convenience.rb +27 -0
- data/lib/action_controller/metal/redirector.rb +22 -0
- data/lib/action_controller/metal/render_options.rb +103 -0
- data/lib/action_controller/metal/rendering_controller.rb +57 -0
- data/lib/action_controller/metal/request_forgery_protection.rb +108 -0
- data/lib/action_controller/metal/rescuable.rb +13 -0
- data/lib/action_controller/metal/responder.rb +200 -0
- data/lib/action_controller/metal/session.rb +15 -0
- data/lib/action_controller/metal/session_management.rb +45 -0
- data/lib/action_controller/metal/streaming.rb +188 -0
- data/lib/action_controller/metal/testing.rb +39 -0
- data/lib/action_controller/metal/url_for.rb +41 -0
- data/lib/action_controller/metal/verification.rb +130 -0
- data/lib/action_controller/middleware.rb +38 -0
- data/lib/action_controller/notifications.rb +10 -0
- data/lib/action_controller/polymorphic_routes.rb +183 -0
- data/lib/action_controller/record_identifier.rb +91 -0
- data/lib/action_controller/testing/process.rb +111 -0
- data/lib/action_controller/testing/test_case.rb +345 -0
- data/lib/action_controller/translation.rb +13 -0
- data/lib/action_controller/url_rewriter.rb +204 -0
- data/lib/action_controller/vendor/html-scanner.rb +16 -0
- data/lib/action_controller/vendor/html-scanner/html/document.rb +68 -0
- data/lib/action_controller/vendor/html-scanner/html/node.rb +537 -0
- data/lib/action_controller/vendor/html-scanner/html/sanitizer.rb +176 -0
- data/lib/action_controller/vendor/html-scanner/html/selector.rb +828 -0
- data/lib/action_controller/vendor/html-scanner/html/tokenizer.rb +105 -0
- data/lib/action_controller/vendor/html-scanner/html/version.rb +11 -0
- data/lib/action_dispatch.rb +70 -0
- data/lib/action_dispatch/http/headers.rb +33 -0
- data/lib/action_dispatch/http/mime_type.rb +231 -0
- data/lib/action_dispatch/http/mime_types.rb +23 -0
- data/lib/action_dispatch/http/request.rb +539 -0
- data/lib/action_dispatch/http/response.rb +290 -0
- data/lib/action_dispatch/http/status_codes.rb +42 -0
- data/lib/action_dispatch/http/utils.rb +20 -0
- data/lib/action_dispatch/middleware/callbacks.rb +50 -0
- data/lib/action_dispatch/middleware/params_parser.rb +79 -0
- data/lib/action_dispatch/middleware/rescue.rb +26 -0
- data/lib/action_dispatch/middleware/session/abstract_store.rb +208 -0
- data/lib/action_dispatch/middleware/session/cookie_store.rb +235 -0
- data/lib/action_dispatch/middleware/session/mem_cache_store.rb +47 -0
- data/lib/action_dispatch/middleware/show_exceptions.rb +143 -0
- data/lib/action_dispatch/middleware/stack.rb +116 -0
- data/lib/action_dispatch/middleware/static.rb +44 -0
- data/lib/action_dispatch/middleware/string_coercion.rb +29 -0
- data/lib/action_dispatch/middleware/templates/rescues/_request_and_response.erb +24 -0
- data/lib/action_dispatch/middleware/templates/rescues/_trace.erb +26 -0
- data/lib/action_dispatch/middleware/templates/rescues/diagnostics.erb +10 -0
- data/lib/action_dispatch/middleware/templates/rescues/layout.erb +29 -0
- data/lib/action_dispatch/middleware/templates/rescues/missing_template.erb +2 -0
- data/lib/action_dispatch/middleware/templates/rescues/routing_error.erb +10 -0
- data/lib/action_dispatch/middleware/templates/rescues/template_error.erb +21 -0
- data/lib/action_dispatch/middleware/templates/rescues/unknown_action.erb +2 -0
- data/lib/action_dispatch/routing.rb +381 -0
- data/lib/action_dispatch/routing/deprecated_mapper.rb +878 -0
- data/lib/action_dispatch/routing/mapper.rb +327 -0
- data/lib/action_dispatch/routing/route.rb +49 -0
- data/lib/action_dispatch/routing/route_set.rb +497 -0
- data/lib/action_dispatch/testing/assertions.rb +8 -0
- data/lib/action_dispatch/testing/assertions/dom.rb +35 -0
- data/lib/action_dispatch/testing/assertions/model.rb +19 -0
- data/lib/action_dispatch/testing/assertions/response.rb +145 -0
- data/lib/action_dispatch/testing/assertions/routing.rb +144 -0
- data/lib/action_dispatch/testing/assertions/selector.rb +639 -0
- data/lib/action_dispatch/testing/assertions/tag.rb +123 -0
- data/lib/action_dispatch/testing/integration.rb +504 -0
- data/lib/action_dispatch/testing/performance_test.rb +15 -0
- data/lib/action_dispatch/testing/test_request.rb +83 -0
- data/lib/action_dispatch/testing/test_response.rb +131 -0
- data/lib/action_pack.rb +24 -0
- data/lib/action_pack/version.rb +9 -0
- data/lib/action_view.rb +58 -0
- data/lib/action_view/base.rb +308 -0
- data/lib/action_view/context.rb +44 -0
- data/lib/action_view/erb/util.rb +48 -0
- data/lib/action_view/helpers.rb +62 -0
- data/lib/action_view/helpers/active_model_helper.rb +306 -0
- data/lib/action_view/helpers/ajax_helper.rb +68 -0
- data/lib/action_view/helpers/asset_tag_helper.rb +830 -0
- data/lib/action_view/helpers/atom_feed_helper.rb +198 -0
- data/lib/action_view/helpers/cache_helper.rb +39 -0
- data/lib/action_view/helpers/capture_helper.rb +168 -0
- data/lib/action_view/helpers/date_helper.rb +988 -0
- data/lib/action_view/helpers/debug_helper.rb +38 -0
- data/lib/action_view/helpers/form_helper.rb +1102 -0
- data/lib/action_view/helpers/form_options_helper.rb +600 -0
- data/lib/action_view/helpers/form_tag_helper.rb +495 -0
- data/lib/action_view/helpers/javascript_helper.rb +208 -0
- data/lib/action_view/helpers/number_helper.rb +311 -0
- data/lib/action_view/helpers/prototype_helper.rb +1309 -0
- data/lib/action_view/helpers/raw_output_helper.rb +9 -0
- data/lib/action_view/helpers/record_identification_helper.rb +20 -0
- data/lib/action_view/helpers/record_tag_helper.rb +58 -0
- data/lib/action_view/helpers/sanitize_helper.rb +259 -0
- data/lib/action_view/helpers/scriptaculous_helper.rb +226 -0
- data/lib/action_view/helpers/tag_helper.rb +151 -0
- data/lib/action_view/helpers/text_helper.rb +594 -0
- data/lib/action_view/helpers/translation_helper.rb +39 -0
- data/lib/action_view/helpers/url_helper.rb +639 -0
- data/lib/action_view/locale/en.yml +117 -0
- data/lib/action_view/paths.rb +80 -0
- data/lib/action_view/render/partials.rb +342 -0
- data/lib/action_view/render/rendering.rb +134 -0
- data/lib/action_view/safe_buffer.rb +28 -0
- data/lib/action_view/template/error.rb +101 -0
- data/lib/action_view/template/handler.rb +36 -0
- data/lib/action_view/template/handlers.rb +52 -0
- data/lib/action_view/template/handlers/builder.rb +17 -0
- data/lib/action_view/template/handlers/erb.rb +53 -0
- data/lib/action_view/template/handlers/rjs.rb +18 -0
- data/lib/action_view/template/resolver.rb +165 -0
- data/lib/action_view/template/template.rb +131 -0
- data/lib/action_view/template/text.rb +38 -0
- data/lib/action_view/test_case.rb +163 -0
- metadata +236 -0
@@ -0,0 +1,198 @@
|
|
1
|
+
require 'set'
|
2
|
+
|
3
|
+
# Adds easy defaults to writing Atom feeds with the Builder template engine (this does not work on ERb or any other
|
4
|
+
# template languages).
|
5
|
+
module ActionView
|
6
|
+
module Helpers #:nodoc:
|
7
|
+
module AtomFeedHelper
|
8
|
+
# Full usage example:
|
9
|
+
#
|
10
|
+
# config/routes.rb:
|
11
|
+
# ActionController::Routing::Routes.draw do |map|
|
12
|
+
# map.resources :posts
|
13
|
+
# map.root :controller => "posts"
|
14
|
+
# end
|
15
|
+
#
|
16
|
+
# app/controllers/posts_controller.rb:
|
17
|
+
# class PostsController < ApplicationController::Base
|
18
|
+
# # GET /posts.html
|
19
|
+
# # GET /posts.atom
|
20
|
+
# def index
|
21
|
+
# @posts = Post.find(:all)
|
22
|
+
#
|
23
|
+
# respond_to do |format|
|
24
|
+
# format.html
|
25
|
+
# format.atom
|
26
|
+
# end
|
27
|
+
# end
|
28
|
+
# end
|
29
|
+
#
|
30
|
+
# app/views/posts/index.atom.builder:
|
31
|
+
# atom_feed do |feed|
|
32
|
+
# feed.title("My great blog!")
|
33
|
+
# feed.updated(@posts.first.created_at)
|
34
|
+
#
|
35
|
+
# for post in @posts
|
36
|
+
# feed.entry(post) do |entry|
|
37
|
+
# entry.title(post.title)
|
38
|
+
# entry.content(post.body, :type => 'html')
|
39
|
+
#
|
40
|
+
# entry.author do |author|
|
41
|
+
# author.name("DHH")
|
42
|
+
# end
|
43
|
+
# end
|
44
|
+
# end
|
45
|
+
# end
|
46
|
+
#
|
47
|
+
# The options for atom_feed are:
|
48
|
+
#
|
49
|
+
# * <tt>:language</tt>: Defaults to "en-US".
|
50
|
+
# * <tt>:root_url</tt>: The HTML alternative that this feed is doubling for. Defaults to / on the current host.
|
51
|
+
# * <tt>:url</tt>: The URL for this feed. Defaults to the current URL.
|
52
|
+
# * <tt>:id</tt>: The id for this feed. Defaults to "tag:#{request.host},#{options[:schema_date]}:#{request.request_uri.split(".")[0]}"
|
53
|
+
# * <tt>:schema_date</tt>: The date at which the tag scheme for the feed was first used. A good default is the year you
|
54
|
+
# created the feed. See http://feedvalidator.org/docs/error/InvalidTAG.html for more information. If not specified,
|
55
|
+
# 2005 is used (as an "I don't care" value).
|
56
|
+
# * <tt>:instruct</tt>: Hash of XML processing instructions in the form {target => {attribute => value, }} or {target => [{attribute => value, }, ]}
|
57
|
+
#
|
58
|
+
# Other namespaces can be added to the root element:
|
59
|
+
#
|
60
|
+
# app/views/posts/index.atom.builder:
|
61
|
+
# atom_feed({'xmlns:app' => 'http://www.w3.org/2007/app',
|
62
|
+
# 'xmlns:openSearch' => 'http://a9.com/-/spec/opensearch/1.1/'}) do |feed|
|
63
|
+
# feed.title("My great blog!")
|
64
|
+
# feed.updated((@posts.first.created_at))
|
65
|
+
# feed.tag!(openSearch:totalResults, 10)
|
66
|
+
#
|
67
|
+
# for post in @posts
|
68
|
+
# feed.entry(post) do |entry|
|
69
|
+
# entry.title(post.title)
|
70
|
+
# entry.content(post.body, :type => 'html')
|
71
|
+
# entry.tag!('app:edited', Time.now)
|
72
|
+
#
|
73
|
+
# entry.author do |author|
|
74
|
+
# author.name("DHH")
|
75
|
+
# end
|
76
|
+
# end
|
77
|
+
# end
|
78
|
+
# end
|
79
|
+
#
|
80
|
+
# The Atom spec defines five elements (content rights title subtitle
|
81
|
+
# summary) which may directly contain xhtml content if :type => 'xhtml'
|
82
|
+
# is specified as an attribute. If so, this helper will take care of
|
83
|
+
# the enclosing div and xhtml namespace declaration. Example usage:
|
84
|
+
#
|
85
|
+
# entry.summary :type => 'xhtml' do |xhtml|
|
86
|
+
# xhtml.p pluralize(order.line_items.count, "line item")
|
87
|
+
# xhtml.p "Shipped to #{order.address}"
|
88
|
+
# xhtml.p "Paid by #{order.pay_type}"
|
89
|
+
# end
|
90
|
+
#
|
91
|
+
#
|
92
|
+
# atom_feed yields an AtomFeedBuilder instance. Nested elements yield
|
93
|
+
# an AtomBuilder instance.
|
94
|
+
def atom_feed(options = {}, &block)
|
95
|
+
if options[:schema_date]
|
96
|
+
options[:schema_date] = options[:schema_date].strftime("%Y-%m-%d") if options[:schema_date].respond_to?(:strftime)
|
97
|
+
else
|
98
|
+
options[:schema_date] = "2005" # The Atom spec copyright date
|
99
|
+
end
|
100
|
+
|
101
|
+
xml = options.delete(:xml) || eval("xml", block.binding)
|
102
|
+
xml.instruct!
|
103
|
+
if options[:instruct]
|
104
|
+
options[:instruct].each do |target,attrs|
|
105
|
+
if attrs.respond_to?(:keys)
|
106
|
+
xml.instruct!(target, attrs)
|
107
|
+
elsif attrs.respond_to?(:each)
|
108
|
+
attrs.each { |attr_group| xml.instruct!(target, attr_group) }
|
109
|
+
end
|
110
|
+
end
|
111
|
+
end
|
112
|
+
|
113
|
+
feed_opts = {"xml:lang" => options[:language] || "en-US", "xmlns" => 'http://www.w3.org/2005/Atom'}
|
114
|
+
feed_opts.merge!(options).reject!{|k,v| !k.to_s.match(/^xml/)}
|
115
|
+
|
116
|
+
xml.feed(feed_opts) do
|
117
|
+
xml.id(options[:id] || "tag:#{request.host},#{options[:schema_date]}:#{request.request_uri.split(".")[0]}")
|
118
|
+
xml.link(:rel => 'alternate', :type => 'text/html', :href => options[:root_url] || (request.protocol + request.host_with_port))
|
119
|
+
xml.link(:rel => 'self', :type => 'application/atom+xml', :href => options[:url] || request.url)
|
120
|
+
|
121
|
+
yield AtomFeedBuilder.new(xml, self, options)
|
122
|
+
end
|
123
|
+
end
|
124
|
+
|
125
|
+
class AtomBuilder
|
126
|
+
XHTML_TAG_NAMES = %w(content rights title subtitle summary).to_set
|
127
|
+
|
128
|
+
def initialize(xml)
|
129
|
+
@xml = xml
|
130
|
+
end
|
131
|
+
|
132
|
+
private
|
133
|
+
# Delegate to xml builder, first wrapping the element in a xhtml
|
134
|
+
# namespaced div element if the method and arguments indicate
|
135
|
+
# that an xhtml_block? is desired.
|
136
|
+
def method_missing(method, *arguments, &block)
|
137
|
+
if xhtml_block?(method, arguments)
|
138
|
+
@xml.__send__(method, *arguments) do
|
139
|
+
@xml.div(:xmlns => 'http://www.w3.org/1999/xhtml') do |xhtml|
|
140
|
+
block.call(xhtml)
|
141
|
+
end
|
142
|
+
end
|
143
|
+
else
|
144
|
+
@xml.__send__(method, *arguments, &block)
|
145
|
+
end
|
146
|
+
end
|
147
|
+
|
148
|
+
# True if the method name matches one of the five elements defined
|
149
|
+
# in the Atom spec as potentially containing XHTML content and
|
150
|
+
# if :type => 'xhtml' is, in fact, specified.
|
151
|
+
def xhtml_block?(method, arguments)
|
152
|
+
if XHTML_TAG_NAMES.include?(method.to_s)
|
153
|
+
last = arguments.last
|
154
|
+
last.is_a?(Hash) && last[:type].to_s == 'xhtml'
|
155
|
+
end
|
156
|
+
end
|
157
|
+
end
|
158
|
+
|
159
|
+
class AtomFeedBuilder < AtomBuilder
|
160
|
+
def initialize(xml, view, feed_options = {})
|
161
|
+
@xml, @view, @feed_options = xml, view, feed_options
|
162
|
+
end
|
163
|
+
|
164
|
+
# Accepts a Date or Time object and inserts it in the proper format. If nil is passed, current time in UTC is used.
|
165
|
+
def updated(date_or_time = nil)
|
166
|
+
@xml.updated((date_or_time || Time.now.utc).xmlschema)
|
167
|
+
end
|
168
|
+
|
169
|
+
# Creates an entry tag for a specific record and prefills the id using class and id.
|
170
|
+
#
|
171
|
+
# Options:
|
172
|
+
#
|
173
|
+
# * <tt>:published</tt>: Time first published. Defaults to the created_at attribute on the record if one such exists.
|
174
|
+
# * <tt>:updated</tt>: Time of update. Defaults to the updated_at attribute on the record if one such exists.
|
175
|
+
# * <tt>:url</tt>: The URL for this entry. Defaults to the polymorphic_url for the record.
|
176
|
+
# * <tt>:id</tt>: The ID for this entry. Defaults to "tag:#{@view.request.host},#{@feed_options[:schema_date]}:#{record.class}/#{record.id}"
|
177
|
+
def entry(record, options = {})
|
178
|
+
@xml.entry do
|
179
|
+
@xml.id(options[:id] || "tag:#{@view.request.host},#{@feed_options[:schema_date]}:#{record.class}/#{record.id}")
|
180
|
+
|
181
|
+
if options[:published] || (record.respond_to?(:created_at) && record.created_at)
|
182
|
+
@xml.published((options[:published] || record.created_at).xmlschema)
|
183
|
+
end
|
184
|
+
|
185
|
+
if options[:updated] || (record.respond_to?(:updated_at) && record.updated_at)
|
186
|
+
@xml.updated((options[:updated] || record.updated_at).xmlschema)
|
187
|
+
end
|
188
|
+
|
189
|
+
@xml.link(:rel => 'alternate', :type => 'text/html', :href => options[:url] || @view.polymorphic_url(record))
|
190
|
+
|
191
|
+
yield AtomBuilder.new(@xml)
|
192
|
+
end
|
193
|
+
end
|
194
|
+
end
|
195
|
+
|
196
|
+
end
|
197
|
+
end
|
198
|
+
end
|
@@ -0,0 +1,39 @@
|
|
1
|
+
module ActionView
|
2
|
+
module Helpers
|
3
|
+
# This helper to exposes a method for caching of view fragments.
|
4
|
+
# See ActionController::Caching::Fragments for usage instructions.
|
5
|
+
module CacheHelper
|
6
|
+
# A method for caching fragments of a view rather than an entire
|
7
|
+
# action or page. This technique is useful caching pieces like
|
8
|
+
# menus, lists of news topics, static HTML fragments, and so on.
|
9
|
+
# This method takes a block that contains the content you wish
|
10
|
+
# to cache. See ActionController::Caching::Fragments for more
|
11
|
+
# information.
|
12
|
+
#
|
13
|
+
# ==== Examples
|
14
|
+
# If you wanted to cache a navigation menu, you could do the
|
15
|
+
# following.
|
16
|
+
#
|
17
|
+
# <% cache do %>
|
18
|
+
# <%= render :partial => "menu" %>
|
19
|
+
# <% end %>
|
20
|
+
#
|
21
|
+
# You can also cache static content...
|
22
|
+
#
|
23
|
+
# <% cache do %>
|
24
|
+
# <p>Hello users! Welcome to our website!</p>
|
25
|
+
# <% end %>
|
26
|
+
#
|
27
|
+
# ...and static content mixed with RHTML content.
|
28
|
+
#
|
29
|
+
# <% cache do %>
|
30
|
+
# Topics:
|
31
|
+
# <%= render :partial => "topics", :collection => @topic_list %>
|
32
|
+
# <i>Topics listed alphabetically</i>
|
33
|
+
# <% end %>
|
34
|
+
def cache(name = {}, options = nil, &block)
|
35
|
+
@controller.fragment_for(output_buffer, name, options, &block)
|
36
|
+
end
|
37
|
+
end
|
38
|
+
end
|
39
|
+
end
|
@@ -0,0 +1,168 @@
|
|
1
|
+
module ActionView
|
2
|
+
module Helpers
|
3
|
+
# CaptureHelper exposes methods to let you extract generated markup which
|
4
|
+
# can be used in other parts of a template or layout file.
|
5
|
+
# It provides a method to capture blocks into variables through capture and
|
6
|
+
# a way to capture a block of markup for use in a layout through content_for.
|
7
|
+
module CaptureHelper
|
8
|
+
# The capture method allows you to extract part of a template into a
|
9
|
+
# variable. You can then use this variable anywhere in your templates or layout.
|
10
|
+
#
|
11
|
+
# ==== Examples
|
12
|
+
# The capture method can be used in ERb templates...
|
13
|
+
#
|
14
|
+
# <% @greeting = capture do %>
|
15
|
+
# Welcome to my shiny new web page! The date and time is
|
16
|
+
# <%= Time.now %>
|
17
|
+
# <% end %>
|
18
|
+
#
|
19
|
+
# ...and Builder (RXML) templates.
|
20
|
+
#
|
21
|
+
# @timestamp = capture do
|
22
|
+
# "The current timestamp is #{Time.now}."
|
23
|
+
# end
|
24
|
+
#
|
25
|
+
# You can then use that variable anywhere else. For example:
|
26
|
+
#
|
27
|
+
# <html>
|
28
|
+
# <head><title><%= @greeting %></title></head>
|
29
|
+
# <body>
|
30
|
+
# <b><%= @greeting %></b>
|
31
|
+
# </body></html>
|
32
|
+
#
|
33
|
+
def capture(*args, &block)
|
34
|
+
# Return captured buffer in erb.
|
35
|
+
if block_called_from_erb?(block)
|
36
|
+
with_output_buffer { block.call(*args) }
|
37
|
+
else
|
38
|
+
# Return block result otherwise, but protect buffer also.
|
39
|
+
with_output_buffer { return block.call(*args) }
|
40
|
+
end
|
41
|
+
end
|
42
|
+
|
43
|
+
# Calling content_for stores a block of markup in an identifier for later use.
|
44
|
+
# You can make subsequent calls to the stored content in other templates or the layout
|
45
|
+
# by passing the identifier as an argument to <tt>yield</tt>.
|
46
|
+
#
|
47
|
+
# ==== Examples
|
48
|
+
#
|
49
|
+
# <% content_for :not_authorized do %>
|
50
|
+
# alert('You are not authorized to do that!')
|
51
|
+
# <% end %>
|
52
|
+
#
|
53
|
+
# You can then use <tt>yield :not_authorized</tt> anywhere in your templates.
|
54
|
+
#
|
55
|
+
# <%= yield :not_authorized if current_user.nil? %>
|
56
|
+
#
|
57
|
+
# You can also use this syntax alongside an existing call to <tt>yield</tt> in a layout. For example:
|
58
|
+
#
|
59
|
+
# <%# This is the layout %>
|
60
|
+
# <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
61
|
+
# <head>
|
62
|
+
# <title>My Website</title>
|
63
|
+
# <%= yield :script %>
|
64
|
+
# </head>
|
65
|
+
# <body>
|
66
|
+
# <%= yield %>
|
67
|
+
# </body>
|
68
|
+
# </html>
|
69
|
+
#
|
70
|
+
# And now, we'll create a view that has a content_for call that
|
71
|
+
# creates the <tt>script</tt> identifier.
|
72
|
+
#
|
73
|
+
# <%# This is our view %>
|
74
|
+
# Please login!
|
75
|
+
#
|
76
|
+
# <% content_for :script do %>
|
77
|
+
# <script type="text/javascript">alert('You are not authorized to view this page!')</script>
|
78
|
+
# <% end %>
|
79
|
+
#
|
80
|
+
# Then, in another view, you could to do something like this:
|
81
|
+
#
|
82
|
+
# <%= link_to_remote 'Logout', :action => 'logout' %>
|
83
|
+
#
|
84
|
+
# <% content_for :script do %>
|
85
|
+
# <%= javascript_include_tag :defaults %>
|
86
|
+
# <% end %>
|
87
|
+
#
|
88
|
+
# That will place <script> tags for Prototype, Scriptaculous, and application.js (if it exists)
|
89
|
+
# on the page; this technique is useful if you'll only be using these scripts in a few views.
|
90
|
+
#
|
91
|
+
# Note that content_for concatenates the blocks it is given for a particular
|
92
|
+
# identifier in order. For example:
|
93
|
+
#
|
94
|
+
# <% content_for :navigation do %>
|
95
|
+
# <li><%= link_to 'Home', :action => 'index' %></li>
|
96
|
+
# <% end %>
|
97
|
+
#
|
98
|
+
# <%# Add some other content, or use a different template: %>
|
99
|
+
#
|
100
|
+
# <% content_for :navigation do %>
|
101
|
+
# <li><%= link_to 'Login', :action => 'login' %></li>
|
102
|
+
# <% end %>
|
103
|
+
#
|
104
|
+
# Then, in another template or layout, this code would render both links in order:
|
105
|
+
#
|
106
|
+
# <ul><%= yield :navigation %></ul>
|
107
|
+
#
|
108
|
+
# Lastly, simple content can be passed as a parameter:
|
109
|
+
#
|
110
|
+
# <% content_for :script, javascript_include_tag(:defaults) %>
|
111
|
+
#
|
112
|
+
# WARNING: content_for is ignored in caches. So you shouldn't use it
|
113
|
+
# for elements that will be fragment cached.
|
114
|
+
def content_for(name, content = nil, &block)
|
115
|
+
content = capture(&block) if block_given?
|
116
|
+
return @_content_for[name] << content if content
|
117
|
+
@_content_for[name]
|
118
|
+
end
|
119
|
+
|
120
|
+
# content_for? simply checks whether any content has been captured yet using content_for
|
121
|
+
# Useful to render parts of your layout differently based on what is in your views.
|
122
|
+
#
|
123
|
+
# ==== Examples
|
124
|
+
#
|
125
|
+
# Perhaps you will use different css in you layout if no content_for :right_column
|
126
|
+
#
|
127
|
+
# <%# This is the layout %>
|
128
|
+
# <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
129
|
+
# <head>
|
130
|
+
# <title>My Website</title>
|
131
|
+
# <%= yield :script %>
|
132
|
+
# </head>
|
133
|
+
# <body class="<%= content_for?(:right_col) ? 'one-column' : 'two-column' %>">
|
134
|
+
# <%= yield %>
|
135
|
+
# <%= yield :right_col %>
|
136
|
+
# </body>
|
137
|
+
# </html>
|
138
|
+
def content_for?(name)
|
139
|
+
@_content_for[name].present?
|
140
|
+
end
|
141
|
+
|
142
|
+
# Use an alternate output buffer for the duration of the block.
|
143
|
+
# Defaults to a new empty string.
|
144
|
+
def with_output_buffer(buf = nil) #:nodoc:
|
145
|
+
unless buf
|
146
|
+
buf = ActionView::SafeBuffer.new
|
147
|
+
buf.force_encoding(output_buffer.encoding) if buf.respond_to?(:force_encoding)
|
148
|
+
end
|
149
|
+
self.output_buffer, old_buffer = buf, output_buffer
|
150
|
+
yield
|
151
|
+
output_buffer
|
152
|
+
ensure
|
153
|
+
self.output_buffer = old_buffer
|
154
|
+
end
|
155
|
+
|
156
|
+
# Add the output buffer to the response body and start a new one.
|
157
|
+
def flush_output_buffer #:nodoc:
|
158
|
+
if output_buffer && !output_buffer.empty?
|
159
|
+
response.body_parts << output_buffer
|
160
|
+
new = ''
|
161
|
+
new.force_encoding(output_buffer.encoding) if new.respond_to?(:force_encoding)
|
162
|
+
self.output_buffer = new
|
163
|
+
nil
|
164
|
+
end
|
165
|
+
end
|
166
|
+
end
|
167
|
+
end
|
168
|
+
end
|
@@ -0,0 +1,988 @@
|
|
1
|
+
require "date"
|
2
|
+
require 'action_view/helpers/tag_helper'
|
3
|
+
|
4
|
+
module ActionView
|
5
|
+
module Helpers
|
6
|
+
# The Date Helper primarily creates select/option tags for different kinds of dates and date elements. All of the
|
7
|
+
# select-type methods share a number of common options that are as follows:
|
8
|
+
#
|
9
|
+
# * <tt>:prefix</tt> - overwrites the default prefix of "date" used for the select names. So specifying "birthday"
|
10
|
+
# would give birthday[month] instead of date[month] if passed to the select_month method.
|
11
|
+
# * <tt>:include_blank</tt> - set to true if it should be possible to set an empty date.
|
12
|
+
# * <tt>:discard_type</tt> - set to true if you want to discard the type part of the select name. If set to true,
|
13
|
+
# the select_month method would use simply "date" (which can be overwritten using <tt>:prefix</tt>) instead of
|
14
|
+
# "date[month]".
|
15
|
+
module DateHelper
|
16
|
+
# Reports the approximate distance in time between two Time or Date objects or integers as seconds.
|
17
|
+
# Set <tt>include_seconds</tt> to true if you want more detailed approximations when distance < 1 min, 29 secs
|
18
|
+
# Distances are reported based on the following table:
|
19
|
+
#
|
20
|
+
# 0 <-> 29 secs # => less than a minute
|
21
|
+
# 30 secs <-> 1 min, 29 secs # => 1 minute
|
22
|
+
# 1 min, 30 secs <-> 44 mins, 29 secs # => [2..44] minutes
|
23
|
+
# 44 mins, 30 secs <-> 89 mins, 29 secs # => about 1 hour
|
24
|
+
# 89 mins, 29 secs <-> 23 hrs, 59 mins, 29 secs # => about [2..24] hours
|
25
|
+
# 23 hrs, 59 mins, 29 secs <-> 47 hrs, 59 mins, 29 secs # => 1 day
|
26
|
+
# 47 hrs, 59 mins, 29 secs <-> 29 days, 23 hrs, 59 mins, 29 secs # => [2..29] days
|
27
|
+
# 29 days, 23 hrs, 59 mins, 30 secs <-> 59 days, 23 hrs, 59 mins, 29 secs # => about 1 month
|
28
|
+
# 59 days, 23 hrs, 59 mins, 30 secs <-> 1 yr minus 1 sec # => [2..12] months
|
29
|
+
# 1 yr <-> 1 yr, 3 months # => about 1 year
|
30
|
+
# 1 yr, 3 months <-> 1 yr, 9 months # => over 1 year
|
31
|
+
# 1 yr, 9 months <-> 2 yr minus 1 sec # => almost 2 years
|
32
|
+
# 2 yrs <-> max time or date # => (same rules as 1 yr)
|
33
|
+
#
|
34
|
+
# With <tt>include_seconds</tt> = true and the difference < 1 minute 29 seconds:
|
35
|
+
# 0-4 secs # => less than 5 seconds
|
36
|
+
# 5-9 secs # => less than 10 seconds
|
37
|
+
# 10-19 secs # => less than 20 seconds
|
38
|
+
# 20-39 secs # => half a minute
|
39
|
+
# 40-59 secs # => less than a minute
|
40
|
+
# 60-89 secs # => 1 minute
|
41
|
+
#
|
42
|
+
# ==== Examples
|
43
|
+
# from_time = Time.now
|
44
|
+
# distance_of_time_in_words(from_time, from_time + 50.minutes) # => about 1 hour
|
45
|
+
# distance_of_time_in_words(from_time, 50.minutes.from_now) # => about 1 hour
|
46
|
+
# distance_of_time_in_words(from_time, from_time + 15.seconds) # => less than a minute
|
47
|
+
# distance_of_time_in_words(from_time, from_time + 15.seconds, true) # => less than 20 seconds
|
48
|
+
# distance_of_time_in_words(from_time, 3.years.from_now) # => about 3 years
|
49
|
+
# distance_of_time_in_words(from_time, from_time + 60.hours) # => about 3 days
|
50
|
+
# distance_of_time_in_words(from_time, from_time + 45.seconds, true) # => less than a minute
|
51
|
+
# distance_of_time_in_words(from_time, from_time - 45.seconds, true) # => less than a minute
|
52
|
+
# distance_of_time_in_words(from_time, 76.seconds.from_now) # => 1 minute
|
53
|
+
# distance_of_time_in_words(from_time, from_time + 1.year + 3.days) # => about 1 year
|
54
|
+
# distance_of_time_in_words(from_time, from_time + 3.years + 6.months) # => over 3 years
|
55
|
+
# distance_of_time_in_words(from_time, from_time + 4.years + 9.days + 30.minutes + 5.seconds) # => about 4 years
|
56
|
+
#
|
57
|
+
# to_time = Time.now + 6.years + 19.days
|
58
|
+
# distance_of_time_in_words(from_time, to_time, true) # => about 6 years
|
59
|
+
# distance_of_time_in_words(to_time, from_time, true) # => about 6 years
|
60
|
+
# distance_of_time_in_words(Time.now, Time.now) # => less than a minute
|
61
|
+
#
|
62
|
+
def distance_of_time_in_words(from_time, to_time = 0, include_seconds = false, options = {})
|
63
|
+
from_time = from_time.to_time if from_time.respond_to?(:to_time)
|
64
|
+
to_time = to_time.to_time if to_time.respond_to?(:to_time)
|
65
|
+
distance_in_minutes = (((to_time - from_time).abs)/60).round
|
66
|
+
distance_in_seconds = ((to_time - from_time).abs).round
|
67
|
+
|
68
|
+
I18n.with_options :locale => options[:locale], :scope => :'datetime.distance_in_words' do |locale|
|
69
|
+
case distance_in_minutes
|
70
|
+
when 0..1
|
71
|
+
return distance_in_minutes == 0 ?
|
72
|
+
locale.t(:less_than_x_minutes, :count => 1) :
|
73
|
+
locale.t(:x_minutes, :count => distance_in_minutes) unless include_seconds
|
74
|
+
|
75
|
+
case distance_in_seconds
|
76
|
+
when 0..4 then locale.t :less_than_x_seconds, :count => 5
|
77
|
+
when 5..9 then locale.t :less_than_x_seconds, :count => 10
|
78
|
+
when 10..19 then locale.t :less_than_x_seconds, :count => 20
|
79
|
+
when 20..39 then locale.t :half_a_minute
|
80
|
+
when 40..59 then locale.t :less_than_x_minutes, :count => 1
|
81
|
+
else locale.t :x_minutes, :count => 1
|
82
|
+
end
|
83
|
+
|
84
|
+
when 2..44 then locale.t :x_minutes, :count => distance_in_minutes
|
85
|
+
when 45..89 then locale.t :about_x_hours, :count => 1
|
86
|
+
when 90..1439 then locale.t :about_x_hours, :count => (distance_in_minutes.to_f / 60.0).round
|
87
|
+
when 1440..2529 then locale.t :x_days, :count => 1
|
88
|
+
when 2530..43199 then locale.t :x_days, :count => (distance_in_minutes.to_f / 1440.0).round
|
89
|
+
when 43200..86399 then locale.t :about_x_months, :count => 1
|
90
|
+
when 86400..525599 then locale.t :x_months, :count => (distance_in_minutes.to_f / 43200.0).round
|
91
|
+
else
|
92
|
+
distance_in_years = distance_in_minutes / 525600
|
93
|
+
minute_offset_for_leap_year = (distance_in_years / 4) * 1440
|
94
|
+
remainder = ((distance_in_minutes - minute_offset_for_leap_year) % 525600)
|
95
|
+
if remainder < 131400
|
96
|
+
locale.t(:about_x_years, :count => distance_in_years)
|
97
|
+
elsif remainder < 394200
|
98
|
+
locale.t(:over_x_years, :count => distance_in_years)
|
99
|
+
else
|
100
|
+
locale.t(:almost_x_years, :count => distance_in_years + 1)
|
101
|
+
end
|
102
|
+
end
|
103
|
+
end
|
104
|
+
end
|
105
|
+
|
106
|
+
# Like distance_of_time_in_words, but where <tt>to_time</tt> is fixed to <tt>Time.now</tt>.
|
107
|
+
#
|
108
|
+
# ==== Examples
|
109
|
+
# time_ago_in_words(3.minutes.from_now) # => 3 minutes
|
110
|
+
# time_ago_in_words(Time.now - 15.hours) # => 15 hours
|
111
|
+
# time_ago_in_words(Time.now) # => less than a minute
|
112
|
+
#
|
113
|
+
# from_time = Time.now - 3.days - 14.minutes - 25.seconds # => 3 days
|
114
|
+
def time_ago_in_words(from_time, include_seconds = false)
|
115
|
+
distance_of_time_in_words(from_time, Time.now, include_seconds)
|
116
|
+
end
|
117
|
+
|
118
|
+
alias_method :distance_of_time_in_words_to_now, :time_ago_in_words
|
119
|
+
|
120
|
+
# Returns a set of select tags (one for year, month, and day) pre-selected for accessing a specified date-based
|
121
|
+
# attribute (identified by +method+) on an object assigned to the template (identified by +object+).
|
122
|
+
#
|
123
|
+
#
|
124
|
+
# ==== Options
|
125
|
+
# * <tt>:use_month_numbers</tt> - Set to true if you want to use month numbers rather than month names (e.g.
|
126
|
+
# "2" instead of "February").
|
127
|
+
# * <tt>:use_short_month</tt> - Set to true if you want to use abbreviated month names instead of full
|
128
|
+
# month names (e.g. "Feb" instead of "February").
|
129
|
+
# * <tt>:add_month_numbers</tt> - Set to true if you want to use both month numbers and month names (e.g.
|
130
|
+
# "2 - February" instead of "February").
|
131
|
+
# * <tt>:use_month_names</tt> - Set to an array with 12 month names if you want to customize month names.
|
132
|
+
# Note: You can also use Rails' i18n functionality for this.
|
133
|
+
# * <tt>:date_separator</tt> - Specifies a string to separate the date fields. Default is "" (i.e. nothing).
|
134
|
+
# * <tt>:start_year</tt> - Set the start year for the year select. Default is <tt>Time.now.year - 5</tt>.
|
135
|
+
# * <tt>:end_year</tt> - Set the end year for the year select. Default is <tt>Time.now.year + 5</tt>.
|
136
|
+
# * <tt>:discard_day</tt> - Set to true if you don't want to show a day select. This includes the day
|
137
|
+
# as a hidden field instead of showing a select field. Also note that this implicitly sets the day to be the
|
138
|
+
# first of the given month in order to not create invalid dates like 31 February.
|
139
|
+
# * <tt>:discard_month</tt> - Set to true if you don't want to show a month select. This includes the month
|
140
|
+
# as a hidden field instead of showing a select field. Also note that this implicitly sets :discard_day to true.
|
141
|
+
# * <tt>:discard_year</tt> - Set to true if you don't want to show a year select. This includes the year
|
142
|
+
# as a hidden field instead of showing a select field.
|
143
|
+
# * <tt>:order</tt> - Set to an array containing <tt>:day</tt>, <tt>:month</tt> and <tt>:year</tt> to
|
144
|
+
# customize the order in which the select fields are shown. If you leave out any of the symbols, the respective
|
145
|
+
# select will not be shown (like when you set <tt>:discard_xxx => true</tt>. Defaults to the order defined in
|
146
|
+
# the respective locale (e.g. [:year, :month, :day] in the en locale that ships with Rails).
|
147
|
+
# * <tt>:include_blank</tt> - Include a blank option in every select field so it's possible to set empty
|
148
|
+
# dates.
|
149
|
+
# * <tt>:default</tt> - Set a default date if the affected date isn't set or is nil.
|
150
|
+
# * <tt>:disabled</tt> - Set to true if you want show the select fields as disabled.
|
151
|
+
# * <tt>:prompt</tt> - Set to true (for a generic prompt), a prompt string or a hash of prompt strings
|
152
|
+
# for <tt>:year</tt>, <tt>:month</tt>, <tt>:day</tt>, <tt>:hour</tt>, <tt>:minute</tt> and <tt>:second</tt>.
|
153
|
+
# Setting this option prepends a select option with a generic prompt (Day, Month, Year, Hour, Minute, Seconds)
|
154
|
+
# or the given prompt string.
|
155
|
+
#
|
156
|
+
# If anything is passed in the +html_options+ hash it will be applied to every select tag in the set.
|
157
|
+
#
|
158
|
+
# NOTE: Discarded selects will default to 1. So if no month select is available, January will be assumed.
|
159
|
+
#
|
160
|
+
# ==== Examples
|
161
|
+
# # Generates a date select that when POSTed is stored in the post variable, in the written_on attribute
|
162
|
+
# date_select("post", "written_on")
|
163
|
+
#
|
164
|
+
# # Generates a date select that when POSTed is stored in the post variable, in the written_on attribute,
|
165
|
+
# # with the year in the year drop down box starting at 1995.
|
166
|
+
# date_select("post", "written_on", :start_year => 1995)
|
167
|
+
#
|
168
|
+
# # Generates a date select that when POSTed is stored in the post variable, in the written_on attribute,
|
169
|
+
# # with the year in the year drop down box starting at 1995, numbers used for months instead of words,
|
170
|
+
# # and without a day select box.
|
171
|
+
# date_select("post", "written_on", :start_year => 1995, :use_month_numbers => true,
|
172
|
+
# :discard_day => true, :include_blank => true)
|
173
|
+
#
|
174
|
+
# # Generates a date select that when POSTed is stored in the post variable, in the written_on attribute
|
175
|
+
# # with the fields ordered as day, month, year rather than month, day, year.
|
176
|
+
# date_select("post", "written_on", :order => [:day, :month, :year])
|
177
|
+
#
|
178
|
+
# # Generates a date select that when POSTed is stored in the user variable, in the birthday attribute
|
179
|
+
# # lacking a year field.
|
180
|
+
# date_select("user", "birthday", :order => [:month, :day])
|
181
|
+
#
|
182
|
+
# # Generates a date select that when POSTed is stored in the user variable, in the birthday attribute
|
183
|
+
# # which is initially set to the date 3 days from the current date
|
184
|
+
# date_select("post", "written_on", :default => 3.days.from_now)
|
185
|
+
#
|
186
|
+
# # Generates a date select that when POSTed is stored in the credit_card variable, in the bill_due attribute
|
187
|
+
# # that will have a default day of 20.
|
188
|
+
# date_select("credit_card", "bill_due", :default => { :day => 20 })
|
189
|
+
#
|
190
|
+
# # Generates a date select with custom prompts
|
191
|
+
# date_select("post", "written_on", :prompt => { :day => 'Select day', :month => 'Select month', :year => 'Select year' })
|
192
|
+
#
|
193
|
+
# The selects are prepared for multi-parameter assignment to an Active Record object.
|
194
|
+
#
|
195
|
+
# Note: If the day is not included as an option but the month is, the day will be set to the 1st to ensure that
|
196
|
+
# all month choices are valid.
|
197
|
+
def date_select(object_name, method, options = {}, html_options = {})
|
198
|
+
InstanceTag.new(object_name, method, self, options.delete(:object)).to_date_select_tag(options, html_options)
|
199
|
+
end
|
200
|
+
|
201
|
+
# Returns a set of select tags (one for hour, minute and optionally second) pre-selected for accessing a
|
202
|
+
# specified time-based attribute (identified by +method+) on an object assigned to the template (identified by
|
203
|
+
# +object+). You can include the seconds with <tt>:include_seconds</tt>.
|
204
|
+
#
|
205
|
+
# This method will also generate 3 input hidden tags, for the actual year, month and day unless the option
|
206
|
+
# <tt>:ignore_date</tt> is set to +true+.
|
207
|
+
#
|
208
|
+
# If anything is passed in the html_options hash it will be applied to every select tag in the set.
|
209
|
+
#
|
210
|
+
# ==== Examples
|
211
|
+
# # Creates a time select tag that, when POSTed, will be stored in the post variable in the sunrise attribute
|
212
|
+
# time_select("post", "sunrise")
|
213
|
+
#
|
214
|
+
# # Creates a time select tag that, when POSTed, will be stored in the order variable in the submitted
|
215
|
+
# # attribute
|
216
|
+
# time_select("order", "submitted")
|
217
|
+
#
|
218
|
+
# # Creates a time select tag that, when POSTed, will be stored in the mail variable in the sent_at attribute
|
219
|
+
# time_select("mail", "sent_at")
|
220
|
+
#
|
221
|
+
# # Creates a time select tag with a seconds field that, when POSTed, will be stored in the post variables in
|
222
|
+
# # the sunrise attribute.
|
223
|
+
# time_select("post", "start_time", :include_seconds => true)
|
224
|
+
#
|
225
|
+
# # Creates a time select tag with a seconds field that, when POSTed, will be stored in the entry variables in
|
226
|
+
# # the submission_time attribute.
|
227
|
+
# time_select("entry", "submission_time", :include_seconds => true)
|
228
|
+
#
|
229
|
+
# # You can set the :minute_step to 15 which will give you: 00, 15, 30 and 45.
|
230
|
+
# time_select 'game', 'game_time', {:minute_step => 15}
|
231
|
+
#
|
232
|
+
# # Creates a time select tag with a custom prompt. Use :prompt => true for generic prompts.
|
233
|
+
# time_select("post", "written_on", :prompt => {:hour => 'Choose hour', :minute => 'Choose minute', :second => 'Choose seconds'})
|
234
|
+
# time_select("post", "written_on", :prompt => {:hour => true}) # generic prompt for hours
|
235
|
+
# time_select("post", "written_on", :prompt => true) # generic prompts for all
|
236
|
+
#
|
237
|
+
# The selects are prepared for multi-parameter assignment to an Active Record object.
|
238
|
+
#
|
239
|
+
# Note: If the day is not included as an option but the month is, the day will be set to the 1st to ensure that
|
240
|
+
# all month choices are valid.
|
241
|
+
def time_select(object_name, method, options = {}, html_options = {})
|
242
|
+
InstanceTag.new(object_name, method, self, options.delete(:object)).to_time_select_tag(options, html_options)
|
243
|
+
end
|
244
|
+
|
245
|
+
# Returns a set of select tags (one for year, month, day, hour, and minute) pre-selected for accessing a
|
246
|
+
# specified datetime-based attribute (identified by +method+) on an object assigned to the template (identified
|
247
|
+
# by +object+).
|
248
|
+
#
|
249
|
+
# If anything is passed in the html_options hash it will be applied to every select tag in the set.
|
250
|
+
#
|
251
|
+
# ==== Examples
|
252
|
+
# # Generates a datetime select that, when POSTed, will be stored in the post variable in the written_on
|
253
|
+
# # attribute
|
254
|
+
# datetime_select("post", "written_on")
|
255
|
+
#
|
256
|
+
# # Generates a datetime select with a year select that starts at 1995 that, when POSTed, will be stored in the
|
257
|
+
# # post variable in the written_on attribute.
|
258
|
+
# datetime_select("post", "written_on", :start_year => 1995)
|
259
|
+
#
|
260
|
+
# # Generates a datetime select with a default value of 3 days from the current time that, when POSTed, will
|
261
|
+
# # be stored in the trip variable in the departing attribute.
|
262
|
+
# datetime_select("trip", "departing", :default => 3.days.from_now)
|
263
|
+
#
|
264
|
+
# # Generates a datetime select that discards the type that, when POSTed, will be stored in the post variable
|
265
|
+
# # as the written_on attribute.
|
266
|
+
# datetime_select("post", "written_on", :discard_type => true)
|
267
|
+
#
|
268
|
+
# # Generates a datetime select with a custom prompt. Use :prompt=>true for generic prompts.
|
269
|
+
# datetime_select("post", "written_on", :prompt => {:day => 'Choose day', :month => 'Choose month', :year => 'Choose year'})
|
270
|
+
# datetime_select("post", "written_on", :prompt => {:hour => true}) # generic prompt for hours
|
271
|
+
# datetime_select("post", "written_on", :prompt => true) # generic prompts for all
|
272
|
+
#
|
273
|
+
# The selects are prepared for multi-parameter assignment to an Active Record object.
|
274
|
+
def datetime_select(object_name, method, options = {}, html_options = {})
|
275
|
+
InstanceTag.new(object_name, method, self, options.delete(:object)).to_datetime_select_tag(options, html_options)
|
276
|
+
end
|
277
|
+
|
278
|
+
# Returns a set of html select-tags (one for year, month, day, hour, and minute) pre-selected with the
|
279
|
+
# +datetime+. It's also possible to explicitly set the order of the tags using the <tt>:order</tt> option with
|
280
|
+
# an array of symbols <tt>:year</tt>, <tt>:month</tt> and <tt>:day</tt> in the desired order. If you do not
|
281
|
+
# supply a Symbol, it will be appended onto the <tt>:order</tt> passed in. You can also add
|
282
|
+
# <tt>:date_separator</tt>, <tt>:datetime_separator</tt> and <tt>:time_separator</tt> keys to the +options+ to
|
283
|
+
# control visual display of the elements.
|
284
|
+
#
|
285
|
+
# If anything is passed in the html_options hash it will be applied to every select tag in the set.
|
286
|
+
#
|
287
|
+
# ==== Examples
|
288
|
+
# my_date_time = Time.now + 4.days
|
289
|
+
#
|
290
|
+
# # Generates a datetime select that defaults to the datetime in my_date_time (four days after today)
|
291
|
+
# select_datetime(my_date_time)
|
292
|
+
#
|
293
|
+
# # Generates a datetime select that defaults to today (no specified datetime)
|
294
|
+
# select_datetime()
|
295
|
+
#
|
296
|
+
# # Generates a datetime select that defaults to the datetime in my_date_time (four days after today)
|
297
|
+
# # with the fields ordered year, month, day rather than month, day, year.
|
298
|
+
# select_datetime(my_date_time, :order => [:year, :month, :day])
|
299
|
+
#
|
300
|
+
# # Generates a datetime select that defaults to the datetime in my_date_time (four days after today)
|
301
|
+
# # with a '/' between each date field.
|
302
|
+
# select_datetime(my_date_time, :date_separator => '/')
|
303
|
+
#
|
304
|
+
# # Generates a datetime select that defaults to the datetime in my_date_time (four days after today)
|
305
|
+
# # with a date fields separated by '/', time fields separated by '' and the date and time fields
|
306
|
+
# # separated by a comma (',').
|
307
|
+
# select_datetime(my_date_time, :date_separator => '/', :time_separator => '', :datetime_separator => ',')
|
308
|
+
#
|
309
|
+
# # Generates a datetime select that discards the type of the field and defaults to the datetime in
|
310
|
+
# # my_date_time (four days after today)
|
311
|
+
# select_datetime(my_date_time, :discard_type => true)
|
312
|
+
#
|
313
|
+
# # Generates a datetime select that defaults to the datetime in my_date_time (four days after today)
|
314
|
+
# # prefixed with 'payday' rather than 'date'
|
315
|
+
# select_datetime(my_date_time, :prefix => 'payday')
|
316
|
+
#
|
317
|
+
# # Generates a datetime select with a custom prompt. Use :prompt=>true for generic prompts.
|
318
|
+
# select_datetime(my_date_time, :prompt => {:day => 'Choose day', :month => 'Choose month', :year => 'Choose year'})
|
319
|
+
# select_datetime(my_date_time, :prompt => {:hour => true}) # generic prompt for hours
|
320
|
+
# select_datetime(my_date_time, :prompt => true) # generic prompts for all
|
321
|
+
#
|
322
|
+
def select_datetime(datetime = Time.current, options = {}, html_options = {})
|
323
|
+
DateTimeSelector.new(datetime, options, html_options).select_datetime
|
324
|
+
end
|
325
|
+
|
326
|
+
# Returns a set of html select-tags (one for year, month, and day) pre-selected with the +date+.
|
327
|
+
# It's possible to explicitly set the order of the tags using the <tt>:order</tt> option with an array of
|
328
|
+
# symbols <tt>:year</tt>, <tt>:month</tt> and <tt>:day</tt> in the desired order. If you do not supply a Symbol,
|
329
|
+
# it will be appended onto the <tt>:order</tt> passed in.
|
330
|
+
#
|
331
|
+
# If anything is passed in the html_options hash it will be applied to every select tag in the set.
|
332
|
+
#
|
333
|
+
# ==== Examples
|
334
|
+
# my_date = Time.today + 6.days
|
335
|
+
#
|
336
|
+
# # Generates a date select that defaults to the date in my_date (six days after today)
|
337
|
+
# select_date(my_date)
|
338
|
+
#
|
339
|
+
# # Generates a date select that defaults to today (no specified date)
|
340
|
+
# select_date()
|
341
|
+
#
|
342
|
+
# # Generates a date select that defaults to the date in my_date (six days after today)
|
343
|
+
# # with the fields ordered year, month, day rather than month, day, year.
|
344
|
+
# select_date(my_date, :order => [:year, :month, :day])
|
345
|
+
#
|
346
|
+
# # Generates a date select that discards the type of the field and defaults to the date in
|
347
|
+
# # my_date (six days after today)
|
348
|
+
# select_date(my_date, :discard_type => true)
|
349
|
+
#
|
350
|
+
# # Generates a date select that defaults to the date in my_date,
|
351
|
+
# # which has fields separated by '/'
|
352
|
+
# select_date(my_date, :date_separator => '/')
|
353
|
+
#
|
354
|
+
# # Generates a date select that defaults to the datetime in my_date (six days after today)
|
355
|
+
# # prefixed with 'payday' rather than 'date'
|
356
|
+
# select_date(my_date, :prefix => 'payday')
|
357
|
+
#
|
358
|
+
# # Generates a date select with a custom prompt. Use :prompt=>true for generic prompts.
|
359
|
+
# select_date(my_date, :prompt => {:day => 'Choose day', :month => 'Choose month', :year => 'Choose year'})
|
360
|
+
# select_date(my_date, :prompt => {:hour => true}) # generic prompt for hours
|
361
|
+
# select_date(my_date, :prompt => true) # generic prompts for all
|
362
|
+
#
|
363
|
+
def select_date(date = Date.current, options = {}, html_options = {})
|
364
|
+
DateTimeSelector.new(date, options, html_options).select_date
|
365
|
+
end
|
366
|
+
|
367
|
+
# Returns a set of html select-tags (one for hour and minute)
|
368
|
+
# You can set <tt>:time_separator</tt> key to format the output, and
|
369
|
+
# the <tt>:include_seconds</tt> option to include an input for seconds.
|
370
|
+
#
|
371
|
+
# If anything is passed in the html_options hash it will be applied to every select tag in the set.
|
372
|
+
#
|
373
|
+
# ==== Examples
|
374
|
+
# my_time = Time.now + 5.days + 7.hours + 3.minutes + 14.seconds
|
375
|
+
#
|
376
|
+
# # Generates a time select that defaults to the time in my_time
|
377
|
+
# select_time(my_time)
|
378
|
+
#
|
379
|
+
# # Generates a time select that defaults to the current time (no specified time)
|
380
|
+
# select_time()
|
381
|
+
#
|
382
|
+
# # Generates a time select that defaults to the time in my_time,
|
383
|
+
# # which has fields separated by ':'
|
384
|
+
# select_time(my_time, :time_separator => ':')
|
385
|
+
#
|
386
|
+
# # Generates a time select that defaults to the time in my_time,
|
387
|
+
# # that also includes an input for seconds
|
388
|
+
# select_time(my_time, :include_seconds => true)
|
389
|
+
#
|
390
|
+
# # Generates a time select that defaults to the time in my_time, that has fields
|
391
|
+
# # separated by ':' and includes an input for seconds
|
392
|
+
# select_time(my_time, :time_separator => ':', :include_seconds => true)
|
393
|
+
#
|
394
|
+
# # Generates a time select with a custom prompt. Use :prompt=>true for generic prompts.
|
395
|
+
# select_time(my_time, :prompt => {:day => 'Choose day', :month => 'Choose month', :year => 'Choose year'})
|
396
|
+
# select_time(my_time, :prompt => {:hour => true}) # generic prompt for hours
|
397
|
+
# select_time(my_time, :prompt => true) # generic prompts for all
|
398
|
+
#
|
399
|
+
def select_time(datetime = Time.current, options = {}, html_options = {})
|
400
|
+
DateTimeSelector.new(datetime, options, html_options).select_time
|
401
|
+
end
|
402
|
+
|
403
|
+
# Returns a select tag with options for each of the seconds 0 through 59 with the current second selected.
|
404
|
+
# The <tt>second</tt> can also be substituted for a second number.
|
405
|
+
# Override the field name using the <tt>:field_name</tt> option, 'second' by default.
|
406
|
+
#
|
407
|
+
# ==== Examples
|
408
|
+
# my_time = Time.now + 16.minutes
|
409
|
+
#
|
410
|
+
# # Generates a select field for seconds that defaults to the seconds for the time in my_time
|
411
|
+
# select_second(my_time)
|
412
|
+
#
|
413
|
+
# # Generates a select field for seconds that defaults to the number given
|
414
|
+
# select_second(33)
|
415
|
+
#
|
416
|
+
# # Generates a select field for seconds that defaults to the seconds for the time in my_time
|
417
|
+
# # that is named 'interval' rather than 'second'
|
418
|
+
# select_second(my_time, :field_name => 'interval')
|
419
|
+
#
|
420
|
+
# # Generates a select field for seconds with a custom prompt. Use :prompt=>true for a
|
421
|
+
# # generic prompt.
|
422
|
+
# select_minute(14, :prompt => 'Choose seconds')
|
423
|
+
#
|
424
|
+
def select_second(datetime, options = {}, html_options = {})
|
425
|
+
DateTimeSelector.new(datetime, options, html_options).select_second
|
426
|
+
end
|
427
|
+
|
428
|
+
# Returns a select tag with options for each of the minutes 0 through 59 with the current minute selected.
|
429
|
+
# Also can return a select tag with options by <tt>minute_step</tt> from 0 through 59 with the 00 minute
|
430
|
+
# selected. The <tt>minute</tt> can also be substituted for a minute number.
|
431
|
+
# Override the field name using the <tt>:field_name</tt> option, 'minute' by default.
|
432
|
+
#
|
433
|
+
# ==== Examples
|
434
|
+
# my_time = Time.now + 6.hours
|
435
|
+
#
|
436
|
+
# # Generates a select field for minutes that defaults to the minutes for the time in my_time
|
437
|
+
# select_minute(my_time)
|
438
|
+
#
|
439
|
+
# # Generates a select field for minutes that defaults to the number given
|
440
|
+
# select_minute(14)
|
441
|
+
#
|
442
|
+
# # Generates a select field for minutes that defaults to the minutes for the time in my_time
|
443
|
+
# # that is named 'stride' rather than 'second'
|
444
|
+
# select_minute(my_time, :field_name => 'stride')
|
445
|
+
#
|
446
|
+
# # Generates a select field for minutes with a custom prompt. Use :prompt=>true for a
|
447
|
+
# # generic prompt.
|
448
|
+
# select_minute(14, :prompt => 'Choose minutes')
|
449
|
+
#
|
450
|
+
def select_minute(datetime, options = {}, html_options = {})
|
451
|
+
DateTimeSelector.new(datetime, options, html_options).select_minute
|
452
|
+
end
|
453
|
+
|
454
|
+
# Returns a select tag with options for each of the hours 0 through 23 with the current hour selected.
|
455
|
+
# The <tt>hour</tt> can also be substituted for a hour number.
|
456
|
+
# Override the field name using the <tt>:field_name</tt> option, 'hour' by default.
|
457
|
+
#
|
458
|
+
# ==== Examples
|
459
|
+
# my_time = Time.now + 6.hours
|
460
|
+
#
|
461
|
+
# # Generates a select field for hours that defaults to the hour for the time in my_time
|
462
|
+
# select_hour(my_time)
|
463
|
+
#
|
464
|
+
# # Generates a select field for hours that defaults to the number given
|
465
|
+
# select_hour(13)
|
466
|
+
#
|
467
|
+
# # Generates a select field for hours that defaults to the minutes for the time in my_time
|
468
|
+
# # that is named 'stride' rather than 'second'
|
469
|
+
# select_hour(my_time, :field_name => 'stride')
|
470
|
+
#
|
471
|
+
# # Generates a select field for hours with a custom prompt. Use :prompt => true for a
|
472
|
+
# # generic prompt.
|
473
|
+
# select_hour(13, :prompt =>'Choose hour')
|
474
|
+
#
|
475
|
+
def select_hour(datetime, options = {}, html_options = {})
|
476
|
+
DateTimeSelector.new(datetime, options, html_options).select_hour
|
477
|
+
end
|
478
|
+
|
479
|
+
# Returns a select tag with options for each of the days 1 through 31 with the current day selected.
|
480
|
+
# The <tt>date</tt> can also be substituted for a hour number.
|
481
|
+
# Override the field name using the <tt>:field_name</tt> option, 'day' by default.
|
482
|
+
#
|
483
|
+
# ==== Examples
|
484
|
+
# my_date = Time.today + 2.days
|
485
|
+
#
|
486
|
+
# # Generates a select field for days that defaults to the day for the date in my_date
|
487
|
+
# select_day(my_time)
|
488
|
+
#
|
489
|
+
# # Generates a select field for days that defaults to the number given
|
490
|
+
# select_day(5)
|
491
|
+
#
|
492
|
+
# # Generates a select field for days that defaults to the day for the date in my_date
|
493
|
+
# # that is named 'due' rather than 'day'
|
494
|
+
# select_day(my_time, :field_name => 'due')
|
495
|
+
#
|
496
|
+
# # Generates a select field for days with a custom prompt. Use :prompt => true for a
|
497
|
+
# # generic prompt.
|
498
|
+
# select_day(5, :prompt => 'Choose day')
|
499
|
+
#
|
500
|
+
def select_day(date, options = {}, html_options = {})
|
501
|
+
DateTimeSelector.new(date, options, html_options).select_day
|
502
|
+
end
|
503
|
+
|
504
|
+
# Returns a select tag with options for each of the months January through December with the current month
|
505
|
+
# selected. The month names are presented as keys (what's shown to the user) and the month numbers (1-12) are
|
506
|
+
# used as values (what's submitted to the server). It's also possible to use month numbers for the presentation
|
507
|
+
# instead of names -- set the <tt>:use_month_numbers</tt> key in +options+ to true for this to happen. If you
|
508
|
+
# want both numbers and names, set the <tt>:add_month_numbers</tt> key in +options+ to true. If you would prefer
|
509
|
+
# to show month names as abbreviations, set the <tt>:use_short_month</tt> key in +options+ to true. If you want
|
510
|
+
# to use your own month names, set the <tt>:use_month_names</tt> key in +options+ to an array of 12 month names.
|
511
|
+
# Override the field name using the <tt>:field_name</tt> option, 'month' by default.
|
512
|
+
#
|
513
|
+
# ==== Examples
|
514
|
+
# # Generates a select field for months that defaults to the current month that
|
515
|
+
# # will use keys like "January", "March".
|
516
|
+
# select_month(Date.today)
|
517
|
+
#
|
518
|
+
# # Generates a select field for months that defaults to the current month that
|
519
|
+
# # is named "start" rather than "month"
|
520
|
+
# select_month(Date.today, :field_name => 'start')
|
521
|
+
#
|
522
|
+
# # Generates a select field for months that defaults to the current month that
|
523
|
+
# # will use keys like "1", "3".
|
524
|
+
# select_month(Date.today, :use_month_numbers => true)
|
525
|
+
#
|
526
|
+
# # Generates a select field for months that defaults to the current month that
|
527
|
+
# # will use keys like "1 - January", "3 - March".
|
528
|
+
# select_month(Date.today, :add_month_numbers => true)
|
529
|
+
#
|
530
|
+
# # Generates a select field for months that defaults to the current month that
|
531
|
+
# # will use keys like "Jan", "Mar".
|
532
|
+
# select_month(Date.today, :use_short_month => true)
|
533
|
+
#
|
534
|
+
# # Generates a select field for months that defaults to the current month that
|
535
|
+
# # will use keys like "Januar", "Marts."
|
536
|
+
# select_month(Date.today, :use_month_names => %w(Januar Februar Marts ...))
|
537
|
+
#
|
538
|
+
# # Generates a select field for months with a custom prompt. Use :prompt => true for a
|
539
|
+
# # generic prompt.
|
540
|
+
# select_month(14, :prompt => 'Choose month')
|
541
|
+
#
|
542
|
+
def select_month(date, options = {}, html_options = {})
|
543
|
+
DateTimeSelector.new(date, options, html_options).select_month
|
544
|
+
end
|
545
|
+
|
546
|
+
# Returns a select tag with options for each of the five years on each side of the current, which is selected.
|
547
|
+
# The five year radius can be changed using the <tt>:start_year</tt> and <tt>:end_year</tt> keys in the
|
548
|
+
# +options+. Both ascending and descending year lists are supported by making <tt>:start_year</tt> less than or
|
549
|
+
# greater than <tt>:end_year</tt>. The <tt>date</tt> can also be substituted for a year given as a number.
|
550
|
+
# Override the field name using the <tt>:field_name</tt> option, 'year' by default.
|
551
|
+
#
|
552
|
+
# ==== Examples
|
553
|
+
# # Generates a select field for years that defaults to the current year that
|
554
|
+
# # has ascending year values
|
555
|
+
# select_year(Date.today, :start_year => 1992, :end_year => 2007)
|
556
|
+
#
|
557
|
+
# # Generates a select field for years that defaults to the current year that
|
558
|
+
# # is named 'birth' rather than 'year'
|
559
|
+
# select_year(Date.today, :field_name => 'birth')
|
560
|
+
#
|
561
|
+
# # Generates a select field for years that defaults to the current year that
|
562
|
+
# # has descending year values
|
563
|
+
# select_year(Date.today, :start_year => 2005, :end_year => 1900)
|
564
|
+
#
|
565
|
+
# # Generates a select field for years that defaults to the year 2006 that
|
566
|
+
# # has ascending year values
|
567
|
+
# select_year(2006, :start_year => 2000, :end_year => 2010)
|
568
|
+
#
|
569
|
+
# # Generates a select field for years with a custom prompt. Use :prompt => true for a
|
570
|
+
# # generic prompt.
|
571
|
+
# select_year(14, :prompt => 'Choose year')
|
572
|
+
#
|
573
|
+
def select_year(date, options = {}, html_options = {})
|
574
|
+
DateTimeSelector.new(date, options, html_options).select_year
|
575
|
+
end
|
576
|
+
end
|
577
|
+
|
578
|
+
class DateTimeSelector #:nodoc:
|
579
|
+
extend ActiveSupport::Memoizable
|
580
|
+
include ActionView::Helpers::TagHelper
|
581
|
+
|
582
|
+
DEFAULT_PREFIX = 'date'.freeze unless const_defined?('DEFAULT_PREFIX')
|
583
|
+
POSITION = {
|
584
|
+
:year => 1, :month => 2, :day => 3, :hour => 4, :minute => 5, :second => 6
|
585
|
+
}.freeze unless const_defined?('POSITION')
|
586
|
+
|
587
|
+
def initialize(datetime, options = {}, html_options = {})
|
588
|
+
@options = options.dup
|
589
|
+
@html_options = html_options.dup
|
590
|
+
@datetime = datetime
|
591
|
+
end
|
592
|
+
|
593
|
+
def select_datetime
|
594
|
+
# TODO: Remove tag conditional
|
595
|
+
# Ideally we could just join select_date and select_date for the tag case
|
596
|
+
if @options[:tag] && @options[:ignore_date]
|
597
|
+
select_time
|
598
|
+
elsif @options[:tag]
|
599
|
+
order = date_order.dup
|
600
|
+
order -= [:hour, :minute, :second]
|
601
|
+
|
602
|
+
@options[:discard_year] ||= true unless order.include?(:year)
|
603
|
+
@options[:discard_month] ||= true unless order.include?(:month)
|
604
|
+
@options[:discard_day] ||= true if @options[:discard_month] || !order.include?(:day)
|
605
|
+
@options[:discard_minute] ||= true if @options[:discard_hour]
|
606
|
+
@options[:discard_second] ||= true unless @options[:include_seconds] && !@options[:discard_minute]
|
607
|
+
|
608
|
+
# If the day is hidden and the month is visible, the day should be set to the 1st so all month choices are
|
609
|
+
# valid (otherwise it could be 31 and february wouldn't be a valid date)
|
610
|
+
if @datetime && @options[:discard_day] && !@options[:discard_month]
|
611
|
+
@datetime = @datetime.change(:day => 1)
|
612
|
+
end
|
613
|
+
|
614
|
+
[:day, :month, :year].each { |o| order.unshift(o) unless order.include?(o) }
|
615
|
+
order += [:hour, :minute, :second] unless @options[:discard_hour]
|
616
|
+
|
617
|
+
build_selects_from_types(order)
|
618
|
+
else
|
619
|
+
"#{select_date}#{@options[:datetime_separator]}#{select_time}"
|
620
|
+
end
|
621
|
+
end
|
622
|
+
|
623
|
+
def select_date
|
624
|
+
order = date_order.dup
|
625
|
+
|
626
|
+
# TODO: Remove tag conditional
|
627
|
+
if @options[:tag]
|
628
|
+
@options[:discard_hour] = true
|
629
|
+
@options[:discard_minute] = true
|
630
|
+
@options[:discard_second] = true
|
631
|
+
|
632
|
+
@options[:discard_year] ||= true unless order.include?(:year)
|
633
|
+
@options[:discard_month] ||= true unless order.include?(:month)
|
634
|
+
@options[:discard_day] ||= true if @options[:discard_month] || !order.include?(:day)
|
635
|
+
|
636
|
+
# If the day is hidden and the month is visible, the day should be set to the 1st so all month choices are
|
637
|
+
# valid (otherwise it could be 31 and february wouldn't be a valid date)
|
638
|
+
if @datetime && @options[:discard_day] && !@options[:discard_month]
|
639
|
+
@datetime = @datetime.change(:day => 1)
|
640
|
+
end
|
641
|
+
end
|
642
|
+
|
643
|
+
[:day, :month, :year].each { |o| order.unshift(o) unless order.include?(o) }
|
644
|
+
|
645
|
+
build_selects_from_types(order)
|
646
|
+
end
|
647
|
+
|
648
|
+
def select_time
|
649
|
+
order = []
|
650
|
+
|
651
|
+
# TODO: Remove tag conditional
|
652
|
+
if @options[:tag]
|
653
|
+
@options[:discard_month] = true
|
654
|
+
@options[:discard_year] = true
|
655
|
+
@options[:discard_day] = true
|
656
|
+
@options[:discard_second] ||= true unless @options[:include_seconds]
|
657
|
+
|
658
|
+
order += [:year, :month, :day] unless @options[:ignore_date]
|
659
|
+
end
|
660
|
+
|
661
|
+
order += [:hour, :minute]
|
662
|
+
order << :second if @options[:include_seconds]
|
663
|
+
|
664
|
+
build_selects_from_types(order)
|
665
|
+
end
|
666
|
+
|
667
|
+
def select_second
|
668
|
+
if @options[:use_hidden] || @options[:discard_second]
|
669
|
+
build_hidden(:second, sec) if @options[:include_seconds]
|
670
|
+
else
|
671
|
+
build_options_and_select(:second, sec)
|
672
|
+
end
|
673
|
+
end
|
674
|
+
|
675
|
+
def select_minute
|
676
|
+
if @options[:use_hidden] || @options[:discard_minute]
|
677
|
+
build_hidden(:minute, min)
|
678
|
+
else
|
679
|
+
build_options_and_select(:minute, min, :step => @options[:minute_step])
|
680
|
+
end
|
681
|
+
end
|
682
|
+
|
683
|
+
def select_hour
|
684
|
+
if @options[:use_hidden] || @options[:discard_hour]
|
685
|
+
build_hidden(:hour, hour)
|
686
|
+
else
|
687
|
+
build_options_and_select(:hour, hour, :end => 23)
|
688
|
+
end
|
689
|
+
end
|
690
|
+
|
691
|
+
def select_day
|
692
|
+
if @options[:use_hidden] || @options[:discard_day]
|
693
|
+
build_hidden(:day, day)
|
694
|
+
else
|
695
|
+
build_options_and_select(:day, day, :start => 1, :end => 31, :leading_zeros => false)
|
696
|
+
end
|
697
|
+
end
|
698
|
+
|
699
|
+
def select_month
|
700
|
+
if @options[:use_hidden] || @options[:discard_month]
|
701
|
+
build_hidden(:month, month)
|
702
|
+
else
|
703
|
+
month_options = []
|
704
|
+
1.upto(12) do |month_number|
|
705
|
+
options = { :value => month_number }
|
706
|
+
options[:selected] = "selected" if month == month_number
|
707
|
+
month_options << content_tag(:option, month_name(month_number), options) + "\n"
|
708
|
+
end
|
709
|
+
build_select(:month, month_options.join)
|
710
|
+
end
|
711
|
+
end
|
712
|
+
|
713
|
+
def select_year
|
714
|
+
if !@datetime || @datetime == 0
|
715
|
+
val = ''
|
716
|
+
middle_year = Date.today.year
|
717
|
+
else
|
718
|
+
val = middle_year = year
|
719
|
+
end
|
720
|
+
|
721
|
+
if @options[:use_hidden] || @options[:discard_year]
|
722
|
+
build_hidden(:year, val)
|
723
|
+
else
|
724
|
+
options = {}
|
725
|
+
options[:start] = @options[:start_year] || middle_year - 5
|
726
|
+
options[:end] = @options[:end_year] || middle_year + 5
|
727
|
+
options[:step] = options[:start] < options[:end] ? 1 : -1
|
728
|
+
options[:leading_zeros] = false
|
729
|
+
|
730
|
+
build_options_and_select(:year, val, options)
|
731
|
+
end
|
732
|
+
end
|
733
|
+
|
734
|
+
private
|
735
|
+
%w( sec min hour day month year ).each do |method|
|
736
|
+
define_method(method) do
|
737
|
+
@datetime.kind_of?(Fixnum) ? @datetime : @datetime.send(method) if @datetime
|
738
|
+
end
|
739
|
+
end
|
740
|
+
|
741
|
+
# Returns translated month names, but also ensures that a custom month
|
742
|
+
# name array has a leading nil element
|
743
|
+
def month_names
|
744
|
+
month_names = @options[:use_month_names] || translated_month_names
|
745
|
+
month_names.unshift(nil) if month_names.size < 13
|
746
|
+
month_names
|
747
|
+
end
|
748
|
+
memoize :month_names
|
749
|
+
|
750
|
+
# Returns translated month names
|
751
|
+
# => [nil, "January", "February", "March",
|
752
|
+
# "April", "May", "June", "July",
|
753
|
+
# "August", "September", "October",
|
754
|
+
# "November", "December"]
|
755
|
+
#
|
756
|
+
# If :use_short_month option is set
|
757
|
+
# => [nil, "Jan", "Feb", "Mar", "Apr", "May", "Jun",
|
758
|
+
# "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"]
|
759
|
+
def translated_month_names
|
760
|
+
begin
|
761
|
+
key = @options[:use_short_month] ? :'date.abbr_month_names' : :'date.month_names'
|
762
|
+
I18n.translate(key, :locale => @options[:locale])
|
763
|
+
end
|
764
|
+
end
|
765
|
+
|
766
|
+
# Lookup month name for number
|
767
|
+
# month_name(1) => "January"
|
768
|
+
#
|
769
|
+
# If :use_month_numbers option is passed
|
770
|
+
# month_name(1) => 1
|
771
|
+
#
|
772
|
+
# If :add_month_numbers option is passed
|
773
|
+
# month_name(1) => "1 - January"
|
774
|
+
def month_name(number)
|
775
|
+
if @options[:use_month_numbers]
|
776
|
+
number
|
777
|
+
elsif @options[:add_month_numbers]
|
778
|
+
"#{number} - #{month_names[number]}"
|
779
|
+
else
|
780
|
+
month_names[number]
|
781
|
+
end
|
782
|
+
end
|
783
|
+
|
784
|
+
def date_order
|
785
|
+
@options[:order] || translated_date_order
|
786
|
+
end
|
787
|
+
memoize :date_order
|
788
|
+
|
789
|
+
def translated_date_order
|
790
|
+
begin
|
791
|
+
I18n.translate(:'date.order', :locale => @options[:locale]) || []
|
792
|
+
end
|
793
|
+
end
|
794
|
+
|
795
|
+
# Build full select tag from date type and options
|
796
|
+
def build_options_and_select(type, selected, options = {})
|
797
|
+
build_select(type, build_options(selected, options))
|
798
|
+
end
|
799
|
+
|
800
|
+
# Build select option html from date value and options
|
801
|
+
# build_options(15, :start => 1, :end => 31)
|
802
|
+
# => "<option value="1">1</option>
|
803
|
+
# <option value=\"2\">2</option>
|
804
|
+
# <option value=\"3\">3</option>..."
|
805
|
+
def build_options(selected, options = {})
|
806
|
+
start = options.delete(:start) || 0
|
807
|
+
stop = options.delete(:end) || 59
|
808
|
+
step = options.delete(:step) || 1
|
809
|
+
leading_zeros = options.delete(:leading_zeros).nil? ? true : false
|
810
|
+
|
811
|
+
select_options = []
|
812
|
+
start.step(stop, step) do |i|
|
813
|
+
value = leading_zeros ? sprintf("%02d", i) : i
|
814
|
+
tag_options = { :value => value }
|
815
|
+
tag_options[:selected] = "selected" if selected == i
|
816
|
+
select_options << content_tag(:option, value, tag_options)
|
817
|
+
end
|
818
|
+
select_options.join("\n") + "\n"
|
819
|
+
end
|
820
|
+
|
821
|
+
# Builds select tag from date type and html select options
|
822
|
+
# build_select(:month, "<option value="1">January</option>...")
|
823
|
+
# => "<select id="post_written_on_2i" name="post[written_on(2i)]">
|
824
|
+
# <option value="1">January</option>...
|
825
|
+
# </select>"
|
826
|
+
def build_select(type, select_options_as_html)
|
827
|
+
select_options = {
|
828
|
+
:id => input_id_from_type(type),
|
829
|
+
:name => input_name_from_type(type)
|
830
|
+
}.merge(@html_options)
|
831
|
+
select_options.merge!(:disabled => 'disabled') if @options[:disabled]
|
832
|
+
|
833
|
+
select_html = "\n"
|
834
|
+
select_html << content_tag(:option, '', :value => '') + "\n" if @options[:include_blank]
|
835
|
+
select_html << prompt_option_tag(type, @options[:prompt]) + "\n" if @options[:prompt]
|
836
|
+
select_html << select_options_as_html.to_s
|
837
|
+
|
838
|
+
content_tag(:select, select_html, select_options) + "\n"
|
839
|
+
end
|
840
|
+
|
841
|
+
# Builds a prompt option tag with supplied options or from default options
|
842
|
+
# prompt_option_tag(:month, :prompt => 'Select month')
|
843
|
+
# => "<option value="">Select month</option>"
|
844
|
+
def prompt_option_tag(type, options)
|
845
|
+
default_options = {:year => false, :month => false, :day => false, :hour => false, :minute => false, :second => false}
|
846
|
+
|
847
|
+
case options
|
848
|
+
when Hash
|
849
|
+
prompt = default_options.merge(options)[type.to_sym]
|
850
|
+
when String
|
851
|
+
prompt = options
|
852
|
+
else
|
853
|
+
prompt = I18n.translate(('datetime.prompts.' + type.to_s).to_sym, :locale => @options[:locale])
|
854
|
+
end
|
855
|
+
|
856
|
+
prompt ? content_tag(:option, prompt, :value => '') : ''
|
857
|
+
end
|
858
|
+
|
859
|
+
# Builds hidden input tag for date part and value
|
860
|
+
# build_hidden(:year, 2008)
|
861
|
+
# => "<input id="post_written_on_1i" name="post[written_on(1i)]" type="hidden" value="2008" />"
|
862
|
+
def build_hidden(type, value)
|
863
|
+
tag(:input, {
|
864
|
+
:type => "hidden",
|
865
|
+
:id => input_id_from_type(type),
|
866
|
+
:name => input_name_from_type(type),
|
867
|
+
:value => value
|
868
|
+
}) + "\n"
|
869
|
+
end
|
870
|
+
|
871
|
+
# Returns the name attribute for the input tag
|
872
|
+
# => post[written_on(1i)]
|
873
|
+
def input_name_from_type(type)
|
874
|
+
prefix = @options[:prefix] || ActionView::Helpers::DateTimeSelector::DEFAULT_PREFIX
|
875
|
+
prefix += "[#{@options[:index]}]" if @options.has_key?(:index)
|
876
|
+
|
877
|
+
field_name = @options[:field_name] || type
|
878
|
+
if @options[:include_position]
|
879
|
+
field_name += "(#{ActionView::Helpers::DateTimeSelector::POSITION[type]}i)"
|
880
|
+
end
|
881
|
+
|
882
|
+
@options[:discard_type] ? prefix : "#{prefix}[#{field_name}]"
|
883
|
+
end
|
884
|
+
|
885
|
+
# Returns the id attribute for the input tag
|
886
|
+
# => "post_written_on_1i"
|
887
|
+
def input_id_from_type(type)
|
888
|
+
input_name_from_type(type).gsub(/([\[\(])|(\]\[)/, '_').gsub(/[\]\)]/, '')
|
889
|
+
end
|
890
|
+
|
891
|
+
# Given an ordering of datetime components, create the selection HTML
|
892
|
+
# and join them with their appropriate separators.
|
893
|
+
def build_selects_from_types(order)
|
894
|
+
select = ''
|
895
|
+
order.reverse.each do |type|
|
896
|
+
separator = separator(type) unless type == order.first # don't add on last field
|
897
|
+
select.insert(0, separator.to_s + send("select_#{type}").to_s)
|
898
|
+
end
|
899
|
+
select
|
900
|
+
end
|
901
|
+
|
902
|
+
# Returns the separator for a given datetime component
|
903
|
+
def separator(type)
|
904
|
+
case type
|
905
|
+
when :month, :day
|
906
|
+
@options[:date_separator]
|
907
|
+
when :hour
|
908
|
+
(@options[:discard_year] && @options[:discard_day]) ? "" : @options[:datetime_separator]
|
909
|
+
when :minute
|
910
|
+
@options[:time_separator]
|
911
|
+
when :second
|
912
|
+
@options[:include_seconds] ? @options[:time_separator] : ""
|
913
|
+
end
|
914
|
+
end
|
915
|
+
end
|
916
|
+
|
917
|
+
class InstanceTag #:nodoc:
|
918
|
+
def to_date_select_tag(options = {}, html_options = {})
|
919
|
+
datetime_selector(options, html_options).select_date.html_safe!
|
920
|
+
end
|
921
|
+
|
922
|
+
def to_time_select_tag(options = {}, html_options = {})
|
923
|
+
datetime_selector(options, html_options).select_time.html_safe!
|
924
|
+
end
|
925
|
+
|
926
|
+
def to_datetime_select_tag(options = {}, html_options = {})
|
927
|
+
datetime_selector(options, html_options).select_datetime.html_safe!
|
928
|
+
end
|
929
|
+
|
930
|
+
private
|
931
|
+
def datetime_selector(options, html_options)
|
932
|
+
datetime = value(object) || default_datetime(options)
|
933
|
+
|
934
|
+
options = options.dup
|
935
|
+
options[:field_name] = @method_name
|
936
|
+
options[:include_position] = true
|
937
|
+
options[:prefix] ||= @object_name
|
938
|
+
options[:index] = @auto_index if @auto_index && !options.has_key?(:index)
|
939
|
+
options[:datetime_separator] ||= ' — '
|
940
|
+
options[:time_separator] ||= ' : '
|
941
|
+
|
942
|
+
DateTimeSelector.new(datetime, options.merge(:tag => true), html_options)
|
943
|
+
end
|
944
|
+
|
945
|
+
def default_datetime(options)
|
946
|
+
return if options[:include_blank] || options[:prompt]
|
947
|
+
|
948
|
+
case options[:default]
|
949
|
+
when nil
|
950
|
+
Time.current
|
951
|
+
when Date, Time
|
952
|
+
options[:default]
|
953
|
+
else
|
954
|
+
default = options[:default].dup
|
955
|
+
|
956
|
+
# Rename :minute and :second to :min and :sec
|
957
|
+
default[:min] ||= default[:minute]
|
958
|
+
default[:sec] ||= default[:second]
|
959
|
+
|
960
|
+
time = Time.current
|
961
|
+
|
962
|
+
[:year, :month, :day, :hour, :min, :sec].each do |key|
|
963
|
+
default[key] ||= time.send(key)
|
964
|
+
end
|
965
|
+
|
966
|
+
Time.utc_time(
|
967
|
+
default[:year], default[:month], default[:day],
|
968
|
+
default[:hour], default[:min], default[:sec]
|
969
|
+
)
|
970
|
+
end
|
971
|
+
end
|
972
|
+
end
|
973
|
+
|
974
|
+
class FormBuilder
|
975
|
+
def date_select(method, options = {}, html_options = {})
|
976
|
+
@template.date_select(@object_name, method, objectify_options(options), html_options)
|
977
|
+
end
|
978
|
+
|
979
|
+
def time_select(method, options = {}, html_options = {})
|
980
|
+
@template.time_select(@object_name, method, objectify_options(options), html_options)
|
981
|
+
end
|
982
|
+
|
983
|
+
def datetime_select(method, options = {}, html_options = {})
|
984
|
+
@template.datetime_select(@object_name, method, objectify_options(options), html_options)
|
985
|
+
end
|
986
|
+
end
|
987
|
+
end
|
988
|
+
end
|