Deep Linking

Construct a Link to a Specific Post

To deep link to a specific post you can add #tickaroo_event_id=EVENT_ID to url of your page. This will only be evaluated once when a liveblog initializes.

Moving to a Specific Post via Javascript

You can also move to a specific post via the javascript API. the following exmaple illustrates this:

<script async src="https://cdn.tickaroo.com/webng/embedjs/tik4.js"></script>
<tickaroo-liveblog id="my-liveblog" liveblogId="LIVEBLOG_ID" clientId="CLIENT_ID"></tickaroo-liveblog>

<script>
  function onClickSomeNavigation() {
    document.getElementById('my-liveblog').navigateToEventId('EVENTID');
  }
</script>

Configure Deep Linking Behaviour

Deep linking behaviour depends on how deep the specific post really is:

  • If the post is already on the page, the widget will just scroll to it
  • If it is not on the page but within a certain range below the current window, the widget will just load all posts until the specific post and then scroll to it. How far this behaviour goes can be controlled via the deepLinkLimit parameter. Social media embeds and images in the loaded posts can still change height after the jump. The widget keeps the target post in place for up to 10 s after the jump, and stops as soon as the reader scrolls. Embeds in many loaded posts can keep changing height for longer than that, so if you use a lot of social media, setting a very low deepLinkLimit or even 0 is advisable.
  • If the post is too far down or if it is above the current window the widget will do a complete reload and show a new window of posts including the specific post. By default the target post will be the first one in the new window. By setting the deepLinkDepth option to a value greater than 0, the widget is instructed to load some posts above the target. When those posts grow as their social media embeds and images load, the widget keeps the target post in place for up to 10 s after the jump, and stops as soon as the reader scrolls.

If your app shows the liveblog in a web view inside a native scroll view or list, the widget cannot scroll to the post by itself. See Scrolling to Posts in Apps for the scroll hook and for deep links from your app.