My Group: This user has no roles.

My Distribution ID: Please log in to see your distribution ID.
Open TOC

Page Contents

 


Navigating Single Page Applications like NIVOMAX Web Viewer

Disclaimer

SYNAXIOM does not distribute NIVOMAX Viewer setup files directly to end users. To obtain the necessary setup files, users must download a copy directly from the Technical Publications Supplier's NIVOMAX Self Serve portal, subsequent to agreeing to the terms and conditions stipulated therein. The Technical Publication Supplier, possessing a valid Distribution ID for their copy of the NIVOMAX Applications, is the sole distributor. Access to and use of the NIVOMAX Viewer is contingent upon the purchase of a Data License for a digital product from the Technical Publications Supplier. The digital product downloaded will function exclusively with the viewer provided by the respective Supplier. Users are advised that the distribution of NIVOMAX Viewer setup files may be governed by applicable export control regulations depending on their region.

Licensing

It is not necessary for end-users to purchase a separate NIVOMAX license. The Technical Publications Supplier from whom you have acquired your Data License has already procured the requisite licenses from SYNAXIOM. By extending an invitation, they include you within their authorized user pool, as permitted under their NIVOMAX license agreement. You are authorized to use the NIVOMAX software provided the Technical Publications Supplier maintains a valid NIVOMAX software license.

Confidentiality

This document (“Document”) contains confidential and proprietary information owned by SYNAXIOM Inc. (“SYNAXIOM”). No part of this Document may be reproduced, copied, or distributed in any form or by any means without the prior written permission of SYNAXIOM Inc. Unauthorized use, disclosure, or reproduction of this Document is strictly prohibited. Any third-party intellectual property mentioned herein is the property of their respective owners, and such mention is for informational purposes only and does not imply any association with or endorsement by the owners.

This page must not be removed before distributing the document. It must remain present in all shared copies to ensure proper communication and compliance.

Navigating Single Page Applications like NIVOMAX Web Viewer

Last Updated on July 16, 2024 | 3 min read


The Importance of Using Toolbar Icons in NIVOMAX Viewer Apps for back/ forward navigation

Understanding Single Page Applications (SPAs)

Single Page Applications (SPAs) have revolutionized the way we interact with web applications by providing a smoother and faster user experience. SPAs like the NIVOMAX Viewer apps load a single HTML page and dynamically update the content without requiring the page to reload. This approach differs significantly from traditional multi-page websites, affecting how navigation should be handled. This article explains the nature of SPAs and why it is crucial for users to utilize the navigation tools provided within the application, such as toolbar icons, instead of relying on the browser’s native navigation buttons.

Differences Between SPAs and Traditional Websites

Unlike traditional websites, where each page corresponds to a new HTML document, SPAs manage all their views on a single page. As a result, the traditional browser navigation buttons—back and forward—do not inherently understand the virtual routes created by SPAs unless specifically programmed to do so. This is where the challenge lies; if the SPA’s internal state management and routing are not perfectly aligned with the browser’s history API, using these browser buttons can lead to unexpected behaviors, such as:

  • Loading an initial state of the application instead of the previous state.
  • Not reflecting changes that happened in a session if they were not pushed to the history stack.
  • Causing errors or inconsistent states if the application relies on certain data being available that the browser does not maintain.

The Role of Toolbar Icons in NIVOMAX Viewer Apps

In applications like the NIVOMAX Viewer, which are designed to handle complex data and interactions across a dual viewing pane setup and multiple content tabs on each viewing pane within a single workspace, navigation is a critical component. The application includes  the Main Toolbar with back and forward icons specifically designed to navigate through the app’s internal state and data views. Here’s why users should use these icons:

  • State Management: These icons are integrated with the application’s state management logic, ensuring that all state transitions are handled correctly. This means that any data changes, view adjustments, or context-specific information are preserved during navigation.
  • Consistency and Reliability: Using the provided toolbar icons for navigation avoids the pitfalls of the browser’s history mechanism, which might not always be aware of the internal state changes or the specific needs of the SPA.
  • Enhanced User Experience: The toolbar is tailored to fit the workflow and specific functionalities of the NIVOMAX Viewer, offering a more intuitive and controlled way to navigate through the application.

Conclusion

For users of SPAs like the NIVOMAX Viewer, relying on the application-specific navigation tools such as toolbar icons is essential for maintaining a consistent and error-free experience. These tools are designed to seamlessly interact with the SPA’s architecture, ensuring that each navigation action is recorded and executed correctly within the application’s ecosystem. Therefore, it is recommended to use these provided navigation aids instead of the browser’s native back and forward buttons to avoid any disruptions in the application’s operation. By doing so, users can fully leverage the dynamic and responsive nature of SPAs.


For the latest documentation on this and other important topics, please refer to the NIVOMAX Help Center. The NIVOMAX Help Center is your primary resource for up-to-date information, guidelines, and self-serve support for NIVOMAX.

This document also has an online version which may be more up-to-date.


CONFIDENTIAL

This document is the property of SYNAXIOM Inc.