Библиотека dart:html

HTML-элементы и другие ресурсы для веб-приложений, которым требуется взаимодействие с браузером и DOM (Document Object Model).

Эта библиотека включает типы элементов DOM, стили CSS, локальное хранилище, медиа, речь, события и многое другое. Для начала работы ознакомьтесь с классом Element, базовым классом для многих типов HTML DOM.

Другие ресурсы

• Если вы никогда не писали веб-приложений, попробуйте наши учебные пособия — Игра в Дартс.

• Чтобы увидеть работающие веб-приложения Dart и поработать с кодом, скачайте Dart Editor и запустите встроенные примеры.

• Для ещё большего количества примеров, см. Примеры Dart HTML5 на Github.

Типы функций

BlobCallback(Blob blob) → void

@DomName('BlobCallback'), @Experimental()

DatabaseCallback(SqlDatabase database) → void

@DomName('DatabaseCallback'), @Experimental()

EventListener(Event event) → dynamic

FontFaceSetForEachCallback(FontFace fontFace, FontFace fontFaceAgain, FontFaceSet set) → void

@DomName('FontFaceSetForEachCallback'), @Experimental()

Вызывается для любого набора, требующего обработчика.

FrameRequestCallback(num highResTime) → void

@DomName('FrameRequestCallback'), @Experimental()

IdleRequestCallback(IdleDeadline deadline) → void

@DomName('IdleRequestCallback'), @Experimental()

MediaStreamTrackSourcesCallback(List<SourceInfo> sources) → void

@DomName('MediaStreamTrackSourcesCallback'), @Experimental()

MetadataCallback(Metadata metadata) → void

@DomName('MetadataCallback'), @Experimental()

MutationCallback(List<MutationRecord> mutations, MutationObserver observer) → void

@DomName('MutationCallback')

RequestAnimationFrameCallback(num highResTime) → void

@DomName('RequestAnimationFrameCallback')

RtcPeerConnectionErrorCallback(DomException exception) → void

@DomName('RTCPeerConnectionErrorCallback'), @Experimental()

RtcStatsCallback(RtcStatsResponse response) → void

@DomName('RTCStatsCallback'), @Experimental()

ScrollStateCallback(ScrollState scrollState) → void

@DomName('ScrollStateCallback'), @Experimental()

StorageErrorCallback(DomError error) → void

@DomName('StorageErrorCallback'), @Experimental()

StorageQuotaCallback(int grantedQuotaInBytes) → void

@DomName('StorageQuotaCallback'), @Experimental()

StorageUsageCallback(int currentUsageInBytes, int currentQuotaInBytes) → void

@DomName('StorageUsageCallback'), @Experimental()

TimeoutHandler() → void

@DomName('TimeoutHandler')

VoidCallback() → void

@DomName('VoidCallback'), @Experimental()

Свойства

document → HtmlDocument

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

Корневой узел для всего содержимого веб-страницы.

htmlBlinkMap → dynamic

@Deprecated("Только для внутреннего использования"), final

window → Window

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

Контейнер верхнего уровня для веб-страницы, который обычно является вкладкой браузера или окном.

Функции

convertNativeObjectToDartMap(JsObject jsObject) → Map<String, dynamic>

@Deprecated("Только для внутреннего использования")

debug_or_assert(message, expression) → dynamic

@Deprecated("Только для внутреннего использования")

getHtmlCreateType(String key) → dynamic

@Deprecated("Только для внутреннего использования")

query(String relativeSelectors) → Element

@Experimental()

Псевдоним для querySelector. Обратите внимание, что эта функция устарела, так как её семантика будет изменена в будущем.

queryAll(String relativeSelectors) → ElementList<Element>

@Experimental()

Псевдоним для querySelectorAll. Обратите внимание, что эта функция устарела, так как её семантика будет изменена в будущем.

querySelector(String selectors) → Element

Находит первый дочерний элемент этого документа, который соответствует заданной группе селекторов.

querySelectorAll(String selectors) → ElementList<Element>

Находит все дочерние элементы этого документа, которые соответствуют заданной группе селекторов.

spawnDomUri(Uri uri, List<String> args, message) → Future<Isolate>

@Experimental()

Создаёт изолированный DOM-объект, используя заданный URI в том же окне. Эта изоляция не является параллельной. Она выполняется в потоке браузера с полным доступом к DOM. Примечание: этот API всё ещё находится в разработке и может быть перенесен в dart:isolate.

Классы

AbstractWorker

Элемент якоря

Анимация

Только для чтения эффект анимации

Временные характеристики эффекта анимации

Событие анимации

Событие плеера анимации

Временная шкала анимации

Результат запроса на отображение баннера приложения

Кэш приложения

К Кэшу приложения можно получить доступ через Window.applicationCache.

Событие ошибки кэша приложения

Элемент области

