Optional acceleratorEnable keyboard shortcuts for devtools, zoom, reload, and reload ignoring cache.
Optional alphaTurns anything of matching RGB value transparent.
Caveats:
Optional alwaysfalse
Always position the window at the top of the window stack.
Optional apiConfigurations for API injection.
Optional applicationuse icon instead.
Optional aspect0
The aspect ratio of width to height to enforce for the window. If this value is equal to or less than zero, an aspect ratio will not be enforced.
Optional autoAutomatically show the window when it is created.
Optional autoplayAutoplay policy to apply to content in the window, can be
no-user-gesture-required, user-gesture-required,
document-user-activation-required. Defaults to no-user-gesture-required.
Optional backgroundThe window’s backfill color as a hexadecimal value. Not to be confused with the content background color
(document.body.style.backgroundColor),
this color briefly fills a window’s (a) content area before its content is loaded as well as (b) newly exposed
areas when growing a window. Setting
this value to the anticipated content background color can help improve user experience.
Default is white.
Optional closetrue
Toggling off would keep the Window alive even if all its Views were closed.
This is meant for advanced users and should be used with caution.
Limitations - Once a Layout has been emptied out of all views it's not usable anymore, and certain API calls will fail.
Use layout.replace to create a fresh Layout instance in case you want to populate it with Views again.
** note ** - This option is ignored in non-Platforms apps.
Optional contentConfigures how new content (e,g, from window.open or a link) is opened.
Optional contentRestrict navigation to URLs that match a whitelisted pattern. In the lack of a whitelist, navigation to URLs that match a blacklisted pattern would be prohibited. See here for more details.
Optional contentRestrict redirects to URLs that match a whitelisted pattern. In the lack of a whitelist, redirects to URLs that match a blacklisted pattern would be prohibited. See here for more details.
Optional contextSuperseded by contextMenuOptions, which offers a larger feature-set and cleaner syntax.
true
Show the context menu when right-clicking on the window. Gives access to the devtools for the window.
Optional contextConfigure the context menu when right-clicking on a window.
Optional contextSuperseded by contextMenuOptions, which offers a larger feature-set and cleaner syntax.
Configure the context menu when right-clicking on a window.
Optional cornerDefines and applies rounded corners for a frameless window. NOTE: On macOS corner is not ellipse but circle rounded by the average of height and width.
Optional customA field that the user can use to attach serializable data that will be saved when Platform#getSnapshot Platform.getSnapshot is called. If a window in a Platform is trying to update or retrieve its own context, it can use the Platform#setWindowContext Platform.setWindowContext and Platform#getWindowContext Platform.getWindowContext calls. When omitted, inherits from the parent application. As opposed to customData, this is meant for frequent updates and sharing with other contexts. [Example]{@tutorial customContext}
Optional customA field that the user can attach serializable data to be ferried around with the window options. When omitted, inherits from the parent application.
Optional customCustom headers for requests sent by the window.
Optional defaultCenters the window in the primary monitor. This option overrides defaultLeft and defaultTop. When saveWindowState is true,
this value will be ignored for subsequent launches in favor of the cached value. NOTE: On macOS defaultCenter is
somewhat above center vertically.
Optional default500
The default height of the window. When saveWindowState is true, this value will be ignored for subsequent launches
in favor of the cached value.
Optional default100
The default left position of the window. When saveWindowState is true, this value will be ignored for subsequent
launches in favor of the cached value.
Optional default100
The default top position of the window. When saveWindowState is true, this value will be ignored for subsequent
launches in favor of the cached value.
Optional default800
The default width of the window. When saveWindowState is true, this value will be ignored for subsequent
launches in favor of the cached value.
Optional experimentalOptional fdc3Optional frametrue
Show the window's frame.
Optional heightOptional hidefalse
Hides the window instead of closing it when the close button is pressed.
Optional hotkeysDefines the hotkeys that will be emitted as a hotkey event on the window. For usage example see [example]{@tutorial hotkeys}.
Within Platform, OpenFin also implements a set of pre-defined actions called
[keyboard commands]https://developers.openfin.co/docs/platform-api#section-5-3-using-keyboard-commands
that can be assigned to a specific hotkey in the platform manifest.
Optional iconA URL for the icon to be shown in the window title bar and the taskbar. When omitted, inherits from the parent application._ note: Window OS caches taskbar icons, therefore an icon change might only be visible after the cache is removed or the uuid is changed.
Optional ignoreIgnores the cached state of the window.
Defaults the opposite value of saveWindowState to maintain backwards compatibility.
Optional includetrue
Include window in snapshots returned by Platform.getSnapshot(). Turning this off may be desirable when dealing with inherently temporary windows whose state shouldn't be preserved, such as modals, menus, or popups.
Optional interopOptional layoutOptional max-1
The maximum height of a window. Will default to the OS defined value if set to -1.
Optional max-1
The maximum width of a window. Will default to the OS defined value if set to -1.
Optional maximizabletrue
Allows the window to be maximized.
Optional min0
The minimum height of the window.
Optional mintrue
The minimum width of the window.
Optional minimizabletrue
Allows the window to be minimized.
Optional modalParent identity of a modal window. It will create a modal child window when this option is set.
Optional nameThe name of the window.
Optional opacity1
A flag that specifies how transparent the window will be.
Changing opacity doesn't work on Windows 7 without Aero so setting this value will have no effect there.
This value is clamped between 0.0 and 1.0.
In software composition mode, the runtime flag --allow-unsafe-compositing is required.
Optional permissionsOptional preloadScripts that run before page load. When omitted, inherits from the parent application.
Optional processString tag that attempts to group like-tagged renderers together. Will only be used if pages are on the same origin.
Optional reasonOptional resizabletrue
A flag to allow the user to resize the window.
Optional resizeDefines a region in pixels that will respond to user mouse interaction for resizing a frameless window.
Optional savetrue
Caches the location of the window. Note: this option is ignored in Platforms as it would cause inconsistent Platform#applySnapshot applySnapshot behavior.
Optional shadowfalse
Displays a shadow on frameless windows.
shadow and cornerRounding are mutually exclusive.
On Windows 7, Aero theme is required.
Optional showfalse
Platforms Only. If true, will show background images in the layout when the Views are hidden. This occurs when the window is resizing or a tab is being dragged within the layout.
Optional showtrue
Shows the window's icon in the taskbar.
Optional smallfalse
Makes this window a frameless window that can be created and resized to less than 41x36 px (width x height).
Note: Caveats of small windows are no Aero Snap and drag to/from maximize.
Windows 10: Requires maximizable to be false. Resizing with the mouse is only possible down to 38x39 px.
Optional state"normal"
The visible state of the window on creation. One of:
"maximized""minimized""normal"Optional taskbaricon instead.Optional taskbarSpecify a taskbar group for the window.
If omitted, defaults to app's uuid (fin.Application.getCurrentSync().identity.uuid).
Optional updateOptional url"about:blank"
The URL of the window
Optional uuidThe uuid of the application, unique within the set of all Applications running in OpenFin Runtime.
If omitted, defaults to the uuid of the application spawning the window.
If given, must match the uuid of the application spawning the window.
In other words, the application's uuid is the only acceptable value, but is the default, so there's
really no need to provide it.
Optional viewPlatform Windows Only. Controls behavior for showing views when they are being resized by the user.
Optional waitfalse
When set to true, the window will not appear until the window object's load event fires.
When set to false, the window will appear immediately without waiting for content to be loaded.
Optional widthWorkspacePlatform specific window options. These options will not work unless a workspace platform has been initialized.
For internal usage. Defaults to 'browser' when Browser is enabled when the WorkspacePlatform is initialized. In order to use
non-Browser layout windows ('platform' windows) in a Browser-enabled workspace platform, set windowType to platform. In that instance, the other properties
in the workspacePlatform object are not relevant.
Optional xOptional y
Request for creating a browser window.