Deprecation Notice

The qooxdoo dialog package has moved to https://github.com/qooxdoo/qxl.dialog. While this repo/package is still functional, it won't be maintained any longer. If you are using the Dialog package, please migrate at your earliest convenience. The only code migration necessary is to install qooxdoo/qxl.dialog instead of cboulanger/qx-contrib-Dialog and replace the dialog top-level namespace uses in your apps with qxl.dialog.

Qooxdoo Dialog Widgets

This is version 2 which only works with the new JavaScript compiler and qooxdoo v6. qooxdoo v5 and the python toolchain are no longer supported.

A set of often used dialog widgets for the qooxdoo framework.

• Alert
• Confirm
• Form
• Login
• Prompt
• Select
• Wizard
• Progress

Demo: http://cboulanger.github.io/qx-contrib-Dialog/build/index.html

API Viewer: http://cboulanger.github.io/qx-contrib-Dialog/api/index.html#dialog

See Demo app for examples how to use the widgets.

Installation:

qx contrib install cboulanger/qx-contrib-Dialog

Install icon theme

From v1.3.0 on, the contrib allows you to use custom icons for the dialogs. However, this means that the icons will not work out of the box. You must use or extend one of the shipped icon themes in your application's meta theme (see this example) or copy the alias definitions from one of them into your own icon theme. You can also use your own choice of icons by writing an icon theme which defines defining the aliases "dialog.icon.(ok|cancel|info|warning|error)" with the paths to the icons. Those paths also need to be put into a @asset compiler hint. See, for example, this theme class.

Testing

npm install -g qxcompiler # must be version >=  v0.2.19
npm install
qx serve --target=build

Once the message 'Compiled x classes' appears, open a new terminal and start the tests with tests/run.sh. When the tests succeed, you can kill the server process in the first tab.

Changelog

v2.0.0

• Dropped support for qx v5.0 and the python generator
• Rewrote tests to make use of the new qx.core.Id system

  v1.4.0

• Added TextCafe UI tests

  v1.3.3

• integrate demo application into library code, now you can simply do qx serve to run the demo.

  v1.3.1

• fix alias names

  v1.3.0

• Compatible with qooxdoo 5.x and 6.x: added support for new JS compiler
• Merged changes from https://github.com/jbruwes/qooxdialog
  • replaced base widget qx.ui.GroupBox with modal qx.ui.window.Window
• Added new black and white SVG icons from https://icomoon.io/#preview-free, added support for live icon theme switching
• Added promise() method returning a Promise as an alternative to callbacks
• Promisified all shorthand methods (dialog.alert, ...), resulting in massively better readability see Demo app
• Added caption parameter to shorthand methods.
• Since a modal window has its own blocker, the default coloured blocker has been removed. If you want the old behavior, call dialog.Dialog.useBlocker(true).
• Prettified with the default settings of https://github.com/prettier/prettier
• Added 'cancelOnEscape' property (default: true) which triggers the 'cancel' button action if the user presses the Escape key and 'allowCancel' is true.
• Progress Widget enhancements:
  • added 'hideWhenCancelled' property (default: true) to allow "cleanup" or similar actions to be displayed after the cancel button has been pressed.

    v1.2

• fixed a bug that prevented submitting the login dialog by pressing enter (patch by @novij)
• added "Forgot Password?" button to login widget

  v1.1

• compatible with qooxdoo v4.0
• Progress dialog widget added

  v1.0

• compatible with qooxdoo v3.5

TODO

• Tab and focus handling is still buggy: Users can tab into non-modal widgets.
• Rewrite using child controls, to make dialogs truly themeable.