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 Area 元素,它将图像映射的各个区域与超链接链接起来。
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
代表渐变的不可见 canvas 对象。
CanvasImageSource
可以绘制到 2D 渲染上下文的对象。
CanvasPattern
代表图像、canvas 或视频模式的不可见对象。
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
数据列表元素
数据传输
数据传输项
数据传输项列表
日期输入元素
没有时区的日期(年、月、日)。
专用工作全局作用域
已弃用的存储信息
已弃用的存储配额
弃用报告
详细信息元素
检测到的条形码
检测到的面部
检测到的文本
设备加速
设备运动事件
设备方向事件
设备旋转速率
对话框元素
尺寸
表示CSS中长度测量的类。
目录条目
目录读取器
div元素
一个通用的HTML页面内容容器;对应于
标签。
DList元素
文档
所有文档的基类。
文档片段
文档或阴影根
文档时间线
DOM错误
DOM异常
DOM实现
DOM迭代器
DOM矩阵
DOM只读矩阵
DOM解析器
DOM点
DOM只读点
DOM四边形
DOM矩形列表
DOM只读矩形
DOM字符串列表
DOM字符串映射
DOM令牌列表
元素
一个抽象类,所有HTML元素都继承自它。
元素事件
ElementList<T extends Element>
一个包含HTML元素的不可变列表。与常规列表相比,此列表包含一些额外的功能,便于对一组元素进行CSS操作。
ElementStream<T extends Event>
一个专门的Stream,可由Element使用以实现事件委托。
元素升级器
一个用于更改元素Dart包装类型的实用工具。
电子邮件输入元素
电子邮件地址或电子邮件地址列表。
嵌入元素
条目
错误事件
事件
事件
支持监听和调度浏览器事件的基类。
事件源
EventStreamProvider<T extends Event>
一个工厂,用于将DOM事件公开为Streams。
事件目标
所有支持事件浏览器对象的基类。
可扩展事件
可扩展消息事件
外部
面部检测器
联邦凭证
Fetch事件
表单集元素
文件
文件条目
文件列表
文件读取器
文件系统
文件上传输入元素
一个用于从用户的计算机中选择文件的控件。
文件写入器
FixedSizeListIterator<T>
焦点事件
字体面
字体面集
字体面集加载事件
字体面源
外部Fetch事件
表单数据
表单元素
游戏手柄
游戏手柄按钮
游戏手柄事件
游戏手柄姿态
地理位置
地理位置
全局事件处理器
陀螺仪
哈希变化事件
头部元素
头部
标题元素
隐藏输入元素
隐藏的输入,用户不应看到或编辑。
历史记录
历史基础
HRElement
一个<hr>标签。
Html集合
Html文档
Html元素
Html表单控件集合
HtmlHtmlElement
Html超链接元素实用工具
Html选项集合
HttpRequest
一个客户端XHR请求,用于从URL获取数据,正式称为XMLHttpRequest。
HttpRequestEventTarget
HttpRequestUpload
HttpStatus
HTTP状态码。在dart:io和dart:html中导出。
IdleDeadline
IFrameElement
ImageBitmap
ImageBitmapRenderingContext
ImageButtonInputElement
可以是用户可以选定坐标的图像,也可以是表单提交按钮。
ImageCapture
图像数据
图像元素
不可变列表混合<E>
输入设备能力
输入元素
输入元素基类
暴露所有输入元素类型共有的功能。
安装事件
交叉观察器
交叉观察器条目
干预报告
键盘事件
描述用户与键盘交互的事件。
键盘事件流
记录特定元素上发生的键盘事件,并提供带有跨浏览器一致性的keyCode和charCode值的输出键盘事件流,尽管许多浏览器具有不同的键盘默认行为。
键码
定义由KeyboardEvent.keyCode返回的键的键码值。
键盘事件
一个自定义的KeyboardEvent,旨在消除跨浏览器的差异,并提供所有键事件(当可以确定时)的keyCode和charCode信息。
关键帧效果
关键帧效果只读
键位置
定义由KeyboardEvent.getKeyLocation返回的标准键位置。
标签元素
图例元素
列表元素
线性加速度传感器
链接元素
本地日期时间输入元素
一个没有时区的日期和时间(年、月、日、小时、分钟、秒、秒的小数部分)。
位置
位置基类
磁力计
地图元素
MathML元素
媒体能力
媒体能力信息
媒体设备信息
媒体设备
媒体元素
媒体加密事件
媒体错误
媒体密钥消息事件
媒体密钥
媒体密钥会话
媒体密钥策略
媒体密钥状态映射
媒体密钥系统访问
媒体列表
媒体元数据
媒体查询列表
媒体查询列表事件
媒体记录器
媒体会话
媒体设置范围
媒体源
媒体流
媒体流事件
媒体流轨道
媒体流轨道事件
内存信息
HTML
消息通道
消息事件
消息端口
元数据
元元素
仪表元素
MIDI访问
MIDI连接事件
MIDI输入
MIDI输入映射
MIDI消息事件
MIDI输出
MIDI输出映射
MIDI端口
媒体类型
媒体类型数组
模元素
月份输入元素
由年和月组成的日期,没有时区。
鼠标事件
突变事件
突变观察器
突变记录
网络信息
节点
节点过滤器
节点迭代器
节点列表
节点树消毒剂
在构建后对节点树进行消毒,以确保它不包含任何不允许的元素或属性。
节点验证器
用于在将HTML字符串解析为DOM节点时验证只允许接受的元素和属性的接口。
节点验证器构建器
帮助构建标准节点验证策略的类。
带标记的元素
非文档类型子节点
非元素父节点
通知
通知事件
数字输入元素
一个数字编辑控件。
对象元素
离屏画布
离屏画布2D渲染上下文
有序列表元素
选项组元素
选项元素
方向传感器
输出元素
过约束错误
页面转换事件
绘图渲染上下文2D
绘图大小
绘图工作线程全局作用域
段落元素
参数元素
父节点
密码凭证
密码输入元素
无换行符的文本(敏感信息)。
Path2D
支付地址
支付工具
支付管理器
支付请求
支付请求事件
支付请求更新事件
支付响应
性能
性能条目
性能长任务计时
性能标记
性能度量
性能导航
性能导航计时
性能观察者
性能观察者条目列表
性能绘制计时
性能资源计时
性能服务器计时
性能计时
权限
权限状态
照片功能
图片元素
平台
插件
插件数组
<T extends num>
用于表示二维位置的实用类。
指针事件
弹出新状态事件
位置错误
前元素
展示
展示可用性
展示连接
展示连接可用事件
展示连接关闭事件
展示连接列表
展示接收者
展示请求
处理指令
进度元素
进度事件
承诺拒绝事件
公钥凭证
推送事件
推送管理器
推送消息数据
推送订阅
推送订阅选项
引号元素
单选按钮输入元素
当与其他 单选按钮输入元素 控件一起使用时,形成一个单选按钮组,其中一次只能选中一个控件的控制。
范围
范围输入元素
类似于 数字输入元素,但浏览器可能提供更优化的样式(如滑动控件)。
范围输入元素基类
涉及范围的所有输入元素类型的基接口。
就绪状态
包含由 HTMLDocument.getReadyState 返回的标准值集合。
矩形<T extends num>
用于表示二维矩形的属性不可变的类。
相关应用程序
相对方向传感器
远程播放
报告体
报告观察者
重置按钮输入元素
一个按钮,点击时会重置表单。
调整大小观察者
调整大小观察者条目
Rtc证书
Rtc数据通道
Rtc数据通道事件
RtcDtmf发送器
RtcDtmf音调更改事件
RtcIce候选人
RtcLegacyStats报告
RtcPeerConnection
RtcPeerConnectionIce事件
RtcRtpContributingSource
RtcRtp接收器
RtcRtp发送器
RtcSessionDescription
RtcStats报告
RtcStats响应
RtcTrack事件
屏幕
屏幕方向
脚本元素
滚动对齐
Element.scrollIntoView的选项。
滚动状态
滚动时间轴
搜索输入元素
类似于 文本输入元素,但在搜索样式不同的平台上,这将获取搜索样式。
安全策略违规事件
选择元素
选择
传感器
传感器错误事件
服务工作者
服务工作者容器
服务工作者全局范围
服务工作者注册
阴影元素
阴影根
共享数组缓冲区
共享工作者
共享工作者全局范围
插槽元素
源缓冲区
源缓冲区列表
源元素
跨度元素
语音语法
语音语法列表
语音识别
语音识别替代
语音识别错误
语音识别事件
语音识别结果
语音合成
语音合成事件
语音合成语句
语音合成声音
静态范围
存储
Window.localStorageWindow.sessionStorage 属性使用的类型。存储以 Map 的形式实现。
StorageEvent
StorageManager
StyleElement
StyleMedia
StylePropertyMap
StylePropertyMapReadonly
StyleSheet
SubmitButtonInputElement
一个按钮,当点击时,提交表单。
SyncEvent
SyncManager
TableCaptionElement
TableCellElement
TableColElement
TableElement
TableRowElement
TableSectionElement
TaskAttributionTiming
TelephoneInputElement
表示用于编辑电话号码的控件。
TemplateElement
Text
TextAreaElement
TextDetector
TextEvent
TextInputElement
一个基本的文本输入编辑控件。
TextInputElementBase
涉及文本编辑的所有输入的基接口。
TextMetrics
TextTrack
TextTrackCue
TextTrackCueList
TextTrackList
TimeElement
TimeInputElement
一个无时区的时(小时、分钟、秒、分数秒)。
TimeRanges
TitleElement
Touch
TouchEvent
TouchList
TrackDefault
TrackDefaultList
TrackElement
TrackEvent
TransitionEvent
TreeWalker
TrustedHtml
TrustedScriptUrl
TrustedUrl
UIEvent
UListElement
UnderlyingSourceBase
UnknownElement
UriPolicy
定义了允许特定属性值的 URI 类型的策略。
Url
UrlInputElement
用于编辑绝对 URL 的控件。
UrlSearchParams
UrlUtilsReadOnly
ValidityState
VideoElement
VideoPlaybackQuality
VideoTrack
VideoTrackList
VisualViewport
VR
VRCoordinateSystem
VRDevice
VRDeviceEvent
VRDisplay
VRDisplayCapabilities
VRDisplayEvent
VREyeParameters
VRFrameData
VRFrameOfReference
VRPose
VRSession
VRSessionEvent
VRStageBounds
VRStageBoundsPoint
VRStageParameters
VttCue
VttRegion
WebSocket
使用 WebSocket 接口连接到 WebSocket,并在该 WebSocket 上发送和接收数据。
WeekInputElement
一个由周年数和周数组成,无时区的日期。
WheelEvent
Window
当前浏览器选项卡或窗口的最顶层容器。
WindowBase
浏览器选项卡或窗口的最顶层容器。
WindowBase64
WindowClient
WindowEventHandlers
Worker
WorkerGlobalScope
WorkerPerformance
WorkletAnimation
WorkletGlobalScope
XmlDocument
XmlSerializer
XPathEvaluator
XPathExpression
XPathNSResolver
XPathResult
XsltProcessor

属性

document HtmlDocument
网页中所有内容的根节点。
无设置器
window Window
网页的最顶层容器,通常是一个浏览器选项卡或窗口。
无设置器

函数

promiseToFuture<T>(Object jsPromise) Future<T>
将 JavaScript Promise 转换为 Dart Future。
promiseToFutureAsMap(dynamic jsPromise) Future<Map<String, dynamic>?>
将 JS Promise 转换为 Future>。
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