link.twig

{#
/**
 * @file
 * Link component.
 *
 * Variables:
 * - theme: [string] Theme: light, dark.
 * - text: [string] Link text.
 * - url: [string] URL.
 * - title: [string] Title of a link.
 * - is_new_window: [boolean] Open in a new window.
 * - is_external: [boolean] Link is external.
 * - is_active [boolean] Link is active.
 * - is_disabled: [boolean] Disabled state.
 * - icon: [string] Icon name.
 * - icon_placement: [string] Icon position: before, after.
 * - icon_group_disabled: [boolean] Disable icon and last word grouping.
 * - icon_single_only: [boolean] Only show 1 icon. If icon and is_external, external will take preference.
 * - attributes: [string] Additional attributes.
 * - modifier_class: [string] Additional classes.
 */
#}

{%- set text = text|default('') -%}
{%- set only_icon_class = icon is not empty and text is empty ? 'ct-link--only-icon' : '' -%}
{%- set icon_placement = icon_placement in ['before', 'after'] ? icon_placement : 'after' -%}
{%- set is_external_class = is_external ? 'ct-link--external' : '' -%}
{%- set is_active_class = is_active ? 'ct-link--active' : '' -%}
{%- set is_disabled_class = is_disabled ? 'ct-link--disabled' : '' -%}
{%- set theme_class = 'ct-theme-%s'|format(theme|default('light')) -%}
{%- set modifier_class = '%s %s %s %s %s %s'|format(theme_class, is_external_class, is_active_class, is_disabled_class, only_icon_class, modifier_class|default(''))|trim -%}
{%- set attributes = is_disabled ? attributes ~ ' disabled' : attributes -%}

{%- if text is not empty or icon is not empty -%}
  {%- set link_content -%}
    {%- include '@base/text-icon/text-icon.twig' with {
      text: text,
      is_new_window: is_new_window,
      is_external: is_external,
      icon: icon,
      icon_placement: icon_placement,
      icon_class: 'ct-link__icon',
      icon_group_disabled: icon_group_disabled|default(false),
      icon_single_only: icon_single_only|default(false),
    } only -%}
  {%- endset -%}

  <a
    class="ct-link {{ modifier_class -}}"
    {% if url is not empty %}href="{{ url }}"{% endif %}
    {% if title is not empty %}title="{{ title }}"{% endif %}
    {% if is_new_window %}target="_blank"{% endif %}
    {% if is_disabled %}disabled{% endif %}
    {% if attributes is not empty %}{{- attributes|raw -}}{% endif %}
  >
    {{- link_content -}}
  </a>
{%- endif -%}