dart:html

Класс Window

Верхнеуровневый контейнер для текущей вкладки или окна браузера.

В веб-браузере каждое окно имеет объект Window, но в контексте скрипта этот объект представляет только текущее окно. Каждое другое окно, вкладка и iframe имеют свой собственный объект Window.

В каждом окне содержится объект Document, который содержит все содержимое окна.

Используйте верхнеуровневый объект window для доступа к текущему окну. Например:

// Draw a scene when the window repaints.
drawScene(num delta) {...}
window.animationFrame.then(drawScene);.

// Write to the console.
window.console.log('Jinkies!');
window.console.error('Jeepers!');

Примечание: Этот класс представляет только текущее окно, в то время как WindowBase представляет любое окно, включая другие вкладки, окна и фреймы.

См. также

• WindowBase

Дополнительные ресурсы

• DOM Window от MDN.
• Window от W3C.

Наследование

• Object
• EventTarget
• Window

Реализованные типы

• GlobalEventHandlers
• WindowBase64
• WindowEventHandlers
• WindowBase

Аннотации

• @Native("Window,DOMWindow")

Свойства

animationFrame → Future<num>

только для чтения

Возвращает Future, завершающееся незадолго до перерисовки окна, чтобы пользователь мог отрисовать кадр анимации.

animationWorklet → _Worklet?

только для чтения

applicationCache → ApplicationCache?

только для чтения

Кэш приложения для этого окна.

audioWorklet → _Worklet?

только для чтения

caches → CacheStorage?

только для чтения

closed → bool?

только для чтения, переопределено

Указывает, закрыто ли это окно.

console → Console

только для чтения

Консоль отладки для этого окна.

cookieStore → CookieStore?

только для чтения

crypto → Crypto?

только для чтения

Точка входа для криптографических функций браузера.

customElements → CustomElementRegistry?

только для чтения

defaultStatus ↔ String?

чтение/запись

Устарело.

defaultstatus ↔ String?

чтение/запись

Устарело.

devicePixelRatio → num

только для чтения

Соотношение между физическими и логическими CSS-пикселями.

document → Document

только для чтения

Последний документ в этом окне.

external → External?

только для чтения

hashCode → int

только для чтения, унаследовано

Код хэша для этого объекта.

history → History

только для чтения, переопределено

История текущей сессии для последнего документа этого окна.

indexedDB → IdbFactory?

@SupportedBrowser(SupportedBrowser.CHROME, '23.0'), @SupportedBrowser(SupportedBrowser.FIREFOX, '15.0'), @SupportedBrowser(SupportedBrowser.IE, '10.0'), только для чтения

Получает экземпляр фабрики Indexed DB для использования Indexed DB.

innerHeight → int?

только для чтения

Высота области просмотра, включая полосы прокрутки.

innerWidth → int?

только для чтения

Ширина области просмотра, включая полосы прокрутки.

isSecureContext → bool?

только для чтения

localStorage → Storage

только для чтения

Хранилище для этого окна, сохраняющееся между сеансами.

location ↔ Location

чтение/запись, переопределение-получателя

Текущее расположение этого окна.

locationbar → BarProp?

только для чтения

Строка состояния этого окна, отображающая URL.

menubar → BarProp?

только для чтения

Строка меню этого окна, отображающая команды меню.

name ↔ String?

чтение/запись

Имя этого окна.

navigator → Navigator

только для чтения

Пользовательский агент, обращающийся к этому окну.

offscreenBuffering → bool?

только для чтения

Определяет, отрисовываются ли объекты вне экрана перед отображением.

on → Events

только для чтения, унаследовано

Это вспомогательный доступ к потокам событий, который следует использовать только тогда, когда явный доступ недоступен.

onAbort → Stream<Event>

только для чтения, переопределено

Поток abort событий, обрабатываемых этим Window.

onAnimationEnd → Stream<AnimationEvent>

только для чтения

Поток animationend событий, обрабатываемых этим Window.

onAnimationIteration → Stream<AnimationEvent>

только для чтения

Поток animationiteration событий, обрабатываемых этим Window.

onAnimationStart → Stream<AnimationEvent>

только для чтения

Поток animationstart событий, обрабатываемых этим Window.

onBeforeUnload → Stream<Event>

только для чтения

Поток beforeunload событий, обрабатываемых этим Window.

onBlur → Stream<Event>

только для чтения, переопределено

Поток blur событий, обрабатываемых этим Window.

