Class VisibilityApi

java.lang.Object
com.oorian.html.js.JavaScriptApi
com.oorian.html.js.visibility.VisibilityApi

public class VisibilityApi extends JavaScriptApi
Provides access to the browser's Page Visibility API from server-side Java code.

This class wraps the browser's Page Visibility API, enabling server-side code to be notified when the page becomes visible or hidden (e.g., when the user switches tabs).

Usage:


 public class DashboardPage extends HtmlPage implements VisibilityListener
 {
     @Override
     protected void createBody(Body body)
     {
         VisibilityApi.startListening(this);
     }

     @Override
     public void onEvent(VisibilityChangeEvent event)
     {
         if (event.isVisible())
         {
             // Resume updates
         }
         else
         {
             // Pause updates to save resources
         }
     }
 }
 
Author:
Marvin P. Warble Jr.
See Also:
  • Constructor Details

    • VisibilityApi

      public VisibilityApi()
  • Method Details

    • startListening

      public static void startListening(VisibilityListener listener)
      Starts listening for visibility changes using the current page context.
      Parameters:
      listener - The listener that will receive visibility events.
    • startListening

      public static void startListening(HtmlPage page, VisibilityListener listener)
      Starts listening for visibility changes.
      Parameters:
      page - The page context.
      listener - The listener that will receive visibility events.
    • stopListening

      public static void stopListening()
      Stops listening for visibility changes using the current page context.
    • stopListening

      public static void stopListening(HtmlPage page)
      Stops listening for visibility changes.
      Parameters:
      page - The page context.