Элемент области DOM, который связывает области изображения со ссылкой.

Элемент аудио

Аудиодорожка

Список аудиодорожек

Событие ошибки автозаполнения

Свойство панели

Базовый элемент

Менеджер батареи

Событие перед запросом на установку

Событие перед закрытием страницы

Объект Blob

Событие Blob

Тело

Элемент тела

Элемент <br>

Элемент кнопки

Элемент ввода кнопки

Кнопка без стандартного поведения.

Хранилище кэша

Вычисляемая длина

Отслеживание потока медиа для захвата на холсте

Элемент холста

Градиент холста

Непрозрамый объект холста, представляющий градиент.

Источник изображения холста

Объект, который можно нарисовать на контексте 2D-рендеринга холста.

Образец холста

Непрозрачный объект, представляющий шаблон изображения, холста или видео.

Контекст рендеринга холста

Контекст рендеринга 2D холста

Секция CData

Данные символов

Элемент ввода флажка

Элемент управления для булевых значений.

Дочерний узел

Буфер значений Chromium

Круговой регион геоограждения

Клиент

Клиенты

Событие буфера обмена

Событие закрытия

Комментарий

Событие ввода

Прокси композитора

Рабочий процесс композитора

Глобальная область видимости рабочего процесса композитора

Консоль

Базовая консоль

Элемент содержимого

Координаты

Удостоверение

Контейнер удостоверений

Клиент междоменного сервисного работника

Криптография

Криптографический ключ

CSS

Правило кодировки символов CSS

Набор классов CSS

Множество, хранящее имена классов CSS для элемента.

Правило шрифта CSS

Правило группировки CSS

Правило импорта CSS

Правило ключевой кадра CSS

Правило ключевых кадров CSS

Правило среды CSS

Правило пространства имён CSS

Правило страницы CSS

Прямоугольник CSS

Класс для представления размеров CSS.

Правило CSS

Объявление стиля CSS

Базовое объявление стиля CSS

Правило стиля CSS

Стили CSS

Правило поддержки CSS

Правило области просмотра CSS

Пользовательское событие

Пользовательский поток

Поток пользовательских событий, который позволяет пользователю «запускать» (добавлять) собственные пользовательские события в поток.

Абстрактный объект DOM DartHtml

Абстрактный класс для всех объектов DOM, которые мы оборачиваем в dart:html и связанных библиотеках.

Элемент списка данных

Передача данных

Элемент передачи данных

Список элементов передачи данных

Элемент даты

Дата (год, месяц, день) без часового пояса.

Глобальная область видимости выделенного рабочего процесса

Информация о хранилище (устарело)

Квота хранилища (устарело)

Элемент подробностей

Ускорение устройства

Событие освещения устройства

Событие движения устройства

Событие ориентации устройства

Скорость вращения устройства

Элемент диалога

Размер

Класс, представляющий единицу измерения длины в CSS.

Элемент каталога

Чтец каталога

Элемент <div>

Универсальный контейнер для содержимого на HTML-странице; соответствует тегу <div>.

Элемент списка определений

Документ

Базовый класс для всех документов.

Фрагмент документа

Ошибка DOM

Исключение DOM

Реализация DOM

Итератор DOM

Матрица DOM

Только для чтения матрица DOM

Парсер DOM

Точка DOM

Только для чтения точка DOM

Только для чтения прямоугольник DOM

Список строк DOM

Карта строк DOM

Список маркеров DOM

Модель эффекта

Элемент

Абстрактный класс, от которого наследуются все HTML-элементы.

События элемента

Список элементов

Неизменяемый список, содержащий HTML-элементы. Этот список содержит дополнительные методы по сравнению с обычными списками для удобства манипулирования CSS группой элементов.

Поток элементов

Специализированный поток, доступный для элементов Element для реализации делегирования событий.

Улучшитель элемента

Утилита для изменения типа оболочки Dart для элементов.

Элемент ввода email

Адрес электронной почты или список адресов электронной почты.

EmbedElement

Entry

ErrorEvent

Event

Events

Базовый класс, поддерживающий прослушивание и отправку событий браузера.

EventSource

EventStreamProvider

Фабрика для экспонирования событий DOM как потоков.

EventTarget

Базовый класс для всех объектов браузера, поддерживающих события.

ExtendableEvent

ExtendableMessageEvent

FederatedCredential

FetchEvent

FieldSetElement

File

FileEntry

FileError

FileList

FileReader

FileStream

FileSystem

FileUploadInputElement

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

FileWriter

FixedSizeListIterator

FocusEvent

FontFace

FontFaceSet

FontFaceSetLoadEvent

FormData

FormElement

Gamepad

GamepadButton

GamepadEvent

Geofencing

GeofencingEvent

GeofencingRegion

Geolocation

Geoposition

GlobalEventHandlers

HashChangeEvent

