dart:html

提供与浏览器和 DOM(文档对象模型)交互的 Web 应用程序所需的 HTML 元素和其他资源。

注意

新项目应优先使用 package:web。对于现有项目,请参阅我们的迁移指南

该库包括 DOM 元素类型、CSS 样式、本地存储、媒体、语音、事件等功能。要入门,请参阅Element 类,它是许多 HTML DOM 类型的基类。

有关使用 Dart 编写 Web 应用的信息,请参阅https://dart.ac.cn/web

AbortPaymentEvent
AbsoluteOrientationSensor
AbstractWorker
Accelerometer
AccessibleNode
AccessibleNodeList
AmbientLightSensor
AnchorElement
Animation
AnimationEffectReadOnly
AnimationEffectTiming
AnimationEffectTimingReadOnly
AnimationEvent
AnimationPlaybackEvent
AnimationTimeline
AnimationWorkletGlobalScope
ApplicationCache
通过 Window.applicationCache 访问 ApplicationCache。
ApplicationCacheErrorEvent
AreaElement
DOM 区域元素,它将图像映射中的区域与超链接相关联。
AudioElement
AuthenticatorAssertionResponse
AuthenticatorAttestationResponse
AuthenticatorResponse
BackgroundFetchClickEvent
BackgroundFetchedEvent
BackgroundFetchEvent
BackgroundFetchFailEvent
BackgroundFetchFetch
BackgroundFetchManager
BackgroundFetchRegistration
BackgroundFetchSettledFetch
BarcodeDetector
BarProp
BaseElement
BatteryManager
BeforeInstallPromptEvent
BeforeUnloadEvent
Blob
BlobEvent
BluetoothRemoteGattDescriptor
Body
BodyElement
BRElement
BroadcastChannel
BudgetState
ButtonElement
ButtonInputElement
一个按钮,没有任何默认行为。
CacheStorage
CanMakePaymentEvent
CanvasCaptureMediaStreamTrack
CanvasElement
CanvasGradient
表示渐变的不可见画布对象。
CanvasImageSource
可以将对象绘制到 2D 画布渲染上下文的对象。
CanvasPattern
表示图像、画布或视频模式的不可见对象。
CanvasRenderingContext
CanvasRenderingContext2D
CDataSection
CharacterData
CheckboxInputElement
一个布尔编辑控件。
ChildNode
Client
Clients
ClipboardEvent
CloseEvent
Comment
CompositionEvent
Console
ContentElement
CookieStore
Coordinates
Credential
CredentialsContainer
CredentialUserData
Crypto
CryptoKey
Css
CssCharsetRule
CssClassSet
存储元素 CSS 类名的 Set。
CssConditionRule
CssFontFaceRule
CssGroupingRule
CssImageValue
CssImportRule
CssKeyframeRule
CssKeyframesRule
CssKeywordValue
CssMatrixComponent
CssMediaRule
CssNamespaceRule
CssNumericValue
CssPageRule
CssPerspective
CssPositionValue
CssRect
表示 CSS 维度的类。
CssResourceValue
CssRotation
CssRule
CssScale
CssSkew
CssStyleDeclaration
CssStyleDeclarationBase
CssStyleRule
CssStyleSheet
CssStyleValue
CssSupportsRule
CssTransformComponent
CssTransformValue
CssTranslation
CssUnitValue
CssUnparsedValue
CssurlImageValue
CssVariableReferenceValue
CssViewportRule
CustomElementRegistry
CustomEvent
CustomStream<T extends Event>
一组自定义事件,使用户能够将自定义事件“触发”(添加)到流中。
DataElement
DataListElement
DataTransfer
DataTransferItem
DataTransferItemList
DateInputElement
一个不包含时区的日期(年、月、日)。
DedicatedWorkerGlobalScope
已弃用的StorageInfo
已弃用的StorageQuota
DeprecationReport
DetailsElement
DetectedBarcode
DetectedFace
DetectedText
DeviceAcceleration
DeviceMotionEvent
DeviceOrientationEvent
DeviceRotationRate
DialogElement
Dimension
代表CSS中长度测量的类。
DirectoryEntry
DirectoryReader
DivElement
一个HTML页面上内容的通用容器;对应于<div>标签。
DListElement
Document
所有文档的基类。
DocumentFragment
DocumentOrShadowRoot
DocumentTimeline
DomError
DomException
DomImplementation
DomIterator
DomMatrix
DomMatrixReadOnly
DomParser
DomPoint
DomPointReadOnly
DomQuad
DomRectList
DomRectReadOnly
DomStringList
DomStringMap
DomTokenList
Element
一个抽象类,所有HTML元素都扩展此类。
ElementEvents
ElementList<T extends Element>
包含HTML元素的不可变列表。与常规列表相比,该列表包含一些额外的功能,以便在元素组上方便地进行CSS操作。
ElementStream<T extends Event>
一种可专门用于元素的、使事件代理成为可能的专业化Stream。
ElementUpgrader
一个用于更改元素Dart包装类型的实用程序。
EmailInputElement
电子邮件地址或电子邮件地址列表。
EmbedElement
Entry
ErrorEvent
Event
Events
支持监听和分发浏览器事件的基类。
EventSource
EventStreamProvider<T extends Event>
一个工厂,用于将DOM事件公开为Stream。
EventTarget
所有支持事件浏览器对象的基类。
ExtendableEvent
ExtendableMessageEvent
External
FaceDetector
FederatedCredential
FetchEvent
FieldSetElement
File
FileEntry
FileList
FileReader
FileSystem
FileUploadInputElement
一个从用户的计算机中选择文件的控件。
FileWriter
FixedSizeListIterator<T>
FocusEvent
FontFace
FontFaceSet
FontFaceSetLoadEvent
FontFaceSource
ForeignFetchEvent
FormData
FormElement
Gamepad
GamepadButton
GamepadEvent
GamepadPose
Geolocation
Geoposition
GlobalEventHandlers
Gyroscope
HashChangeEvent
HeadElement
Headers
HeadingElement
HiddenInputElement
不可见或不可编辑的隐藏输入。
History
HistoryBase
HRElement
<hr> 标签。
HtmlCollection
HtmlDocument
HtmlElement
HtmlFormControlsCollection
HtmlHtmlElement
HtmlHyperlinkElementUtils
HtmlOptionsCollection
HttpRequest
一种用于从URL获取数据的客户端XHR请求,正式名称为XMLHttpRequest。
HttpRequestEventTarget
HttpRequestUpload
HttpStatus
HTTP状态码。在dart:io和dart:html中导出。
IdleDeadline
IFrameElement
ImageBitmap
ImageBitmapRenderingContext
ImageButtonInputElement
用户可以选择坐标的图片或表单提交按钮。
ImageCapture
ImageData
ImageElement
ImmutableListMixin<E>
InputDeviceCapabilities
InputElement
InputElementBase
公开了所有 InputElement 类型之间的公共功能。
InstallEvent
IntersectionObserver
IntersectionObserverEntry
InterventionReport
KeyEvent
描述用户与键盘交互的事件。
KeyEventStream
记录特定元素上发生的 KeyboardEvent,并提供一个带有跨浏览器一致的 keyCode 和 charCode 值的 outgoing KeyEvents 流,尽管许多浏览器具有不同的键盘默认行为。
KeyCode
定义了 KeyboardEvent.keyCode 返回的键码值。
KeyEvent
一个自定义的 KeyboardEvent,试图消除跨浏览器的差异,并为所有按键事件(当可以确定此类信息时)提供 keyCode 和 charCode 信息。
KeyframeEffect
KeyframeEffectReadOnly
KeyLocation
定义了 KeyboardEvent.getKeyLocation 返回的标准键位位置。
LabelElement
LegendElement
LIElement
LinearAccelerationSensor
LinkElement
LocalDateTimeInputElement
一个没有时区的日期和时间(年、月、日、时、分、秒、秒分之一)。
Location
LocationBase
Magnetometer
MapElement
MathMLElement
MediaCapabilities
MediaCapabilitiesInfo
MediaDeviceInfo
MediaDevices
MediaElement
MediaEncryptedEvent
MediaError
MediaKeyMessageEvent
MediaKeys
MediaKeySession
MediaKeysPolicy
MediaKeyStatusMap
MediaKeySystemAccess
MediaList
MediaMetadata
MediaQueryList
MediaQueryListEvent
MediaRecorder
MediaSession
MediaSettingsRange
MediaSource
MediaStream
MediaStreamEvent
MediaStreamTrack
MediaStreamTrackEvent
MemoryInfo
HTML
MessageChannel
MessageEvent
MessagePort
Metadata
MetaElement
MeterElement
MidiAccess
MidiConnectionEvent
MidiInput
MidiInputMap
MidiMessageEvent
MidiOutput
MidiOutputMap
MidiPort
MimeType
MimeTypeArray
ModElement
MonthInputElement
由年月组成的日期,没有时区。
MouseEvent
MutationEvent
MutationObserver
MutationRecord
NetworkInformation
Node
NodeFilter
NodeIterator
NodeList
NodeTreeSanitizer
在构造节点树之后执行清理,以确保它不包含任何不允许的元素或属性。
NodeValidator
在解析 HTML 字符串到 DOM 节点时使用的接口,用于验证仅允许接受元素和属性。
NodeValidatorBuilder
帮助构建标准节点验证策略的类。
NoncedElement
NonDocumentTypeChildNode
NonElementParentNode
Notification
NotificationEvent
NumberInputElement
一个数值编辑控件。
ObjectElement
OffscreenCanvas
OffscreenCanvasRenderingContext2D
OListElement
OptGroupElement
OptionElement
OrientationSensor
OutputElement
OverconstrainedError
PageTransitionEvent
PaintRenderingContext2D
PaintSize
PaintWorkletGlobalScope
ParagraphElement
ParamElement
ParentNode
PasswordCredential
PasswordInputElement
无换行符的文本(敏感信息)。
Path2D
PaymentAddress
PaymentInstruments
支付管理器
支付请求
支付请求事件
支付请求更新事件
支付响应
性能
性能条目
性能长时间任务计时
性能标记
性能测量
性能导航
性能导航计时
性能观察者
性能观察者条目列表
性能绘制计时
性能资源计时
性能服务器计时
性能计时
权限
权限状态
照片功能
图片元素
平台
插件
插件数组
Point<T extends num>
用于表示二维位置的实用类。
指针事件
弹出状态事件
位置错误
前提元素
展示
展示可用性
展示连接
展示连接可用事件
展示连接关闭事件
展示连接列表
展示接收者
展示请求
处理指令
进度元素
进度事件
承诺拒绝事件
公钥凭证
推送事件
推送管理器
推送消息数据
推送订阅
推送订阅选项
引号元素
单选按钮输入元素
当与其他 单选按钮输入元素一同使用时,该控件可以构成一个单选按钮组,其中一次只能勾选一个控件。
范围
范围输入元素
类似于 数字输入元素, но браузер может предоставлять более оптимальное форматирование (например, контроллер ползункового интерфейса).
范围输入元素基
所有涉及范围的输入元素类型的基数接口。
ReadyState
包含HTMLDocument.getReadyState返回的标准值集。
Rectangle<T extends num>
用于表示二维矩形且属性不可变的类。
相关应用程序
相对方向传感器
远程回放
报告正文
报告观察者
重置按钮输入元素
一个按钮,点击时会重置表单。
调整大小观察者
调整大小观察者条目
RtcCertificate
RtcDataChannel
RtcDataChannelEvent
RtcDtmfSender
RtcDtmfToneChangeEvent
RtcIceCandidate
RtcLegacyStatsReport
RtcPeerConnection
RtcPeerConnectionIceEvent
RtcRtpContributingSource
RtcRtpReceiver
RtcRtpSender
RtcSessionDescription
RtcStatsReport
RtcStatsResponse
RtcTrackEvent
屏幕
屏幕方向
脚本元素
滚动对齐
Element.scrollIntoView选项。
滚动状态
滚动时间轴
搜索输入元素
类似于 文本输入元素,但在平台中对搜索进行不同样式设置的情况下,这将获取搜索样式。
安全策略违反事件
选择元素
选择
传感器
传感器错误事件
服务工作者
服务工作者容器
服务工作者全局范围
服务工作者注册
阴影元素
阴影根
SharedArrayBuffer
共享工作者
共享工作者全局范围
插槽元素
源缓冲区
源缓冲区列表
源元素
跨度元素
语音语法
语音语法列表
语音识别
语音识别替代方案
语音识别错误
语音识别事件
语音识别结果
语音合成
语音合成事件
语音合成语句
语音合成声音
静态范围
存储
该类型由Window.localStorageWindow.sessionStorage属性使用。存储实现为一个Map
存储事件
存储管理器
样式元素
样式媒体
样式属性映射
只读样式属性映射
样式表
提交按钮输入元素
一个按钮,点击时会提交表单。
同步事件
同步管理器
表头元素
表格单元格元素
表格列元素
表格元素
表格行元素
表格部分元素
任务分配时间
电话输入元素
表示用于编辑电话号码的控件。
模板元素
文本
文本区域元素
文本检测器
文本事件
文本输入元素
一个基本的文本输入编辑控件。
文本输入元素基类
所有涉及文本编辑的输入的基础接口。
文本度量
文本轨道
文本轨道提示
文本轨道提示列表
文本轨道列表
时间元素
时间输入元素
一个不含时区的时间(小时、分钟、秒、分数秒)。
时间范围
标题元素
触碰
触碰事件
触碰列表
轨道默认值
轨道默认值列表
轨道元素
轨道事件
过渡事件
树遍历器
受信任的HTML
受信任的脚本URL
受信任的URL
UI事件
无序列表元素
基础底层源
未知元素
URI策略
定义了特定属性值允许的URI类型策略。
URL
URL输入元素
用于编辑绝对URL的控件。
URL查询参数
只读的URL实用工具
有效性状态
视频元素
视频播放质量
视频轨道
视频轨道列表
可视视口
虚拟现实
虚拟现实坐标系
虚拟现实设备
虚拟现实设备事件
虚拟现实显示
虚拟现实显示能力
虚拟现实显示事件
虚拟现实眼睛参数
虚拟现实帧数据
虚拟现实参考帧
虚拟现实姿态
虚拟现实会话
虚拟现实会话事件
虚拟现实舞台界限
虚拟现实舞台界限点
虚拟现实舞台参数
Vtt提示
Vtt区域
WebSocket
使用WebSocket接口连接到WebSocket,并在该WebSocket上发送和接收数据。
周输入元素
由周年数和周数组成的日期,不含时区。
滚轮事件
窗口
当前浏览器标签或窗口的最高层容器。
窗口基类
浏览器标签或窗口的最高层容器。
窗口Base64
窗口客户端
窗口事件处理程序
工作者
工作者全局作用域
工作者性能
工作工具动画
工作工具全局作用域
XML文档
XML序列化器
XPath评估器
XPath表达式
XPath命名空间解析器
XPath结果
XSLT处理器

