Minor tweaks

Author: javiereguiluz

doc/events.rst

@@ -80,44 +80,43 @@ property of the ``BlogPost`` entity before persisting it:
 JavaScript Events
 -----------------
 
-EasyAdmin triggers some `JavaScript events`_ when the user interacts with entity forms:
+EasyAdmin triggers several `JavaScript events`_ during user interactions with entity forms:
 
 ================================  ==============================================  ================================  ==========
 Event type                        Occurs when                                     Event detail                      Cancelable
 ================================  ==============================================  ================================  ==========
 ``'ea.form.error'``               User submits a form that has validation errors  ``{page: pageName, form: form}``  true
---------------------------------  ----------------------------------------------  --------------------------  ----------
+--------------------------------  ----------------------------------------------  --------------------------        ----------
 ``'ea.form.submit'``              User submits a form                             ``{page: pageName, form: form}``  true
 --------------------------------  ----------------------------------------------  --------------------------------  ----------
 ``'ea.collection.item-added'``    Item added to collection                        ``{newElement: element}``         false
 --------------------------------  ----------------------------------------------  --------------------------------  ----------
 ``'ea.collection.item-removed'``  Item removed from collection                                                      false
 ================================  ==============================================  ================================  ==========
 
-(see `CustomEvent: detail property
-<https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent/detail>`_ for
-details on "Event detail" and `Event: cancelable property
-<https://developer.mozilla.org/en-US/docs/Web/API/Event/cancelable>`_ for
-details on "Cancelable".)
+.. tip::
 
-Example usage:
+    Read more about the `detail property`_ and the `cancelable property`_
+    of JavaScript events.
 
-  .. code-block:: javascript
+Here's how you can listen for these events in JavaScript:
 
-     document.addEventListener('ea.form.error', (event) => {
-       const {page, form} = event.detail
-       alert(`The ${page} form contains errors. Please resolve these before submitting again.`)
-     })
+.. code-block:: javascript
 
-     document.addEventListener('ea.form.submit', (event) => {
-       const {page, form} = event.detail
-       console.debug(`${page} form submitted`, form)
-     })
+    document.addEventListener('ea.form.error', (event) => {
+        const {page, form} = event.detail
+        alert(`The ${page} form contains errors. Please resolve these before submitting again.`)
+    });
 
-See :doc:`Collection Field JavaScript Events
-</fields/CollectionField#javascript-events>` for details on and example use of
-the ``'ea.collection.*'`` events.
+    document.addEventListener('ea.form.submit', (event) => {
+        const {page, form} = event.detail
+        console.debug(`${page} form submitted`, form)
+    });
 
+For more details and examples of the ``ea.collection.*`` events, see the
+:doc:`Collection Field JavaScript Events </fields/CollectionField#javascript-events>` section.
 
 .. _`Symfony events`: https://symfony.com/doc/current/event_dispatcher.html
 .. _`JavaScript events`: https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Building_blocks/Events
+.. _`detail property`: https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent/detail
+.. _`cancelable property`: https://developer.mozilla.org/en-US/docs/Web/API/Event/cancelable

doc/fields/CollectionField.rst

@@ -198,27 +198,27 @@ class name of the controller as the first argument::
 JavaScript Events
 -----------------
 
-When an item is added to a collection field, a `CustomEvent
-<https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent>`_ with type
-``'ea.collection.item-added'`` is dispatched, and when an item is removed, an
-`Event <https://developer.mozilla.org/en-US/docs/Web/API/Event/Event>`_ with
-type ``'ea.collection.item-removed'`` dispatched.
+When an item is added to a collection field, a `CustomEvent`_ with the type
+``'ea.collection.item-added'`` is dispatched. Similarly, when an item is removed,
+an `Event`_ with the type ``'ea.collection.item-removed'`` is dispatched.
 
 The ``'ea.collection.item-added'`` event contains information about the added
-item in the `detail property
-<https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent/detail>`_:
+item in the `detail property`_:
 
-  .. code-block:: javascript
+.. code-block:: javascript
 
-     document.addEventListener('ea.collection.item-added', (event) => {
-       const {newElement} = event.detail
-       console.debug(newElement, 'added to collection')
-     })
+    document.addEventListener('ea.collection.item-added', (event) => {
+        const {newElement} = event.detail
+        console.debug(newElement, 'added to collection')
+    });
 
-     document.addEventListener('ea.collection.item-removed', (event) => {
-       // Do something with the event
-       console.debug('item removed from collection')
-     })
+    document.addEventListener('ea.collection.item-removed', (event) => {
+        // Do something with the event
+        console.debug('item removed from collection')
+    });
 
 .. _`CollectionType`: https://symfony.com/doc/current/reference/forms/types/collection.html
 .. _`documentation about Symfony CollectionType options`: https://symfony.com/doc/current/reference/forms/types/collection.html#field-options
+.. _`CustomEvent`: https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent
+.. _`Event`: https://developer.mozilla.org/en-US/docs/Web/API/Event/Event
+.. _`detail property`: https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent/detail