You are here

Home » API reference » Media Library Theme Reset 8

links--media-library-menu.html.twig in Media Library Theme Reset 8

Theme implementation of the media type menu in the media library dialog.

Available variables:

  • attributes: Attributes for the UL containing the list of links.
  • links: Links to be output. Each link will have the following elements:

    • title: The link text.
    • href: The link URL. If omitted, the 'title' is shown as a plain text item in the links list. If 'href' is supplied, the entire link is passed to l() as its $options parameter.
    • attributes: (optional) HTML attributes for the anchor, or for the <span> tag if no 'href' is supplied.
  • heading: (optional) A heading to precede the links.
    • text: The heading text.
    • level: The heading level (e.g. 'h2', 'h3').
    • attributes: (optional) A keyed list of attributes for the heading.

    If the heading is a string, it will be used as the text of the heading and the level will default to 'h2'.

Headings should be used on navigation menus and any list of links that consistently appears on multiple pages. To make the heading invisible use the 'visually-hidden' CSS class. Do not use 'display:none', which removes it from screen readers and assistive technology. Headings allow screen reader and keyboard only users to navigate to or skip the links. See http://juicystudio.com/article/screen-readers-display-none.php and http://www.w3.org/TR/WCAG-TECHS/H42.html for more information.

See also

classy_preprocess_links__media_library_menu()

template_preprocess_links()

File

templates/links--media-library-menu.html.twig
View source 
  1. {% extends "links.html.twig" %}

  2. {#

  3. /**

  4.  * @file

  5.  * Theme implementation of the media type menu in the media library dialog.

  6.  *

  7.  * Available variables:

  8.  * - attributes: Attributes for the UL containing the list of links.

  9.  * - links: Links to be output.

  10.  *   Each link will have the following elements:

  11.  *   - title: The link text.

  12.  *   - href: The link URL. If omitted, the 'title' is shown as a plain text

  13.  *     item in the links list. If 'href' is supplied, the entire link is passed

  14.  *     to l() as its $options parameter.

  15.  *   - attributes: (optional) HTML attributes for the anchor, or for the <span>

  16.  *     tag if no 'href' is supplied.

  17.  * - heading: (optional) A heading to precede the links.

  18.  *   - text: The heading text.

  19.  *   - level: The heading level (e.g. 'h2', 'h3').

  20.  *   - attributes: (optional) A keyed list of attributes for the heading.

  21.  *   If the heading is a string, it will be used as the text of the heading and

  22.  *   the level will default to 'h2'.

  23.  *

  24.  *   Headings should be used on navigation menus and any list of links that

  25.  *   consistently appears on multiple pages. To make the heading invisible use

  26.  *   the 'visually-hidden' CSS class. Do not use 'display:none', which

  27.  *   removes it from screen readers and assistive technology. Headings allow

  28.  *   screen reader and keyboard only users to navigate to or skip the links.

  29.  *   See http://juicystudio.com/article/screen-readers-display-none.php and

  30.  *   http://www.w3.org/TR/WCAG-TECHS/H42.html for more information.

  31.  *

  32.  * @see classy_preprocess_links__media_library_menu()

  33.  * @see template_preprocess_links()

  34.  */

  35. #}

  36. {% set attributes = attributes.addClass('media-library-menu') %}