Better explanations of the use cases for AfterNavigationListener and AfterNavigationObserver

Tell us about your request

AfterNavigationEvent documentation leaves a confusion for readers between AfterNavigationObserver and AfterNavigationListener.

Despite this article has a technically correct explanation for how to add them and what's their order, it should highlight the essential difference between them:

• observers are implemented by component class and being active only when this component is attached to UI;
• listeners are added to UI instance without a need to implement any interface or override a method.

Observers are "per component" and Listeners are "per UI", i.e. invoked before any found observer.

Hopefully these key point, if placed in the very beginning of this chapter, would help readers which interface to use for particular component Java class and which to use for any navigation.

If you think this issue is important, add a 👍 reaction to help the community and maintainers prioritize this issue.

Start with the AfterNavigationEvent documentation linked in the issue and locate the section explaining AfterNavigationObserver and AfterNavigationListener. Clarify at the beginning that observers are component-scoped while listeners are UI-scoped and run before observers; done means readers can choose the appropriate interface for a component or for navigation generally.