ECL Link component

npm package: @ecl/link

npm install --save @ecl/link

Parameters

• "link" (object) (default: {}):
  • "type" (string) (default: '') Link type; can be '', 'standalone', 'primary', 'primary-highlight', 'primary-neutral', 'secondary', 'secondary-neutral', 'secondary-inverted'
  • "inverted" (boolean) (default: false) Is the link inverted (displayed on dark background)?
  • "branded" (boolean) (default: false) Is the link using brand color (usually dark)?
  • "label" (string) (default: '') Link text content
  • "path" (string) (default: '') Link href attribute
  • "external" (boolean) (default: false) Activates the external link icon
  • "sr_external" (string) (default: '') Additional screen reader label for external icon
  • "aria_label" (string) (default: '') Aria label attribute value
  • "icon_position" (string) (default: 'after') Position of link icon; can be 'before' or 'after'
  • "hide_label" (boolean) (default: false) Hide link label visually (screen reader only); requires an icon
  • "indicator" (object) (default: {}) Indicator component object; only shown when there is an icon and no label
• "icon" (object) OR (array) of objects ECL Icon structure; extra_classes is used internally for positioning
• "extra_classes" (string) (default: '') Extra classes (space separated)
• "extra_attributes" (array) (default: []) Extra attributes
  • "name" (string) Attribute name, eg. 'data-test'
  • "value" (string) Attribute value, eg: 'data-test-1'

Example:

{% include '@ecl/link/link.html.twig' with { 
  link: { 
    type: 'standalone', 
    label: 'Standalone link', 
    path: 'http://google.com', 
    icon_position: 'after' 
    aria_label: 'An aria label' 
  }, 
  icon: {  
    name: 'external', 
    extra_classes: 'my-extra-class-1 my-extra-class-2' 
  }, 
  extra_classes: 'my-extra-class-1 my-extra-class-2', 
  extra_attributes: [ 
    { name: 'data-test', value: 'data-test-value' }, 
    { name: 'data-test-1', value: 'data-test-value-1' } 
  ] 
} %}