onCanPlay → Stream<Event>

только для чтения, переопределено

onCanPlayThrough → Stream<Event>

только для чтения, переопределено

onChange → Stream<Event>

только для чтения, переопределено

Поток change событий, обрабатываемых этим Window.

onClick → Stream<MouseEvent>

только для чтения, переопределено

Поток click событий, обрабатываемых этим Window.

onContentLoaded → Stream<Event>

только для чтения

Поток contentloaded событий, обрабатываемых этим Window.

onContextMenu → Stream<MouseEvent>

только для чтения, переопределено

Поток contextmenu событий, обрабатываемых этим Window.

onDeviceMotion → Stream<DeviceMotionEvent>

только для чтения

Поток devicemotion событий, обрабатываемых этим Window.

onDeviceOrientation → Stream<DeviceOrientationEvent>

только для чтения

Поток deviceorientation событий, обрабатываемых этим Window.

onDoubleClick → Stream<Event>

@DomName('Window.ondblclick'), только для чтения, переопределено

Поток doubleclick событий, обрабатываемых этим Window.

onDrag → Stream<MouseEvent>

только для чтения, переопределено

Поток drag событий, обрабатываемых этим Window.

onDragEnd → Stream<MouseEvent>

только для чтения, переопределено

Поток dragend событий, обрабатываемых этим Window.

onDragEnter → Stream<MouseEvent>

только для чтения, переопределено

Поток dragenter событий, обрабатываемых этим Window.

onDragLeave → Поток<MouseEvent>

только для чтения, переопределение

Поток dragleave событий, обрабатываемых этим Окном.

onDragOver → Поток<MouseEvent>

только для чтения, переопределение

Поток dragover событий, обрабатываемых этим Окном.

onDragStart → Поток<MouseEvent>

только для чтения, переопределение

Поток dragstart событий, обрабатываемых этим Окном.

onDrop → Поток<MouseEvent>

только для чтения, переопределение

Поток drop событий, обрабатываемых этим Окном.

onDurationChange → Поток<Event>

только для чтения, переопределение

onEmptied → Поток<Event>

только для чтения, переопределение

onEnded → Поток<Event>

только для чтения, переопределение

onError → Поток<Event>

только для чтения, переопределение

Поток error событий, обрабатываемых этим Окном.

onFocus → Поток<Event>

только для чтения, переопределение

Поток focus событий, обрабатываемых этим Окном.

onHashChange → Поток<Event>

только для чтения, переопределение

Поток hashchange событий, обрабатываемых этим Окном.

onInput → Поток<Event>

только для чтения, переопределение

Поток input событий, обрабатываемых этим Окном.

onInvalid → Поток<Event>

только для чтения, переопределение

Поток invalid событий, обрабатываемых этим Окном.

onKeyDown → Поток<KeyboardEvent>

только для чтения, переопределение

Поток keydown событий, обрабатываемых этим Окном.

onKeyPress → Поток<KeyboardEvent>

только для чтения, переопределение

Поток keypress событий, обрабатываемых этим Окном.

onKeyUp → Поток<KeyboardEvent>

только для чтения, переопределение

Поток keyup событий, обрабатываемых этим Окном.

onLoad → Поток<Event>

только для чтения, переопределение

Поток load событий, обрабатываемых этим Окном.

onLoadedData → Поток<Event>

только для чтения, переопределение

onLoadedMetadata → Поток<Event>

только для чтения, переопределение

onLoadStart → Поток<Event>

только для чтения

onMessage → Поток<MessageEvent>

только для чтения, переопределение

Поток message событий, обрабатываемых этим Окном.

onMouseDown → Поток<MouseEvent>

только для чтения, переопределение

Поток mousedown событий, обрабатываемых этим Окном.

onMouseEnter → Поток<MouseEvent>

только для чтения, переопределение

Поток mouseenter событий, обрабатываемых этим Окном.

onMouseLeave → Поток<MouseEvent>

только для чтения, переопределение

Поток mouseleave событий, обрабатываемых этим Окном.

onMouseMove → Поток<MouseEvent>

только для чтения, переопределение

Поток mousemove событий, обрабатываемых этим Окном.

onMouseOut → Поток<MouseEvent>

только для чтения, переопределение

Поток mouseout событий, обрабатываемых этим Окном.

onMouseOver → Поток<MouseEvent>

только для чтения, переопределение

Поток mouseover событий, обрабатываемых этим Окном.

