minor #15280 Adding details about "defer" and legacy jquery (weaverryan)

javiereguiluz · javiereguiluz · commit 9a34c80b7424 · 2021-04-23T17:49:19.000+02:00
This PR was submitted for the 5.2 branch but it was merged into the 4.4 branch instead. Discussion ---------- Adding details about "defer" and legacy jquery Closes symfony/webpack-encore#956 Commits ------- cb199ef Adding details about "defer" and legacy jquery
diff --git a/frontend/encore/legacy-applications.rst b/frontend/encore/legacy-applications.rst
@@ -87,3 +87,18 @@ The ``global`` variable is a special way of setting things in the ``window``
 variable. In a web context, using ``global`` and ``window`` are equivalent,
 except that ``window.jQuery`` won't work when using ``autoProvidejQuery()``.
 In other words, use ``global``.
+
+Additionally, be sure to set the ``script_attributes.defer`` option to ``false``
+in your ``webpack_encore.yaml`` file:
+
+.. code-block:: yaml
+
+    # config/packages/webpack_encore.yaml
+    webpack_encore:
+        script_attributes:
+            defer: false
+
+This will make sure there is *not* a ``defer`` attribute on your ``script``
+tags. For more information, see `Moving <script> inside <head> and the "defer" Attribute`_
+
+.. _`Moving <script> inside <head> and the "defer" Attribute`: https://symfony.com/blog/moving-script-inside-head-and-the-defer-attribute
