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
- MenuElement
- 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选项。
- 滚动状态
- 滚动时间轴
- 搜索输入元素
- 类似于 文本输入元素,但在平台中对搜索进行不同样式设置的情况下,这将获取搜索样式。
- 安全策略违反事件
- 选择元素
- 选择
- 传感器
- 传感器错误事件
- 服务工作者
- 服务工作者容器
- 服务工作者全局范围
- 服务工作者注册
- 阴影元素
- 阴影根
- 插槽元素
- 源缓冲区
- 源缓冲区列表
- 源元素
- 跨度元素
- 语音语法
- 语音语法列表
- 语音识别
- 语音识别替代方案
- 语音识别错误
- 语音识别事件
- 语音识别结果
- 语音合成
- 语音合成事件
- 语音合成语句
- 语音合成声音
- 静态范围
- 存储
- 该类型由Window.localStorage和Window.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()