CHANGELOG.md 16.9 KB
Newer Older
1
## Rails 4.0.0 (unreleased) ##
J
José Valim 已提交
2

3 4 5 6 7
*   When building a URL fails, add missing keys provided by Journey. Failed URL
    generation now returns a 500 status instead of a 404.

    *Richard Schneeman*

8 9 10 11 12 13 14 15 16 17 18 19 20 21
*   Deprecate availbility of ActionView::RecordIdentifier in controllers by default.
    It's view specific and can be easily included in controller manually if someone
    really needs it. RecordIdentifier will be removed from ActionController::Base
    in Rails 4.1 *Piotr Sarnacki*

*   Fix ActionView::RecordIdentifier to work as a singleton *Piotr Sarnacki*

*   Deprecate Template#mime_type, it will be removed in Rails 4.1 in favor of #type.
    *Piotr Sarnacki*

*   Move vendored html-scanner from action_controller to action_view directory. If you
    require it directly, please use 'action_view/vendor/html-scanner', reference to
    'action_controller/vendor/html-scanner' will be removed in Rails 4.1 *Piot Sarnacki*

22 23 24 25 26
*   Fix handling of date selects when using both disabled and discard options.
    Fixes #7431.

    *Vasiliy Ermolovich*

27 28 29 30
*   `ActiveRecord::SessionStore` is extracted out of Rails into a gem `activerecord-session_store`.
    Setting `config.session_store` to `:active_record_store` will no longer work and will break
    if the `activerecord-session_store` gem isn't available. *Prem Sichanugrist*

31 32 33 34 35
*   Fix select_tag when option_tags is nil.
    Fixes #7404.

    *Sandeep Ravichandran*

36 37 38 39
*   Add Request#formats=(extensions) that lets you set multiple formats directly in a prioritized order *DHH*

    Example of using this for custom iphone views with an HTML fallback:

40 41 42 43 44 45 46 47
        class ApplicationController < ActionController::Base
          before_filter :adjust_format_for_iphone_with_html_fallback

          private
            def adjust_format_for_iphone_with_html_fallback
              request.formats = [ :iphone, :html ] if request.env["HTTP_USER_AGENT"][/iPhone/]
            end
        end
48 49


50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77
*   Add Routing Concerns to declare common routes that can be reused inside
    others resources and routes.

    Code before:

        resources :messages do
          resources :comments
        end

        resources :posts do
          resources :comments
          resources :images, only: :index
        end

    Code after:

        concern :commentable do
          resources :comments
        end

        concern :image_attachable do
          resources :images, only: :index
        end

        resources :messages, concerns: :commentable

        resources :posts, concerns: [:commentable, :image_attachable]

78
    *DHH + Rafael Mendonça França*
79

80 81
*   Add start_hour and end_hour options to the select_hour helper. *Evan Tann*

82 83 84 85 86
*   Raises an ArgumentError when the first argument in `form_for` contain `nil`
    or is empty.

    *Richard Schneeman*

87 88 89
*   Add 'X-Frame-Options' => 'SAMEORIGIN'
    'X-XSS-Protection' => '1; mode=block' and
    'X-Content-Type-Options' => 'nosniff'
90 91 92 93
    as default headers.

    *Egor Homakov*

94 95
*   Allow data attributes to be set as a first-level option for form_for, so you can write `form_for @record, data: { behavior: 'autosave' }` instead of `form_for @record, html: { data: { behavior: 'autosave' } }` *DHH*

96 97 98 99
*   Deprecate `button_to_function` and `link_to_function` helpers.

    We recommend the use of Unobtrusive JavaScript instead. For example:

100
        link_to "Greeting", "#", :class => "nav_link"
101

102 103 104
        $(function() {
          $('.nav_link').click(function() {
            // Some complex code
105

106 107
            return false;
          });
108 109 110 111
        });

    or

112
        link_to "Greeting", '#', onclick: "alert('Hello world!'); return false", class: "nav_link"
113 114 115 116 117

    for simple cases.

    *Rafael Mendonça França*

118 119
*   `javascript_include_tag :all` will now not include `application.js` if the file does not exists. *Prem Sichanugrist*

120 121 122 123
*   Send an empty response body when call `head` with status between 100 and 199, 204, 205 or 304.

    *Armand du Plessis*

124 125
*   Fixed issue with where Digest authentication would not work behind a proxy. *Arthur Smith*

A
Aaron Patterson 已提交
126 127 128
*   Added ActionController::Live.  Mix it in to your controller and you can
    stream data to the client live.  For example:

129 130
        class FooController < ActionController::Base
          include ActionController::Live