HeadElement

Headers

HeadingElement

HiddenInputElement

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

History

HistoryBase

HmdvrDevice

HRElement

Тег <hr>.

HtmlCollection

HtmlDocument

HtmlElement

HtmlFormControlsCollection

HtmlHtmlElement

HtmlOptionsCollection

HttpRequest

Запрос XHR на стороне клиента для получения данных с URL, формально известный как XMLHttpRequest.

HttpRequestEventTarget

HttpRequestUpload

IdleDeadline

IFrameElement

ImageBitmap

ImageBitmapRenderingContext

ImageButtonInputElement

Либо изображение, по которому пользователь может выбрать координаты, либо кнопка отправки формы.

ImageData

ImageElement

ImmutableListMixin

InjectedScriptHost

InputDeviceCapabilities

InputElement

InputElementBase

Выполняет общие функции для всех типов InputElement.

InstallEvent

IntersectionObserver

IntersectionObserverEntry

KeyboardEvent

KeyboardEventStream

Записывает KeyboardEvents, происходящие на определенном элементе, и предоставляет поток исходящих KeyEvents с кроссбраузерно согласованными значениями keyCode и charCode, несмотря на то, что множество браузеров имеют различное поведение по умолчанию клавиатуры.

KeyCode

Определяет значения keycode для клавиш, которые возвращаются свойством KeyboardEvent.keyCode.

KeyEvent

Пользовательское событие KeyboardEvent, которое пытается устранить несовместимость между браузерами, а также предоставить информацию keyCode и charCode для всех событий нажатия клавиш (когда такая информация может быть определена).

KeyframeEffect

KeygenElement

KeyLocation

Определяет стандартные расположения клавиш, возвращаемые свойством KeyboardEvent.getKeyLocation.

KeywordValue

LabelElement

LegendElement

LengthValue

LIElement

LinkElement

LocalDateTimeInputElement

Дата и время (год, месяц, день, час, минута, секунда, доля секунды) без часового пояса.

Location

LocationBase

MapElement

Matrix

MediaDeviceInfo

MediaDevices

MediaElement

MediaEncryptedEvent

MediaError

MediaKeyMessageEvent

MediaKeys

MediaKeySession

MediaKeyStatusMap

MediaKeySystemAccess

MediaList

MediaMetadata

MediaQueryList

MediaQueryListEvent

MediaRecorder

MediaSession

MediaSource

MediaStream

MediaStreamEvent

MediaStreamTrack

MediaStreamTrackEvent

MemoryInfo

MenuElement

HTML-элемент

MenuItemElement

MessageChannel

MessageEvent

MessagePort

Metadata

MetaElement

MeterElement

MidiAccess

MidiConnectionEvent

MidiInput

MidiInputMap

MidiMessageEvent

MidiOutput

MidiOutputMap

MidiPort

MimeType

MimeTypeArray

ModElement

MonthInputElement

Дата, состоящая из года и месяца без часового пояса.

MouseEvent

MutationObserver

MutationRecord

Navigator

NavigatorCpu

NavigatorID

NavigatorLanguage

NavigatorOnLine

NavigatorStorageUtils

NavigatorUserMediaError

NetworkInformation

Node

NodeFilter

NodeIterator

NodeList

NodeTreeSanitizer

Выполняет очистку дерева узлов после создания, чтобы убедиться, что оно не содержит запрещённых элементов или атрибутов.

NodeValidator

Интерфейс, используемый для проверки того, что при разборе строк HTML в узлы DOM разрешены только допустимые элементы и атрибуты.

NodeValidatorBuilder

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

NonDocumentTypeChildNode

NonElementParentNode

Notification

NotificationEvent

NumberInputElement

Числовой элемент управления.

NumberValue

ObjectElement

OffscreenCanvas

OListElement

OptGroupElement

OptionElement

OutputElement

PageTransitionEvent

ParagraphElement

ParamElement

ParentNode

PasswordCredential

PasswordInputElement

Текст без переносов (конфиденциальная информация).

Path2D

Performance

PerformanceCompositeTiming

PerformanceEntry

PerformanceMark

PerformanceMeasure

PerformanceNavigation

PerformanceObserver

PerformanceObserverEntryList

PerformanceRenderTiming

PerformanceResourceTiming

PerformanceTiming

Permissions

PermissionStatus

Perspective

PictureElement

Platform

Plugin

PluginArray

Point

Утилитарный класс для представления двумерных позиций.

PointerEvent

PopStateEvent

PositionError

PositionSensorVRDevice

PositionValue

PreElement

Presentation

PresentationAvailability

PresentationConnection

PresentationConnectionAvailableEvent

PresentationConnectionCloseEvent

PresentationReceiver

PresentationRequest

ProcessingInstruction

ProgressElement

ProgressEvent

PromiseRejectionEvent