属性

document HtmlDocument
网页中所有内容的根节点。
无设置器
window Window
网页的最高层容器,通常是浏览器标签或窗口。
无设置器

函数

promiseToFuture<T>(Object jsPromise) Future<T>
将JavaScript Promise转换为Dart Future
promiseToFutureAsMap(dynamic jsPromise) Future<Map<String, dynamic>?>
将JS Promise转换为Future<Map<String, dynamic>>。
querySelector(String selectors) Element?
在文档中查找第一个匹配指定选择器的子元素。
querySelectorAll<T extends Element>(String selectors) ElementList<T>
查找文档中所有匹配指定选择器的子元素。

类型别名

BlobCallback = void Function(Blob? blob)
CustomElementConstructor = void Function()
DecodeErrorCallback = void Function(DomException error)
DecodeSuccessCallback = void Function(AudioBuffer decodedData)
EventListener = dynamic Function(Event event)
FontFaceSetForEachCallback = void Function(FontFace fontFace, FontFace fontFaceAgain, FontFaceSet set)
对于任何需要回调签名的类似集合的 IDL 条目都会发出。今天只有一个。
FrameRequestCallback = void Function(num highResTime)
FunctionStringCallback = void Function(String data)
IdleRequestCallback = void Function(IdleDeadline deadline)
IntersectionObserverCallback = void Function(List entries, IntersectionObserver observer)
MediaSessionActionHandler = void Function()
MessageCallback = void Function(Map message)
MetadataCallback = void Function(Metadata metadata)
MojoWatchCallback = void Function(int result)
MutationCallback = void Function(List mutations, MutationObserver observer)
PerformanceObserverCallback = void Function(PerformanceObserverEntryList entries, PerformanceObserver observer)
RemotePlaybackAvailabilityCallback = void Function(bool available)
ReportingObserverCallback = void Function(List reports, ReportingObserver observer)
RequestAnimationFrameCallback = void Function(num highResTime)
ResizeObserverCallback = void Function(List entries, ResizeObserver observer)
RtcPeerConnectionErrorCallback = void Function(DomException exception)
RtcStatsCallback = void Function(RtcStatsResponse response)
ScrollStateCallback = void Function(ScrollState scrollState)
StorageErrorCallback = void Function(DomError error)
StorageQuotaCallback = void Function(int grantedQuotaInBytes)
StorageUsageCallback = void Function(int currentUsageInBytes, int currentQuotaInBytes)
TimeoutHandler = void Function()
VoidCallback = void Function()

异常 / 错误

NullWindowException