Click events are used to create custom navigation from items or annotations in your story to other web accessible content and locations. Often users use click-events from a 'dashboard' or 'portal' view within their story, to link to other views and related stories.

The default behaviour when an item is clicked is for it to open up to reveal the panels of content inside. Any item/annotation can be assigned a click event that changes the default behaviour to be navigation to another place within the story, in another story or any other location.

The click event can navigate you:

  • Another story
  • In a specific view in the current story or another story
  • To a specific item in the current story or another story
  • To a specific presentation in the current story or another story
  • To a form that exists in the story or another story
  • To an external website, file, or any URL location

Creating a Click Event for Items:

When a click event is added onto an item, the hover-over border colour will become blue, compared to the default of white/black, or other colour if using an Enterprise solution.

Adding a click event is simple and can be achieved by:

  1. Select the item that a click event needs to be added to
  2. Open the Edit Panel on the right-hand side
  3. Navigate to the Click Event sub-tab
  4. Either paste the target location into the Click Event tab or select a view to link to

Creating a Click Event for an Annotation:

Annotations are a great feature that is used extensively for dashboards or landing pages in SharpCloud to provide custom navigation in a story.

To add a Click Event to an Annotation, simply follow:

  1. Open the Widget Panel on the right-hand side
  2. Select the Annotation that the Click Event needs to be added to.
  3. Access the Advanced Settings
  4. Paste in the Target URL or select a view to navigate to

With Annotations, the hover-over colour can be customised, unlike items, providing additional flexibility.

Absolute and Relative URL’s

When using URL’s for Click Events, it is worth noting the difference between using an absolute URL and a relative URL.

Click events can be expressed as full absolute URLs or as relative references to SharpCloud views, presentations, or items (elements) within the current story.

By using relative URLs, the click event will always refer to the specified view, item, or presentation within the current story. This is most helpful when stories are being moved between SharpCloud instances as uploaded stories are allocated a new, unique story ID.

Example of an absolute reference:

https://my.sharpcloud.com/html/#/story/2b59969e-9c48-46c2-b947-8c4a7f375345/view/e47c3c62-5450-4c75-b45b-6bd697ead4a1

Example of a relative reference:

/view/e47c3c62-5450-4c75-b45b-6bd697ead4a1