Add API Navigator.Listener.onJumpToLocator()

[mickael-menu]

Added

Navigator

• The new Navigator.Listener.onJumpToLocator() API is called every time the navigator jumps to an explicit location, which might break the linear reading progression.
  • For example, it is called when clicking on internal links or programmatically calling Navigator.go(), but not when turning pages.
  • You can use this callback to implement a navigation history by differentiating between continuous and discontinuous moves.

---

Note: This is a quickfix for the shortcomings of the current Navigator API which can't be used to build a navigation history. In the future navigator I think we should emit more information about a navigation event, such as the source (link clicked, go() call, page turned, skip forward, etc.).

[qnga]

Maybe you should be more explicit about the callback: it is called if the move is intended to be discontinuous, though it could turn out to be continuous or no move.

[mickael-menu]

Maybe you should be more explicit about the callback: it is called if the move is intended to be discontinuous, though it could turn out to be continuous or no move.

It doesn't really matter, the idea is that the user triggered an action that breaks the continuous flow of progression, but it could end up in the same page or go to the next one.

Do you have any alternative for the API name that could better represent that?

[qnga]

Oh no, I was thinking only about documentation, since I wondered about that and had to look at the code to get the answer.

[mickael-menu]

I see, I will try to clarify it tomorrow 👍

[mickael-menu]

@qnga Is it clearer?

[qnga]

Yes!