A
Aaron Patterson 已提交
131

132 133 134 135 136 137 138 139
          def index
            100.times {
              # Client will see this as it's written
              response.stream.write "hello world\n"
              sleep 1
            }
            response.stream.close
          end
A
Aaron Patterson 已提交
140 141
        end

S
Santiago Pastorino 已提交
142 143
*   Remove ActionDispatch::Head middleware in favor of Rack::Head. *Santiago Pastorino*

144
*   Deprecate `:confirm` in favor of `:data => { :confirm => "Text" }` option for `button_to`, `button_tag`, `image_submit_tag`, `link_to` and `submit_tag` helpers.
145

146
    *Carlos Galdino + Rafael Mendonça França*
147

148
*   Show routes in exception page while debugging a `RoutingError` in development. *Richard Schneeman and Mattt Thompson*
149

K
kennyj 已提交
150 151 152 153 154 155
*   Add `ActionController::Flash.add_flash_types` method to allow people to register their own flash types. e.g.:

        class ApplicationController
          add_flash_types :error, :warning
        end

156
    If you add the above code, you can use `<%= error %>` in an erb, and `redirect_to /foo, :error => 'message'` in a controller.
K
kennyj 已提交
157 158 159

    *kennyj*

160 161
*   Remove Active Model dependency from Action Pack. *Guillermo Iguaran*

162 163 164 165 166 167 168 169 170 171
*   Support unicode characters in routes. Route will be automatically escaped, so instead of manually escaping:

        get Rack::Utils.escape('こんにちは') => 'home#index'

    You just have to write the unicode route:

        get 'こんにちは' => 'home#index'

    *kennyj*

172 173
*   Return proper format on exceptions. *Santiago Pastorino*

174
*   Allow to use `mounted_helpers` (helpers for accessing mounted engines) in `ActionView::TestCase`. *Piotr Sarnacki*
175

176
*   Include `mounted_helpers` (helpers for accessing mounted engines) in `ActionDispatch::IntegrationTest` by default. *Piotr Sarnacki*
177

178 179 180 181
*   Extracted redirect logic from `ActionController::ForceSSL::ClassMethods.force_ssl`  into `ActionController::ForceSSL#force_ssl_redirect`

    *Jeremy Friesen*

182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197
*   Make possible to use a block in button_to helper if button text is hard
    to fit into the name parameter, e.g.:

        <%= button_to [:make_happy, @user] do %>
          Make happy <strong><%= @user.name %></strong>
        <% end %>
        # => "<form method="post" action="/users/1/make_happy" class="button_to">
        #      <div>
        #        <button type="submit">
        #          Make happy <strong>Name</strong>
        #        </button>
        #      </div>
        #    </form>"

    *Sergey Nartimov*

198 199 200 201 202 203 204 205 206 207 208
*   change a way of ordering helpers from several directories. Previously,
    when loading helpers from multiple paths, all of the helpers files were
    gathered into one array an then they were sorted. Helpers from different
    directories should not be mixed before loading them to make loading more
    predictable. The most common use case for such behavior is loading helpers
    from engines. When you load helpers from application and engine Foo, in
    that order, first rails will load all of the helpers from application,
    sorted alphabetically and then it will do the same for Foo engine.

    *Piotr Sarnacki*

209
*   `truncate` now always returns an escaped HTML-safe string. The option `:escape` can be used as
210 211 212 213
    false to not escape the result.

    *Li Ellis Gallardo + Rafael Mendonça França*

214 215
*   `truncate` now accepts a block to show extra content when the text is truncated. *Li Ellis Gallardo*

C
Carlos Galdino 已提交
216 217 218
*   Add `week_field`, `week_field_tag`, `month_field`, `month_field_tag`, `datetime_local_field`,
    `datetime_local_field_tag`, `datetime_field` and `datetime_field_tag` helpers. *Carlos Galdino*

219 220
*   Add `color_field` and `color_field_tag` helpers. *Carlos Galdino*

221 222 223
*   `assert_generates`, `assert_recognizes`, and `assert_routing` all raise
    `Assertion` instead of `RoutingError` *David Chelimsky*

224 225
*   URL path parameters with invalid encoding now raise ActionController::BadRequest. *Andrew White*

226 227
*   Malformed query and request parameter hashes now raise ActionController::BadRequest. *Andrew White*

228 229 230 231
*   Add `divider` option to `grouped_options_for_select` to generate a separator
    `optgroup` automatically, and deprecate `prompt` as third argument, in favor
    of using an options hash. *Nicholas Greenfield*

232 233
*   Add `time_field` and `time_field_tag` helpers which render an `input[type="time"]` tag. *Alex Soulim*

