31st August 2023 at 8:15pm
The tm-open-window message opens a tiddler in a new browser window. If no parameters are specified, the current tiddler is opened in a new window. Similiar to tm-modal any additional parameters passed via the paramObject are provided as variables to the new window.
| Name | Description |
|---|---|
| param {default param} | Title of the tiddler to be opened in a new browser window, defaults to currentTiddler if empty |
| template | Template in which the tiddler will be rendered |
| windowTitle | Title string for the opened window |
| width | Width of the new browser window |
| height | Height of the new browser window |
| left | Introduced in v5.2.2 Optional, left position of new browser window |
| top | Introduced in v5.2.2 Optional, top position of new browser window |
| windowID | Introduced in v5.2.2 Optional, unique string used to identify the widow. Can be used with WidgetMessage: tm-close-window to close the window. Defaults to the value of param |
| {any other params} | Any other parameters are made available as variables within the new window |
The tm-open-window message is best generated with the ActionSendMessageWidget, which in turn is triggered by a widget such as the ButtonWidget. The message is handled by the core itself.
<$button>Open Window
<$action-sendmessage
$message="tm-open-window"
$param="$:/temp/openme"
template="SampleWindowTemplate"
windowTitle="My Window Title"
width="640"
height="480"
something="This is my new window. There are many like it, but this one is mine." />
</$button>
That renders as: