links.html.twig in Zircon Profile 8
Same filename in this branch
Same filename and directory in other branches
Theme override for a set of links.
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.
- link_key: The link CSS class.
- 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
24 theme calls to links.html.twig
- AjaxTestController::dialog in core/
modules/ system/ tests/ modules/ ajax_test/ src/ Controller/ AjaxTestController.php - Returns a render array of form elements and links for dialog.
- book_node_links_alter in core/
modules/ book/ book.module - Implements hook_node_links_alter().
- CommentLazyBuilders::buildLinks in core/
modules/ comment/ src/ CommentLazyBuilders.php - Build the default links (reply, edit, delete …) for a comment.
- CommentLazyBuilders::renderLinks in core/
modules/ comment/ src/ CommentLazyBuilders.php - #lazy_builder callback; builds a comment's links.
- CommentLinkBuilder::buildCommentedEntityLinks in core/
modules/ comment/ src/ CommentLinkBuilder.php - Builds links for the given entity.
File
core/themes/stable/templates/navigation/links.html.twigView source
- {#
- /**
- * @file
- * Theme override for a set of links.
- *
- * 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.
- * - link_key: The link CSS class.
- * - 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 template_preprocess_links()
- */
- #}
- {% if links -%}
- {%- if heading -%}
- {%- if heading.level -%}
- <{{ heading.level }}{{ heading.attributes }}>{{ heading.text }}</{{ heading.level }}>
- {%- else -%}
- <h2{{ heading.attributes }}>{{ heading.text }}</h2>
- {%- endif -%}
- {%- endif -%}
- <ul{{ attributes }}>
- {%- for key, item in links -%}
- <li{{ item.attributes.addClass(key|clean_class) }}>
- {%- if item.link -%}
- {{ item.link }}
- {%- elseif item.text_attributes -%}
- <span{{ item.text_attributes }}>{{ item.text }}</span>
- {%- else -%}
- {{ item.text }}
- {%- endif -%}
- </li>
- {%- endfor -%}
- </ul>
- {%- endif %}