type

Win

@Js
class Win : Obj

Win models the DOM window object.

See pod doc for details.

methods

addStyleRules

Add new CSS style rules to this page.

alert

Display a modal message box with the given text.

clearInterval

Cancels a repeated action which was set up using setInterval.

clearTimeout

Clears the delay set by setTimeout.

clipboardReadText

Read textual contents of the system clipboard.

clipboardWriteText

Write given text to the system clipboard.

close

Close this window.

confirm

Display a confirmation dialog box with the given text.

cur

Return the current window instance.

doc

Return the Doc instance for this window.

eval

Evaluate given JavaScript code.

geoClearWatch

Unregister location/error monitoring handlers previously installed using geoWatchPosition.

geoCurPosition

Get the the current position of this device.

geoWatchPosition

Register a handler function that will be called automatically each time the position of the device changes.

hisBack

Go to previous page in session history.

hisForward

Go to next page in the session history.

hisPushState

Push a new history item onto the history stack.

hisReplaceState

Modify the current history item.

hyperlink

Hyperlink to the given Uri in this window.

localStorage

Return local storage instance for window.

log

Log object to console.

onEvent

Attach an event handler for the given event on this window.

open

Open a new window.

parent

Returns a reference to the parent of the current window or subframe, or null if this is the top-most window.

reload

Reload the current page.

removeEvent

Remove the given event handler from this window.

reqAnimationFrame

Request the browser to perform an animation before the next repaint.

screenSize

Return the size of the screen in pixels.

scrollBy

Scrolls the document in the window by the given amount.

scrollPos

Return current scroll position of document in this window.

scrollTo

Scrolls to a particular set of coordinates in the document.

sessionStorage

Return session storage instance for window.

setInterval

Calls a function repeatedly, with a fixed time delay between each call to that function.

setTimeout

Call the specified function after a specified delay.

top

Returns a reference to the topmost window in the window hierarchy.

uri

Get the Uri for this window.

viewport

Return the size of the window viewport in pixels.

Slot Details

addStyleRules

Void addStyleRules(Str rules)

Add new CSS style rules to this page.

alert

Void alert(Obj obj)

Display a modal message box with the given text.

clearInterval

Void clearInterval(Int intervalId)

Cancels a repeated action which was set up using setInterval.

clearTimeout

Void clearTimeout(Int timeoutId)

Clears the delay set by setTimeout.

clipboardReadText

Void clipboardReadText(|Str| f)

Read textual contents of the system clipboard. Returns an empty string if the clipboard is empty, does not contain text, or does not include a textual representation of clipboard's contents.

The user has to interact with the page or a UI element in order for this feature to work.

clipboardWriteText

Void clipboardWriteText(Str text)

Write given text to the system clipboard.

The user has to interact with the page or a UI element in order for this feature to work.

close

Win close()

Close this window. Only applicable to windows created with open. Otherwise method has no effect. Returns this.

confirm

Bool confirm(Obj obj)

Display a confirmation dialog box with the given text. Returns true if ok was selected, false othterwise.

cur

static Win cur()

Return the current window instance.

doc

Doc doc()

Return the Doc instance for this window.

eval

static Obj eval(Str js)

Evaluate given JavaScript code.

geoClearWatch

Void geoClearWatch(Int id)

Unregister location/error monitoring handlers previously installed using geoWatchPosition. This feature is only available in secure contexts (HTTPS).

geoCurPosition

Void geoCurPosition(|DomCoord| onSuccess, |Err|? onErr := null, [Str:Obj]? opts := null)

Get the the current position of this device. This feature is only available in secure contexts (HTTPS).

geoWatchPosition

Int geoWatchPosition(|DomCoord| onSuccess, |Err|? onErr := null, [Str:Obj]? opts := null)

Register a handler function that will be called automatically each time the position of the device changes. This method returns a watch ID value that then can be used to unregister the handler with the geoClearWatch method. This feature is only available in secure contexts (HTTPS).

hisBack

Void hisBack()

Go to previous page in session history.

hisForward

Void hisForward()

Go to next page in the session history.

hisPushState

Void hisPushState(Str title, Uri uri, Str:Obj map)

Push a new history item onto the history stack. Use onpopstate to listen for changes:

// Event.stash contains state map passed into pushState
Win.cur.onEvent("popstate", false) |e| { echo("# state: $e.stash") }

hisReplaceState

Void hisReplaceState(Str title, Uri uri, Str:Obj map)

Modify the current history item.

Void hyperlink(Uri uri)

Hyperlink to the given Uri in this window.

localStorage

Storage localStorage()

Return local storage instance for window.

log

Void log(Obj? obj)

Log object to console.

onEvent

Func onEvent(Str type, Bool useCapture, |Event| handler)

Attach an event handler for the given event on this window. Returns callback function instance.

open

Win open(Uri uri := `about:blank`, Str? winName := null, [Str:Str]? opts := null)

Open a new window. Returns the new window instance.

parent

Win? parent()

Returns a reference to the parent of the current window or subframe, or null if this is the top-most window.

reload

Void reload(Bool force := false)

Reload the current page. Use force to bypass browse cache.

removeEvent

Void removeEvent(Str type, Bool useCapture, Func handler)

Remove the given event handler from this window. If this handler was not registered, this method does nothing.

reqAnimationFrame

Void reqAnimationFrame(|This| f)

Request the browser to perform an animation before the next repaint.

screenSize

Size screenSize()

Return the size of the screen in pixels.

scrollBy

This scrollBy(Int x, Int y)

Scrolls the document in the window by the given amount.

scrollPos

Point scrollPos()

Return current scroll position of document in this window.

scrollTo

This scrollTo(Int x, Int y)

Scrolls to a particular set of coordinates in the document.

sessionStorage

Storage sessionStorage()

Return session storage instance for window.

setInterval

Int setInterval(Duration delay, |This| f)

Calls a function repeatedly, with a fixed time delay between each call to that function. Returns an intervalId that can be used in clearInterval.

setTimeout

Int setTimeout(Duration delay, |This| f)

Call the specified function after a specified delay. Returns a timeoutId that can be used in clearTimeout.

top

Win top()

Returns a reference to the topmost window in the window hierarchy. If this window is the topmost window, returns self.

uri

Uri uri()

Get the Uri for this window.

viewport

Size viewport()

Return the size of the window viewport in pixels.