Skip to content

IFrameDialog control

This control renders a Dialog with an iframe as a content.

Here is an example of the control in action:

IFrameDialog control

How to use this control in your solutions

  • Check that you installed the @pnp/spfx-controls-react dependency. Check out the getting started page for more information about installing the dependency.
  • Import the following modules to your component:
import { IFrameDialog } from "@pnp/spfx-controls-react/lib/IFrameDialog";
  • Use the IFrameDialog control in your code as follows (this._onIframeLoaded and this._onDialogDismiss are methods that should be implemented if you want to execute some actions when the iframe content is loaded and dialog should be closed respectively):
        isBlocking: true,
        containerClassName: styles.dialogContainer
        type: DialogType.close,
        showCloseButton: true


The IFrameDialog component can be configured with the following properties:

Property Type Required Description
dialogContentProps IDialogContentProps no Props to be passed through to Dialog Content.
hidden boolean no Whether the dialog is hidden.
modalProps IModalProps no Props to be passed through to Modal.
onDismiss (ev?: React.MouseEvent) => any no A callback function for when the Dialog is dismissed from the close button or light dismiss. Can also be specified separately in content and modal.
url string yes iframe Url
iframeOnload iframeOnLoad?: (iframe: any) => {} no iframe's onload event handler
width string yes iframe's width
heigth string yes iframe's height