onMouseUp → Поток<MouseEvent>

только для чтения, переопределение

Поток mouseup событий, обрабатываемых этим Окном.

onMouseWheel → Поток<WheelEvent>

только для чтения, переопределение

Поток mousewheel событий, обрабатываемых этим Окном.

onOffline → Поток<Event>

только для чтения, переопределение

Поток offline событий, обрабатываемых этим Окном.

onOnline → Поток<Event>

только для чтения, переопределение

Поток online событий, обрабатываемых этим Окном.

onPageHide → Поток<Event>

только для чтения

Поток pagehide событий, обрабатываемых этим Окном.

onPageShow → Поток<Event>

только для чтения

Поток pageshow событий, обрабатываемых этим Окном.

onPause → Поток<Event>

только для чтения, переопределение

onPlay → Поток<Event>

только для чтения, переопределение

onPlaying → Поток<Event>

только для чтения, переопределение

onPopState → Поток<PopStateEvent>

только для чтения, переопределение

Поток popstate событий, обрабатываемых этим Окном.

onProgress → Поток<Event>

только для чтения

onRateChange → Поток<Event>

только для чтения, переопределение

onReset → Поток<Event>

только для чтения, переопределение

Поток reset событий, обрабатываемых этим Окном.

onResize → Поток<Event>

только для чтения, переопределение

Поток resize событий, обрабатываемых этим Окном.

onScroll → Поток<Event>

только для чтения, переопределение

Поток scroll событий, обрабатываемых этим окном.

onSearch → Поток<Событие>

только для чтения

Поток search событий, обрабатываемых этим окном.

onSeeked → Поток<Событие>

только для чтения, перезаписывается

onSeeking → Поток<Событие>

только для чтения, перезаписывается

onSelect → Поток<Событие>

только для чтения, перезаписывается

Поток select событий, обрабатываемых этим окном.

onStalled → Поток<Событие>

только для чтения, перезаписывается

onStorage → Поток<StorageEvent>

только для чтения, перезаписывается

Поток storage событий, обрабатываемых этим окном.

onSubmit → Поток<Событие>

только для чтения, перезаписывается

Поток submit событий, обрабатываемых этим окном.

onSuspend → Поток<Событие>

только для чтения, перезаписывается

onTimeUpdate → Поток<Событие>

только для чтения, перезаписывается

onTouchCancel → Поток<TouchEvent>

только для чтения, перезаписывается

Поток touchcancel событий, обрабатываемых этим окном.

onTouchEnd → Поток<TouchEvent>

только для чтения, перезаписывается

Поток touchend событий, обрабатываемых этим окном.

onTouchMove → Поток<TouchEvent>

только для чтения, перезаписывается

Поток touchmove событий, обрабатываемых этим окном.

onTouchStart → Поток<TouchEvent>

только для чтения, перезаписывается

Поток touchstart событий, обрабатываемых этим окном.

onTransitionEnd → Поток<TransitionEvent>

только для чтения

Поток transitionend событий, обрабатываемых этим окном.

onUnload → Поток<Событие>

только для чтения, перезаписывается

Поток unload событий, обрабатываемых этим окном.

onVolumeChange → Поток<Событие>

только для чтения, перезаписывается

onWaiting → Поток<Событие>

только для чтения, перезаписывается

onWheel → Поток<WheelEvent>

только для чтения, перезаписывается

Поток wheel событий, обрабатываемых этим окном.

opener ↔ WindowBase?

чтение / запись, переопределённый getter

Ссылка на окно, которое открыло это окно.

orientation → int?

только для чтения

origin → String?

только для чтения

outerHeight → int

только для чтения

Высота этого окна, включая все элементы пользовательского интерфейса.

outerWidth → int

только для чтения

Ширина окна, включая все элементы пользовательского интерфейса.

pageXOffset → int

только для чтения

pageYOffset → int

только для чтения

parent → WindowBase?

только для чтения, перезаписывается

Ссылка на родительское окно.

performance → Performance

@SupportedBrowser(SupportedBrowser.CHROME), @SupportedBrowser(SupportedBrowser.FIREFOX), @SupportedBrowser(SupportedBrowser.IE), только для чтения

Данные о времени и навигации для этого окна.

runtimeType → Тип

только для чтения, унаследованно

Представление типа объекта в среде выполнения.

screen → Экран?

только для чтения

Информация о экране, на котором отображается это окно.

