mozilla
Your Search Results

    Window.importDialog()

    Summary

    Because opening windows on mobile isn't necessarily appropriate, the Firefox Mobile team designed the importDialog() method to replace window.openDialog(). Instead of opening a new window, it merges the specified XUL dialog into the main window.

    Syntax

    newDialog = importDialog(aParent, aSrc, aArguments) 
    
    newDialog
    The opened window
    aParent
    The dialog's parent; can be null.
    aSrc
    The chrome URL of the XUL dialog.
    aArguments
    A JavaScript object containing data to pass to the dialog.

    Example

    var dialog = importDialog(null, "chrome://myextension/content/dialog.xul", myObject);
    

    Notes

    The XUL passed to importDialog() is very similar to XUL passed to window.openDialog(), with some limitations and caveats:

    • Only <dialog> top level elements are permitted.
    • Scripts are loaded via an attribute on the <dialog> element, not via the <script> tag.

    The XUL is merged into the existing window, almost like a XUL overlay. Because of this, element ID and JavaScript conflicts are possible, just like overlays. So be careful.

    Specification

    DOM Level 0. Not part of any standard.

    Document Tags and Contributors

    Contributors to this page: Sheppy, damien.flament, MHasan, fscholz, Sonnyp, kscarfone, teoli
    Last updated by: fscholz,
    Hide Sidebar