class dom::Win
sys::Obj dom::Win
@Js
Win models the DOM window object.
See pod doc for details.
- addStyleRules
-
Add new CSS style rules to this page.
- alert
-
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
-
Display a confirmation dialog box with the given text. Returns
true
ifok
was selected,false
othterwise. - cur
-
static Win cur()
Return the current window instance.
- doc
-
Doc doc()
Return the Doc instance for this window.
- eval
-
Evaluate given JavaScript code.
- geoClearWatch
-
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.
- hyperlink
-
Hyperlink to the given Uri in this window.
- localStorage
-
Storage localStorage()
Return local storage instance for window.
- log
-
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
-
Scrolls the document in the window by the given amount.
- scrollPos
-
Point scrollPos()
Return current scroll position of document in this window.
- scrollTo
-
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.