screenLeft → int?

только для чтения

Расстояние от левого края экрана до левого края этого окна.

screenTop → int?

только для чтения

Расстояние от верхнего края экрана до верхнего края этого окна.

screenX → int?

только для чтения

Расстояние от левого края экрана до указателя мыши.

screenY → int?

только для чтения

Расстояние от верхнего края экрана до указателя мыши.

scrollbars → BarProp?

только для чтения

Скролл-бары этого окна.

scrollX → int

только для чтения

Расстояние горизонтальной прокрутки этого окна.

scrollY → int

только для чтения

Расстояние вертикальной прокрутки этого окна.

self → WindowBase?

только для чтения

Текущее окно.

sessionStorage → Хранилище

только для чтения

Хранилище для этого окна, которое очищается по окончании сессии.

speechSynthesis → SpeechSynthesis?

только для чтения

Доступ к синтезу речи в браузере.

status ↔ String?

чтение / запись

Устарело.

statusbar → BarProp?

только для чтения

Строка состояния этого окна.

styleMedia → StyleMedia?

только для чтения

Доступ к CSS средствам запросов медиа.

toolbar → BarProp?

только для чтения

Панель инструментов этого окна.

top → WindowBase?

только для чтения, перезаписывается

Ссылка на самое верхнее окно в иерархии окон.

visualViewport → VisualViewport?

только для чтения

window → WindowBase?

только для чтения

Текущее окно.

Методы

addEventListener(Строка type, EventListener? listener, [bool? useCapture]) → void

inherited

alert([Строка? message]) → void

Отображает модальное окно с сообщением об ошибке пользователю.

atob(Строка atob) → Строка

override

btoa(Строка btoa) → Строка

override

cancelAnimationFrame(int id) → void

Отменяет запрос на отрисовку кадра анимации.

cancelIdleCallback(int handle) → void

close() → void

override

Закрывает окно.

confirm([Строка? message]) → bool

Отображает модальное окно с запросом подтверждения/отмены пользователю.

dispatchEvent(Event event) → bool

inherited

fetch(dynamic input, [Map? init]) → Future

find(Строка? string, bool? caseSensitive, bool? backwards, bool? wrap, bool? wholeWord, bool? searchInFrames, bool? showDialog) → bool

Ищет текст в текущем окне.

getComputedStyleMap(Element element, Строка? pseudoElement) → StylePropertyMapReadonly

getMatchedCssRules(Element? element, Строка? pseudoElement) → Список<CssRule>

@JSName('getMatchedCSSRules'), @Returns('_CssRuleList'), @Creates('_CssRuleList')

Возвращает все правила CSS, которые применяются к псевдоэлементу элемента.

getSelection() → Selection?

Возвращает текущий выделенный текст.

matchMedia(Строка query) → MediaQueryList

Возвращает список медиа-запросов для заданной строки запроса.

moveBy(int x, int y) → void

Перемещает окно.

moveTo(Точка<число> p) → void

Перемещает окно в определенную позицию.

noSuchMethod(Вызов invocation) → dynamic

inherited

Вызывается при попытке доступа к несуществующему методу или свойству.

open(Строка url, Строка name, [Строка? options]) → WindowBase

Открывает новое окно.

postMessage(dynamic message, Строка targetOrigin, [Список<Объект>? transfer]) → void

override

Отправляет междоменное сообщение.

print() → void

Открывает диалог печати для текущего окна.

removeEventListener(Строка type, EventListener? listener, [bool? useCapture]) → void

inherited

requestAnimationFrame(FrameRequestCallback callback) → int

Вызывается для отрисовки кадра анимации и затем запроса перерисовки окна после того, как callback завершится (создание анимации).

requestFileSystem(int size, {bool persistent = false}) → Future<FileSystem>

Получает доступ к защищенной файловой системе размером size байт.

requestIdleCallback(IdleRequestCallback callback, [Map? options]) → int

resizeBy(int x, int y) → void

Изменяет размер окна на заданный смещение.

resizeTo(int x, int y) → void

Изменяет размер окна до указанной ширины и высоты.

resolveLocalFileSystemUrl(Строка url) → Future<Entry>

@JSName('webkitResolveLocalFileSystemURL'), @SupportedBrowser(SupportedBrowser.CHROME)

Асинхронно получает доступ к файловой системе.

scroll([dynamic options_OR_x, dynamic y, Map? scrollOptions]) → void

