Simple javascript command to open the dialog modal form

  1. function OpenPopUpPage(url, callback, width, height)
  2. function OpenPopUpPageWithTitle(url, callback, width, height, title)
  3. function OpenPopUpPageWithDialogOptions(dialogOptions)

DialogOptions supports:

Options Property Description
title A string that contains the title of the dialog.
url A string that contains the URL of the page that appears in the dialog. If both url and html are specified, url takes precedence. Either url or html must be specified.
html A string that contains the HTML of the page that appears in the dialog. If both html and url are specified, url takes precedence. Either url or html must be specified.
x An integer value that specifies the x-offset of the dialog. This value works like the CSS left value.
y An integer value that specifies the y-offset of the dialog. This value works like the CSS top value.
width An integer value that specifies the width of the dialog. If width is not specified, the width of the dialog is autosized by default. If autosize is false, the width of the dialog is set to 768 pixels.
height An integer value that specifies the height of the dialog. If height is not specified, the height of the dialog is autosized by default. If autosize is false, the dialog height is set to 576 pixels.
allowMaximize A Boolean value that specifies whether the dialog can be maximized. true if the Maximize button is shown; otherwise, false.
showMaximized A Boolean value that specifies whether the dialog opens in a maximized state. true the dialog opens maximized. Otherwise, the dialog is opened at the requested sized if specified; otherwise, the default size, if specified; otherwise, the autosized size.
showClose A Boolean value that specifies whether the Close button appears on the dialog.
autoSize A Boolean value that specifies whether the dialog platform handles dialog sizing.
dialogReturnValueCallback A function pointer that specifies the return callback function. The function takes two parameters, a dialogResult of type SP.UI.DialogResult Enumeration and a returnValue of type object that contains any data returned by the dialog.
args An object that contains data that are passed to the dialog.

It’s required that the following SharePoint JS file are loaded:

  1. SP.Core.js
  2. SP.js,
  3. SP.UI.Dialog.js

Example:

<a href=”javascript:OpenPopUpPageWithTitle(‘somepage.aspx’,RefreshOnDialogClose,null,null,’Some Page Header’)”><img src=”someimage.png”></a>

Source: http://wp.ahcheng.com/2013/04/09/calling-dialog-modal-form-in-sharepoint-2013