Browser Feature Attributes

The following table lists the available attributes for the <BrowserFeatures> record. The Browsers columns indicate the browsers to which the attribute applies.

Attribute

Browsers

Description

Internet Explorer

Firefox

channelmode

X

Specifies whether or not to display the window in “theater mode”, that is, as a maximized window.

When set to "yes", the height, width, top and left values are overridden, the Navigation Bar is hidden, and the Title Bar is visible.

dialog

X

X

Specifies whether or not to display the window as a “dialog”.

• If the WCC/client application is being run locally, and you are using Internet Explorer, the "dialog" attribute must be set to "no" — it can be set to "yes" only if the application is run from a web server. (If you are using Firefox, the "dialog" attribute can be set to "yes" or "no", even if you are running locally.)
• If "dialog" is set to "yes", it behaves differently for external forms than for GI forms, as follows:
— For external forms: if “dialog” = yes, the form opens in a “Webpage” dialog. For information about webpage dialogs, see Dialog/Window Characteristics.
— For GI forms: if “dialog” = yes, the form opens in an “application” dialog. For information about application dialogs, see Dialog/Window Characteristics.

Note - For information about external forms and GI forms, see Form Type.

• If “dialog” = no, the form opens in a separate browser window (this is true for both external forms and GI forms). For information about separate browser windows, see Dialog/Window Characteristics.

directories

X

Specifies whether or not to display the "Personal Toolbar" and the "Bookmarks Toolbar" in Firefox.

Firefox users can force new windows to always render the Personal Toolbar/Bookmarks Toolbar by setting dom.disable_window_open_feature.directories to true in about:config1 or in their user.js file.

location

X

X

Specifies whether or not to display the "Navigation Toolbar" in IE or the "Location Bar" in Firefox.

Firefox users can force new windows to always render the Location Bar by setting dom.disable_window_open_feature.location to true in about:config or in their user.js file.

menubar

X

X

Specifies whether or not the browser window should display a “Menu Bar”.

Firefox users can force new windows to always render the Menu Bar by setting dom.disable_window_open_feature.menubar to true in about:config or in their user.js file.

minimizable

X

Specifies whether or not to allow the browser window to be minimized. This is only applicable when dialog=”yes”, which causes the Maximize and Minimize buttons to not be displayed. Setting minimizable=yes causes both the Maximize and Minimize buttons to be displayed, but the Minimize button is enabled and the Maximize button is disabled.

Also see the dialog attribute above.

resizable

X

Specifies whether or not the browser window can be manually resized using the lower right corner of the window.

Firefox always makes windows resizable.

Note - This attribute may not work as expected. Tests on various systems has shown that on some the window can be resized, while on others, it cannot. The exact cause(s) of the unexpected behavior remains unknown, although it is thought to be a combination of the browser being used, the browser version, and browser security settings.

scrollbars

X

X

Controls the display of scrollbars, on work item forms opened in a separate browser window, when the form content overflows the browser dimensions.

Note that this only applies to GI Forms. When using external forms (ASP, JSP, BusinessWorks FormBuilder, iProcess Modeler), scrollbars will always appear if the form content exceeds the browser dimensions.

status

X

Specifies whether or not the browser window displays a status bar on the bottom of the window.

Firefox always displays the status bar.

toolbar

X

X

Specifies whether or not to display the Toolbar across the top of the window. This bar contains buttons/icons for Back, Forward, Refresh, Home, etc.

In IE, this bar is referred to as the “Command Bar”; and in Firefox, the “Tab Bar”.

Firefox users can force new windows to always render the Tab Bar by setting dom.disable_window_open_feature.toolbar to true in about:config or in their user.js file.

Dialog/Window Characteristics

When a WCC or client application displays a work item form, it displays it either in a preview pane, in a separate dialog, or in a separate browser window. You can choose which of these formats you want from within the application (for more information, see the TIBCO iProcess Workspace (Browser) User’s Guide).

Note, however, the type of form you are using determines which of the form formats (preview pane, dialog, or separate browser window) are selectable from the application, as follows:

• if your application uses GI forms, you can choose to open them in any of the three available formats: Preview Pane, dialog, or separate browser window.
• if your application uses external forms, they will always be opened in a separate browser window.

Also note that “dialogs” are further subdivided into the following:

• Webpage dialogs
• Application dialogs

Whether the work item form opens in a “Webpage” dialog or an “application” dialog depends on the setting of the “dialog” attribute in the <BrowserFeatures> record in the application’s config.xml file. For more information, see the “dialog” attribute description on dialog.

The following describes the differences in behavior between the different types of dialogs/windows:

• Minimize/Maximize Buttons - Webpage dialogs do not have minimize nor maximize buttons. Separate browser windows and application dialogs have these buttons.
• Floating Window Outside Application Window - Both Webpage dialogs and separate browser windows can be floated outside the parent application's window, whereas application dialogs cannot.
• Browser Feature Attributes - The Browser Feature attributes (i.e., the attributes of the <BrowserFeatures> record in the config.xml file) supported depends on the dialog/window and the type of browser used, as follows:
— Webpage dialog: If using Internet Explorer, only the "resizable" and "status" attributes are supported. If using Firefox, the supported attributes are: "dialog", "directories", "location", "menubar", "minimizable", and "toolbar".
— Application dialog: None of the Browser Feature attributes are supported for this type of dialog.
— Separate browser window: The table on the preceding pages lists the browser features that are supported for each of the available browsers.
• Close as child window: Both Webpage dialogs and application dialogs are children of the parent window, therefore if the parent window is closed (or minimized), the Webpage/application dialog is also closed (or minimized). Separate browser windows do not close (or minimize) when the parent is closed (or minimized).