Index

Layouts v1 API is deprecated and no longer supported as of OpenFin 16+. Please use Platform API instead.

Index

Functions

deregister

  • Allows a window to opt-out of this service.

    This will disable all layouts-related functionality for the given window.

    Multiple windows can be deregistered at once by using regex patterns on identity.uuid/identity.name.

    This API can be used to programmatically override configuration set at an app-wide level, such as in the application manifest.

    import {deregister} from 'openfin-layouts';
    
    // De-register the current window
    deregister();
    
    // De-register a single named window
    deregister({uuid: 'my-uuid', name: 'window'});
    
    // De-register multiple windows belonging to the same application
    deregister({uuid: 'my-uuid', name: {expression: 'popup-.*'}});
    
    // De-register all windows belonging to an application, not matching a pattern
    deregister({uuid: 'my-uuid', name: {expression: 'interactive-.*', invert: true}});

    Parameters

    • Default value identity: IdentityRule = getId() as IdentityRule

      The window (or pattern of windows) to deregister, defaults to the current window

    Returns Promise<void>

register

  • Allows a window to opt-in back to this service if previously deregistered.

    This will enable all layouts-related functionality for the given window unless alternative behaviors are set in the layout configuration.

    This API can be used to programmatically override configuration set at an app-wide level, such as in the application manifest.

    This API is provided to complement deregister, to allow programmatic override of default service behavior or configuration specified in an application manifest. This API is not required or intended for initial opt-in of your application to the service, which is achieved through the "services" attribute within an application manifest.

    import {register} from 'openfin-layouts';
    
    // Register the current window
    register();
    
    // Register a single named window
    register({uuid: 'my-uuid', name: 'window'});
    
    // Register multiple windows belonging to the same application
    register({uuid: 'my-uuid', name: {expression: 'interactive-.*'}});
    
    // Register all windows belonging to an application, not matching a pattern
    register({uuid: 'my-uuid', name: {expression: 'popup-.*', invert: true}});

    Parameters

    • Default value identity: IdentityRule = getId() as IdentityRule

      The window (or pattern of windows) to register, defaults to the current window

    Returns Promise<void>