Link

Component Information

Component Title Link
Description Displays a link as a primary, secondary, or tertiary link/CTA
Location /apps/ehi-core/aem65/components/content/link/v1/link
sling:resourceSuperType N/A
Supported AEM Versions 6.5
Editing Mode inPlaceEdit
Component Group Cheerios Experience

 


Extending the Component

The Anchor component is a custom component created for the Cheer.IOs experience.  It was not extended from a WCM Core component.

Extending the components can be done in multiple ways depending on the needs of the brand component.

 

Use this approach if you do not have any required html markup changes or backend java changes. This will only update the title of the component, componentGroup and point to the resourceSuperType. Optionally can extend the description.

  1. Change .content.xml file properties 
  2. sling:resourceSuperType to point to the Cheer.IOs component [required]
  3. jcr:title - new Component title
  4. componentGroup - Brand specific Group [required]
  5. jcr:description - Helpful description

 

 

Use this approach if you need to update css classes or add data attributes and do not need to change the backend model, or potentially want to use a different model by retain all of the markup in the component-tmpl.html (Component Template) markup.

  1. Follow steps in Extend the Component - Basic
  2. Extend the file i.e. extend-example-option2.html
  3. Update file with new properties
  4. Update the html file with desired changes

 

 

The component template is usually named component-tmpl.html this file contains the html markup. Update this file if you need to change the html structure of the component.

  1. Follow Steps in Extend Component Basic
  2. Extend the file component.html to point to the new component-tmpl.html file
  3. Extend the file i.e. component-tmpl.html
  4. Update file with new markup

 

 

Use this approach if you need to change the Sling Model to update the backend logic.

Files that will need to be added when extending:

  1. Follow Steps in Extend Component - Basic
  2. Java Interface - this will implement the model with the new methods (if needed)
  3. Sling Model - this will implement the Java Interface from step 1 and leverage the sling delegation pattern to override the original methods
  4. The component.html file to match the new component name

It is possible to extend more than just the component.html file, if necessary any file that is resourceSupertyped can be extend for example if something needs added to the dialog.

This gives us the flexibility to change our classes or add attributes easily.  Say I want to add new javascript I can easily target a different data attribute to trigger my javascript.


Configuration Properties

Edit Dialog Properties

The following properties are written to JCR for this Link component and are expected to be available as Resource properties:

  1. ./label - Text of the link.
  2. ./link - Link to a content page, external URL, page anchor, asset, etc.
  3. ./target - Sets the location where the link opens. Selkect 'New Tab' when linking to an external site.
  4. ./style - Each type should be used only once starting with Primary. The selected type will determine the display of the link. (primary, secondary, tertiary)

 


Visual Example


Component Demo

  1. jcr:primaryType: nt:unstructured
  2. jcr:createdBy: E524Z2
  3. jcr:lastModifiedBy: E524Z2
  4. target: _blank
  5. jcr:created:
  6. link: https://confluence.ehi.com/display/AEMDEV/Cheerios+Link+Component
  7. label: Text Link Example
  8. style: cmp-link__link--primary
  9. jcr:lastModified:
  10. sling:resourceType: ehi-core/aem65/components/content/link/v1/link