Anchor

Component Information

Component Title Anchor
Description The anchor tag allows us to create a hyperlink to a specific part of the page. 
Location /apps/ehi-core/aem65/components/content/anchor/v1/anchor
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

Edit Dialog Properties

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

  1. ./anchorName - defines the Anchor link

 


Visual Example


CSS / JavaScript Implementation

JavaScript / CSS information.


Component Demo

Fully Configured

Description of component being demoed.   

Note: You will not see the anchor.  To test, scroll to the to the top of the page and then type #anchortest at the end of the URL.  It should take you down to the anchor.

  1. jcr:primaryType: nt:unstructured
  2. jcr:createdBy: E524Z2
  3. jcr:lastModifiedBy: E524Z2
  4. anchorID: anchortest
  5. jcr:created:
  6. jcr:lastModified:
  7. sling:resourceType: ehi-core/aem65/components/content/anchor/v1/anchor