234 235
*   Removed old text_helper apis for highlight, excerpt and word_wrap *Jeremy Walker*

J
José Valim 已提交
236 237 238
*   Templates without a handler extension now raises a deprecation warning but still
    defaults to ERb. In future releases, it will simply return the template contents. *Steve Klabnik*

239
*   Deprecate `:disable_with` in favor of `:data => { :disable_with => "Text" }` option from `submit_tag`, `button_tag` and `button_to` helpers.
240 241 242

    *Carlos Galdino + Rafael Mendonça França*

243 244 245
*   Remove `:mouseover` option from `image_tag` helper. *Rafael Mendonça França*

*   The `select` method (select tag) forces :include_blank  if `required` is true and
246 247
    `display size` is one and `multiple` is not true. *Angelo Capilleri*

248 249 250 251 252
*   Copy literal route constraints to defaults so that url generation know about them.
    The copied constraints are `:protocol`, `:subdomain`, `:domain`, `:host` and `:port`.

    *Andrew White*

J
José Valim 已提交
253 254 255 256
*   `respond_to` and `respond_with` now raise ActionController::UnknownFormat instead
    of directly returning head 406. The exception is rescued and converted to 406
    in the exception handling middleware. *Steven Soroka*

257 258
*   Allows `assert_redirected_to` to match against a regular expression. *Andy Lindeman*

S
Santiago Pastorino 已提交
259 260
*   Add backtrace to development routing error page. *Richard Schneeman*

261 262 263
*   Replace `include_seconds` boolean argument with `:include_seconds => true` option
    in `distance_of_time_in_words` and `time_ago_in_words` signature. *Dmitriy Kiriyenko*

264 265 266
*   Make current object and counter (when it applies) variables accessible when
    rendering templates with :object / :collection. *Carlos Antonio da Silva*

J
José Valim 已提交
267
*   JSONP now uses mimetype application/javascript instead of application/json. *omjokine*
268

269 270
*   Allow to lazy load `default_form_builder` by passing a `String` instead of a constant. *Piotr Sarnacki*

271 272 273 274 275 276 277
*   Session arguments passed to `process` calls in functional tests are now merged into
    the existing session, whereas previously they would replace the existing session.
    This change may break some existing tests if they are asserting the exact contents of
    the session but should not break existing tests that only assert individual keys.

    *Andrew White*

278 279
*   Add `index` method to FormBuilder class. *Jorge Bejar*

280 281
*   Remove the leading \n added by textarea on assert_select. *Santiago Pastorino*

282 283 284 285 286
*   Changed default value for `config.action_view.embed_authenticity_token_in_remote_forms`
    to `false`. This change breaks remote forms that need to work also without javascript,
    so if you need such behavior, you can either set it to `true` or explicitly pass
    `:authenticity_token => true` in form options

287 288
*   Added ActionDispatch::SSL middleware that when included force all the requests to be under HTTPS protocol. *Rafael Mendonça França*

289
*   Add `include_hidden` option to select tag. With `:include_hidden => false` select with `multiple` attribute doesn't generate hidden input with blank value. *Vasiliy Ermolovich*
290

291 292 293 294
*   Removed default `size` option from the `text_field`, `search_field`, `telephone_field`, `url_field`, `email_field` helpers. *Philip Arndt*

*   Removed default `cols` and `rows` options from the `text_area` helper. *Philip Arndt*

295
*   Adds support for layouts when rendering a partial with a given collection. *serabe*
296

297
*   Allows the route helper `root` to take a string argument. For example, `root 'pages#main'`. *bcardarella*
298

299
*   Forms of persisted records use always PATCH (via the `_method` hack). *fxn*
300

301
*   For resources, both PATCH and PUT are routed to the `update` action. *fxn*
302

303 304 305 306 307 308 309 310 311 312 313 314
*   Don't ignore `force_ssl` in development. This is a change of behavior - use a `:if` condition to recreate the old behavior.

        class AccountsController < ApplicationController
          force_ssl :if => :ssl_configured?

          def ssl_configured?
            !Rails.env.development?
          end
        end

    *Pat Allan*

315 316 317 318 319 320 321 322 323 324 325
*   Adds support for the PATCH verb:
      * Request objects respond to `patch?`.
      * Routes have a new `patch` method, and understand `:patch` in the
        existing places where a verb is configured, like `:via`.
      * New method `patch` available in functional tests.
      * If `:patch` is the default verb for updates, edits are
        tunneled as PATCH rather than as PUT, and routing acts accordingly.
      * New method `patch_via_redirect` available in integration tests.

    *dlee*

