dialog5 (roll option): Difference between revisions
(Created page with "{{RollOption |name=dialog5 |version=1.6.0 |description=Opens a dialog window supporting HTML5. This window can be named; attempts to open another dialog with the same name ca...") |
No edit summary |
||
| (14 intermediate revisions by 6 users not shown) | |||
| Line 7: | Line 7: | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[ | [dialog5(dialogName [,size; input; temporary; title; noframe; closebutton; value] ): { ... }] | ||
</ | </syntaxhighlight> | ||
The first parameter, shown as '''dialogName''', should be a double-quoted string that specifies the internal name of the dialog window. (Note that the title that appears in the titlebar of the window is set separately, using HTML that appears inside the dialog itself.) (use '''title''' parameter from b50 forward) | The first parameter, shown as '''dialogName''', should be a double-quoted string that specifies the internal name of the dialog window. (Note that the title that appears in the titlebar of the window is set separately, using HTML that appears inside the dialog itself.) (use '''title''' parameter from b50 forward) | ||
| Line 15: | Line 15: | ||
The second parameter is optional, it is a semicolon separated [[String Property List]], which could include the following parameters: | The second parameter is optional, it is a semicolon separated [[String Property List]], which could include the following parameters: | ||
The '''size''' parameter is a [[String Property List]] that contains two values, ''width'' and ''height''. | The '''size''' parameter is a [[String Property List]] that contains two integer values, ''width'' and ''height''. The size is specified in pixels. | ||
The following parameters work from v1.3b50 forward: | The following parameters work from v1.3b50 forward: | ||
| Line 21: | Line 21: | ||
The '''input''' parameter dictates whether the dialog has a ''close'' button or is closed with an <input submit> button custom coded into the dialog. '''input''' is set to 1 or 0 within double quotes. example: "input=1" | The '''input''' parameter dictates whether the dialog has a ''close'' button or is closed with an <input submit> button custom coded into the dialog. '''input''' is set to 1 or 0 within double quotes. example: "input=1" | ||
'''temporary''' defaults to 0. This parameter dictates whether Maptool remembers the size of the dialog window between displays. Setting this value to 1 causes Maptool to forget the window size and the dialog is removed when closed. Setting this to 0 will not remove the dialog and it will remain available even when closed. Example "temporary=1" | |||
The '''noframe''' parameter dictates whether the window has a frame or not. Example "noframe=1" removes the frame from the dialog window. | The '''noframe''' parameter dictates whether the window has a frame or not. Example "noframe=1" removes the frame from the dialog window. | ||
| Line 28: | Line 28: | ||
The '''closebutton''' parameter can disable the ''close'' button, by specifying '''closebutton=0'''. | The '''closebutton''' parameter can disable the ''close'' button, by specifying '''closebutton=0'''. | ||
The '''scrollreset''' option, if equals to 1, resets the scrolling to the top of the frame once the dialog is loaded with new HTML content. | |||
The '''value''' parameter associates arbitrary data to the frame. The data can be recovered through the [[getDialogProperties]] function. | The '''value''' parameter associates arbitrary data to the frame. The data can be recovered through the [[getDialogProperties]] function. | ||
| Line 36: | Line 38: | ||
[[Image:DialogEx1.png]] | [[Image:DialogEx1.png]] | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[dialog5("Dialog Test"): { | [dialog5("Dialog Test"): { | ||
<html> | <html> | ||
| Line 52: | Line 54: | ||
</html> | </html> | ||
} ] | } ] | ||
</ | </syntaxhighlight> | ||
To create a dialog that initially opens with a width of 300 pixels and height of 200 pixels, change the first line of the previous example to: | To create a dialog that initially opens with a width of 300 pixels and height of 200 pixels, change the first line of the previous example to: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[dialog5("Dialog Test", "width=300; height=200; temporary=1; input=0; noframe=1"): { | [dialog5("Dialog Test", "width=300; height=200; temporary=1; input=0; noframe=1"): { | ||
</ | </syntaxhighlight> | ||
Did you try it? It didn't change size from the previous example, did it? Do you remember why? If not, go back to the top of the page and read that first paragraph again! | Did you try it? It didn't change size from the previous example, did it? Do you remember why? If not, go back to the top of the page and read that first paragraph again! | ||
| Line 67: | Line 69: | ||
{{func|isFrameVisible}} <br> | {{func|isFrameVisible}} <br> | ||
[[Introduction to Dialogs and Frames]]<br> | [[Introduction to Dialogs and Frames]]<br> | ||
[[Forms tutorial]]}} | [[Forms tutorial]]<br> | ||
[[Whitelisted CDNs]]<br> | |||
[[Theme CSS]] | |||
|changes= | |||
{{change|1.7.0|Added '''scrollreset''' parameter option.}} | |||
}} | |||
[[Category:Display Roll Option]] | [[Category:Display Roll Option]] | ||
[[Category: | [[Category:Dialog Function]] | ||
Latest revision as of 23:59, 16 November 2024
[dialog5():] Roll Option
Opens a dialog window supporting HTML5. This window can be named; attempts to open another dialog with the same name cause the old contents to be removed and new contents displayed. The initial size of the dialog can be specified as well, but once the named dialog is opened and resized by the user, that size becomes its default opening size in the future.
Dialogs are not dockable panels as a [frame5():] is. Dialogs also have at least one button for dismissing the dialog.
Usage
[dialog5(dialogName [,size; input; temporary; title; noframe; closebutton; value] ): { ... }]The first parameter, shown as dialogName, should be a double-quoted string that specifies the internal name of the dialog window. (Note that the title that appears in the titlebar of the window is set separately, using HTML that appears inside the dialog itself.) (use title parameter from b50 forward)
The second parameter is optional, it is a semicolon separated String Property List, which could include the following parameters:
The size parameter is a String Property List that contains two integer values, width and height. The size is specified in pixels.
The following parameters work from v1.3b50 forward:
The input parameter dictates whether the dialog has a close button or is closed with an <input submit> button custom coded into the dialog. input is set to 1 or 0 within double quotes. example: "input=1"
temporary defaults to 0. This parameter dictates whether Maptool remembers the size of the dialog window between displays. Setting this value to 1 causes Maptool to forget the window size and the dialog is removed when closed. Setting this to 0 will not remove the dialog and it will remain available even when closed. Example "temporary=1"
The noframe parameter dictates whether the window has a frame or not. Example "noframe=1" removes the frame from the dialog window.
The title parameter sets the title of the dialog box and replaces the need to set the title from within the HTML code.
The closebutton parameter can disable the close button, by specifying closebutton=0.
The scrollreset option, if equals to 1, resets the scrolling to the top of the frame once the dialog is loaded with new HTML content.
The value parameter associates arbitrary data to the frame. The data can be recovered through the getDialogProperties function.
Examples
The following code opens up a dialog window that contains the HTML as shown here:
[dialog5("Dialog Test"): {
<html>
<head>
<title>Test of Dialog Windows</title>
</head>
<body>
<table border="1">
<tr><th>Column 1</th><th>Column 2</th><th>Column 3</th></tr>
<tr><td>Line 1, Col 1</td><td colspan="2">Line 1, Cols 2 and 3</td></tr>
<tr><td rowspan="2">Lines 2 and 3, Col 1</td><td>Line 2, Col 2</td><td>Line 2, Col 3</td></tr>
<tr><td>Line 3, Col 3</td><td>Line 3, Col 3</td></tr>
</table>
</body>
</html>
} ]To create a dialog that initially opens with a width of 300 pixels and height of 200 pixels, change the first line of the previous example to:
[dialog5("Dialog Test", "width=300; height=200; temporary=1; input=0; noframe=1"): {Did you try it? It didn't change size from the previous example, did it? Do you remember why? If not, go back to the top of the page and read that first paragraph again!
See Also
[frame():]
[frame5():]
[dialog():]
isFrameVisible()
Introduction to Dialogs and Frames
Forms tutorial
Whitelisted CDNs
Theme CSS
Version Changes
- 1.7.0 - Added scrollreset parameter option.