Прокручивает страницу по горизонтали и вертикали до определенной точки.

scrollBy([dynamic options_OR_x, dynamic y, Map? scrollOptions]) → void

Прокручивает страницу по горизонтали и вертикали на заданное смещение.

scrollTo([dynamic options_OR_x, dynamic y, Map? scrollOptions]) → void

Прокручивает страницу по горизонтали и вертикали до определенной точки.

stop() → void

Останавливает загрузку окна.

toString() → Строка

inherited

Строковое представление этого объекта.

Операторы

operator ==(Объект other) → bool

inherited

Оператор равенства.

Статические свойства

supportsPointConversions → bool

только для чтения

convertPointFromNodeToPage и convertPointFromPageToNode удалены. См. http://dev.w3.org/csswg/cssom-view/#geometry

Константы

animationEndEvent → const EventStreamProvider<AnimationEvent>

@SupportedBrowser(SupportedBrowser.CHROME), @SupportedBrowser(SupportedBrowser.SAFARI)

Статический фабричный метод, предназначенный для экспонирования событий animationend обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<AnimationEvent>('webkitAnimationEnd')

animationIterationEvent → const EventStreamProvider<AnimationEvent>

@SupportedBrowser(SupportedBrowser.CHROME), @SupportedBrowser(SupportedBrowser.SAFARI)

Статический фабричный метод, предназначенный для экспонирования событий animationiteration обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<AnimationEvent>('webkitAnimationIteration')

animationStartEvent → const EventStreamProvider<AnimationEvent>

@SupportedBrowser(SupportedBrowser.CHROME), @SupportedBrowser(SupportedBrowser.SAFARI)

Статический фабричный метод, предназначенный для экспонирования событий animationstart обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<AnimationEvent>('webkitAnimationStart')

beforeUnloadEvent → const EventStreamProvider<BeforeUnloadEvent>

Статический фабричный метод, предназначенный для экспонирования событий beforeunload обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider('beforeunload')

contentLoadedEvent → const EventStreamProvider<Event>

Статический фабричный метод, предназначенный для экспонирования событий contentloaded обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<Event>('DOMContentLoaded')

deviceMotionEvent → const EventStreamProvider<DeviceMotionEvent>

Статический фабричный метод, предназначенный для экспонирования событий devicemotion обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<DeviceMotionEvent>('devicemotion')

deviceOrientationEvent → const EventStreamProvider<DeviceOrientationEvent>

Статический фабричный метод, предназначенный для экспонирования событий deviceorientation обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<DeviceOrientationEvent>('deviceorientation')

hashChangeEvent → const EventStreamProvider<Event>

Статический фабричный метод, предназначенный для экспонирования событий hashchange обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<Event>('hashchange')

loadStartEvent → const EventStreamProvider<Event>

const EventStreamProvider<Event>('loadstart')

messageEvent → const EventStreamProvider<MessageEvent>

Статический фабричный метод, предназначенный для экспонирования событий message обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<MessageEvent>('message')

offlineEvent → const EventStreamProvider<Event>

Статический фабричный метод, предназначенный для экспонирования событий offline обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<Event>('offline')

onlineEvent → const EventStreamProvider<Event>

Статический фабричный метод, предназначенный для экспонирования событий online обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<Event>('online')

pageHideEvent → const EventStreamProvider<Event>

Статический фабричный метод, предназначенный для экспонирования событий pagehide обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<Event>('pagehide')

pageShowEvent → const EventStreamProvider<Event>

Статический фабричный метод, предназначенный для экспонирования событий pageshow обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<Event>('pageshow')

PERSISTENT → const int

Указывает, что данные файловой системы нельзя очистить без разрешения пользователя.

1

popStateEvent → const EventStreamProvider<PopStateEvent>

Статический фабричный метод, предназначенный для экспонирования событий popstate обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<PopStateEvent>('popstate')

progressEvent → const EventStreamProvider<Event>

const EventStreamProvider<Event>('progress')

storageEvent → const EventStreamProvider<StorageEvent>

Статический фабричный метод, предназначенный для экспонирования событий storage обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<StorageEvent>('storage')

TEMPORARY → const int

Указывает, что данные файловой системы могут быть очищены в любое время.

0

unloadEvent → const EventStreamProvider<Event>

Статический фабричный метод, предназначенный для экспонирования событий unload обработчикам событий, которые не обязательно являются экземплярами Window.

const EventStreamProvider<Event>('unload')