326 327
*   Integration tests support the `OPTIONS` method. *Jeremy Kemper*

328 329 330
*   `expires_in` accepts a `must_revalidate` flag. If true, "must-revalidate"
    is added to the Cache-Control header. *fxn*

331 332
*   Add `date_field` and `date_field_tag` helpers which render an `input[type="date"]` tag *Olek Janiszewski*

333 334 335 336
*   Adds `image_url`, `javascript_url`, `stylesheet_url`, `audio_url`, `video_url`, and `font_url`
    to assets tag helper. These URL helpers will return the full path to your assets. This is useful
    when you are going to reference this asset from external host. *Prem Sichanugrist*

337 338
*   Default responder will now always use your overridden block in `respond_with` to render your response. *Prem Sichanugrist*

339 340 341 342 343 344 345 346 347 348
*   Allow `value_method` and `text_method` arguments from `collection_select` and
    `options_from_collection_for_select` to receive an object that responds to `:call`,
    such as a `proc`, to evaluate the option in the current element context. This works
    the same way with `collection_radio_buttons` and `collection_check_boxes`.

    *Carlos Antonio da Silva + Rafael Mendonça França*

*   Add `collection_check_boxes` form helper, similar to `collection_select`:
    Example:

349 350 351 352 353 354 355
        collection_check_boxes :post, :author_ids, Author.all, :id, :name
        # Outputs something like:
        <input id="post_author_ids_1" name="post[author_ids][]" type="checkbox" value="1" />
        <label for="post_author_ids_1">D. Heinemeier Hansson</label>
        <input id="post_author_ids_2" name="post[author_ids][]" type="checkbox" value="2" />
        <label for="post_author_ids_2">D. Thomas</label>
        <input name="post[author_ids][]" type="hidden" value="" />
356 357 358 359 360 361 362 363

    The label/check_box pairs can be customized with a block.

    *Carlos Antonio da Silva + Rafael Mendonça França*

*   Add `collection_radio_buttons` form helper, similar to `collection_select`:
    Example:

364 365 366 367 368 369
        collection_radio_buttons :post, :author_id, Author.all, :id, :name
        # Outputs something like:
        <input id="post_author_id_1" name="post[author_id]" type="radio" value="1" />
        <label for="post_author_id_1">D. Heinemeier Hansson</label>
        <input id="post_author_id_2" name="post[author_id]" type="radio" value="2" />
        <label for="post_author_id_2">D. Thomas</label>
370 371 372 373 374

    The label/radio_button pairs can be customized with a block.

    *Carlos Antonio da Silva + Rafael Mendonça França*

375 376 377
*   check_box with `:form` html5 attribute will now replicate the `:form`
    attribute to the hidden field as well. *Carlos Antonio da Silva*

378 379 380
*   Turn off verbose mode of rack-cache, we still have X-Rack-Cache to
    check that info. Closes #5245. *Santiago Pastorino*

381 382
*   `label` form helper accepts :for => nil to not generate the attribute. *Carlos Antonio da Silva*

383 384
*   Add `:format` option to number_to_percentage *Rodrigo Flores*

385
*   Add `config.action_view.logger` to configure logger for ActionView. *Rafael Mendonça França*
386

387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402
*   Deprecated ActionController::Integration in favour of ActionDispatch::Integration

*   Deprecated ActionController::IntegrationTest in favour of ActionDispatch::IntegrationTest

*   Deprecated ActionController::PerformanceTest in favour of ActionDispatch::PerformanceTest

*   Deprecated ActionController::AbstractRequest in favour of ActionDispatch::Request

*   Deprecated ActionController::Request in favour of ActionDispatch::Request

*   Deprecated ActionController::AbstractResponse in favour of ActionDispatch::Response

*   Deprecated ActionController::Response in favour of ActionDispatch::Response

*   Deprecated ActionController::Routing in favour of ActionDispatch::Routing

403 404 405 406
*   check_box helper with :disabled => true will generate a disabled hidden field to conform with the HTML convention where disabled fields are not submitted with the form.
    This is a behavior change, previously the hidden tag had a value of the disabled checkbox.
    *Tadas Tamosauskas*

407 408
*   `favicon_link_tag` helper will now use the favicon in app/assets by default. *Lucas Caton*

409 410
*   `ActionView::Helpers::TextHelper#highlight` now defaults to the
    HTML5 `mark` element. *Brian Cardarella*
411

X
Xavier Noria 已提交
412
Please check [3-2-stable](https://github.com/rails/rails/blob/3-2-stable/actionpack/CHANGELOG.md) for previous changes.