Why still using deprecated jQuery(document).ready()?

[alexantr]

yii\web\View uses not recommended way to include scripts in POS_READY section.

jQuery recommends to use

jQuery(function () { /* code */ });

instead

jQuery(document).ready(function () { /* code */ });

Also see in jQuery docs:

There is also $(document).on( "ready", handler ), deprecated as of jQuery 1.8 and removed in jQuery 3.0. Note that if the DOM becomes ready before this event is attached, the handler will not be executed.

One more thing. You can pass jQuery object to handler with $:

jQuery(function ($) {
    // using $ here will be safely even jQuery.noConflict() will be enabled
});

And one more thing. To use $ safely in POS_LOAD section construction jQuery(window).on('load', function () { }); can be placed into jQuery(function ($) { });:

jQuery(function ($) {
    $(window).on('load', function () {
        // POS_LOAD scripts. Can use $
    });
    // POS_READY scripts
});

Additional info

Q	A
Yii version	2.0.*
PHP version	5.4-7.x
Operating system	all

[klimov-paul]

Relates #13839

[SilverFire]

Related to #14338

[SilverFire]

Resolved by 3a8feb1

[klimov-paul]

Complete removal of the JQuery.ready() looks pretty odd: this method still exists at jQuery library and I do not see any note about its been deprecated.
Would not its usage removal break particular JS code?

[alexantr]

My mistake. Only .on("ready", handler) deprecated and removed in 3.0, not .ready(handler).
But anyway short syntax $(handler) is equivalent:

jQuery offers several ways to attach a function that will run when the DOM is ready. All of the following syntaxes are equivalent:
$( handler )
$( document ).ready( handler )
$( "document" ).ready( handler )
$( "img" ).ready( handler )
$().ready( handler )

[gpcaretti]

@alexantr

My mistake. Only .on("ready", handler) deprecated and removed in 3.0,
not .ready(handler). But anyway short syntax $(handler) is equivalent:
$( handler )
$( document ).ready( handler )

This is not correct. The jquery document continues (see here):
"As of jQuery 3.0, only the first syntax is recommended; the other syntaxes still work but are deprecated."

[Shashimii]

This issue helped me understanding jquery syntax 👍