minor #20505 [Security] Add docs for is_granted_for_user() function (Nate Wiebe)

This PR was merged into the 7.3 branch.

Discussion
----------

[Security] Add docs for `is_granted_for_user()` function

Fixes #20489

Adds docs for new twig function:
* symfony/symfony#59129

Commits
-------

e1c23c7 Add docs for is_granted_for_user() function

Author: javiereguiluz

reference/twig_reference.rst

@@ -174,6 +174,27 @@ Returns ``true`` if the current user has the given role.
 Optionally, an object can be passed to be used by the voter. More information
 can be found in :ref:`security-template`.
 
+is_granted_for_user
+~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: twig
+
+    {{ is_granted_for_user(user, attribute, subject = null, field = null) }}
+
+``user``
+    **type**: ``object``
+``attribute``
+    **type**: ``string``
+``subject`` *(optional)*
+    **type**: ``object``
+``field`` *(optional)*
+    **type**: ``string``
+
+Returns ``true`` if the user is authorized for the specified attribute.
+
+Optionally, an object can be passed to be used by the voter. More information
+can be found in :ref:`security-template`.
+
 logout_path
 ~~~~~~~~~~~
 

security.rst

@@ -2549,6 +2549,17 @@ the built-in ``is_granted()`` helper function in any Twig template:
 
 .. _security-isgranted:
 
+Similarly, if you want to check if a specific user has a certain role, you can use
+the built-in ``is_granted_for_user()`` helper function:
+
+.. code-block:: html+twig
+
+    {% if is_granted_for_user(user, 'ROLE_ADMIN') %}
+        <a href="...">Delete</a>
+    {% endif %}
+
+.. _security-isgrantedforuser:
+
 Securing other Services
 .......................