PushEvent

PushManager

PushMessageData

PushSubscription

QuoteElement

RadioButtonInputElement

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

Range

RangeInputElement

Аналогичен NumberInputElement, но браузер может обеспечить более оптимальную стилизацию (например, элемент управления ползунком).

RangeInputElementBase

Базовый интерфейс для всех типов элементов управления вводом, которые включают диапазоны.

ReadableByteStream

ReadableByteStreamReader

ReadableStreamReader

ReadyState

Содержит набор стандартных значений, возвращаемых HTMLDocument.getReadyState.

Rectangle

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

RelatedEvent

ResetButtonInputElement

Кнопка, которая при нажатии сбрасывает форму.

Rotation

RtcCertificate

RtcDataChannel

RtcDataChannelEvent

RtcDtmfSender

RtcDtmfToneChangeEvent

RtcIceCandidate

RtcIceCandidateEvent

RtcPeerConnection

RtcSessionDescription

RtcStatsReport

RtcStatsResponse

Screen

ScreenOrientation

ScriptElement

ScrollAlignment

Параметры для Element.scrollIntoView.

ScrollState

SearchInputElement

Аналогичен TextInputElement, но на платформах, где поиск стилизуется иначе, он получит стиль поиска.

SecurityPolicyViolationEvent

SelectElement

Selection

ServicePort

ServicePortCollection

ServicePortConnectEvent

ServiceWorkerContainer

ServiceWorkerGlobalScope

ServiceWorkerMessageEvent

ServiceWorkerRegistration

ShadowElement

ShadowRoot

SharedArrayBuffer

SharedWorker

Рабочий контекст SharedWorker

Простая длина

Наклон

Элемент слота

Буфер источника

Список буферов источника

Элемент источника

Информация об источнике

Элемент span

Грамматика речи

Список грамматик речи

Распознавание речи

Альтернатива распознавания речи

Ошибка распознавания речи

Событие распознавания речи

Результат распознавания речи

Синтез речи

Событие синтеза речи

Высказывание синтеза речи

Голос синтеза речи

Хранилище

Тип, используемый свойствами Window.localStorage и Window.sessionStorage. Хранилище реализовано как Map<String, String>.

Событие хранения

Информация о хранилище

Менеджер хранилища

Квота хранилища

Элемент стиля

Среда стиля

Карта свойств стиля

Таблица стилей

Значение стиля

Элемент input типа submit

Кнопка, которая при нажатии отправляет форму.

Событие синхронизации

Менеджер синхронизации

Элемент подписи таблицы

Элемент ячейки таблицы

Элемент столбца таблицы

Элемент таблицы

Элемент строки таблицы

Элемент раздела таблицы

Элемент input типа телефон

Представляет элемент управления для редактирования номера телефона.

Элемент шаблона

Текст

Элемент textarea

Событие текста

Элемент input типа текст

Основной элемент управления для редактирования текста.

Базовый интерфейс TextInputElement

Базовый интерфейс для всех элементов ввода, связанных с редактированием текста.

Метрики текста

Дорожка текста

Подпись дорожки текста

Список подписей дорожки текста

Список дорожек текста

Элемент input типа время

Время (час, минута, секунда, дробная секунда) без часового пояса.

Диапазоны времени

Элемент заголовка

Нажатие

Событие касания

Список касаний

Значение по умолчанию для дорожки

Список значений по умолчанию для дорожек

Элемент дорожки

Событие дорожки

Компонент преобразования

Значение преобразования

Событие перехода

Перевод

Обход дерева

Событие пользовательского интерфейса

Элемент маркированного списка

Базовый класс для исходных данных

Неизвестный элемент

Политика URI

Определяет политику для разрешенных типов URI для определённых значений атрибутов.

URL

Элемент input типа URL

Элемент управления для редактирования абсолютного URL.

Параметры запроса URL

Утилиты URL

Только чтение Утилиты URL

Состояние валидности

Элемент видео

Качество воспроизведения видео

Дорожка видео

Список дорожек видео

VR-устройство

Параметры VR глаза

Область видимости VR

Состояние VR позиции

Подпись VTT

Регион VTT

Список регионов VTT

WebSocket

Используйте интерфейс WebSocket для подключения к WebSocket и для отправки и получения данных по этому WebSocket.

Элемент input типа неделя

Дата, состоящая из номера недели-года и номера недели без часового пояса.

Событие прокрутки

Окно браузера

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

Базовый класс окна

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

Окно Base64

Клиентское окно

Обработчики событий окна

Рабочий поток

Консоль рабочего потока

Рабочий контекст Worker

Производительность рабочего потока

XML-документ

Сериализатор XML

Оцениватель XPath

Выражение XPath

Разрешитель пространства имён XPath

Результат XPath

Обработчик XSLT

Исключения / Ошибки

Исключение DebugAssert