servo/components/script_bindings/webidls/HTMLElement.webidl
Martin Robinson 2c7866eb24
script/layout: Implement HTMLElement.scrollParent (#39110)
This new API allows getting the element which establishes an element's
scroll container. This will be used to properly implement
`scrollIntoView`. There is still work to do for this API and
`offsetParent` to properly handle ancestors which are
closed-shadow-hidden from the original query element.

In addition, fix an issue where inline boxes were establishing scrolling
containers (they shouldn't do that).

Testing: There are tests for this change.
Fixes: #39096.

Signed-off-by: Martin Robinson <mrobinson@igalia.com>
Co-authored-by: Oriol Brufau <obrufau@igalia.com>
2025-09-03 18:52:15 +00:00

78 lines
2.6 KiB
Text

/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at https://mozilla.org/MPL/2.0/. */
// https://html.spec.whatwg.org/multipage/#htmlelement
[Exposed=Window]
interface HTMLElement : Element {
[HTMLConstructor] constructor();
// metadata attributes
[CEReactions]
attribute DOMString title;
[CEReactions]
attribute DOMString lang;
[CEReactions]
attribute boolean translate;
[CEReactions]
attribute DOMString dir;
readonly attribute DOMStringMap dataset;
// microdata
// attribute boolean itemScope;
// attribute DOMString itemId;
//readonly attribute HTMLPropertiesCollection properties;
// attribute any itemValue; // acts as DOMString on setting
[Pref="dom_microdata_testing_enabled"]
sequence<DOMString>? propertyNames();
[Pref="dom_microdata_testing_enabled"]
sequence<DOMString>? itemtypes();
// user interaction
[CEReactions]
attribute boolean hidden;
undefined click();
// [CEReactions]
// attribute long tabIndex;
undefined blur();
// [CEReactions]
// attribute DOMString accessKey;
//readonly attribute DOMString accessKeyLabel;
// [CEReactions]
// attribute boolean draggable;
// [SameObject, PutForwards=value] readonly attribute DOMTokenList dropzone;
// attribute HTMLMenuElement? contextMenu;
// [CEReactions]
// attribute boolean spellcheck;
// void forceSpellCheck();
[CEReactions] attribute [LegacyNullToEmptyString] DOMString innerText;
[CEReactions, Throws] attribute [LegacyNullToEmptyString] DOMString outerText;
[Throws] ElementInternals attachInternals();
// command API
// readonly attribute DOMString? commandType;
// readonly attribute DOMString? commandLabel;
// readonly attribute DOMString? commandIcon;
// readonly attribute boolean? commandHidden;
// readonly attribute boolean? commandDisabled;
// readonly attribute boolean? commandChecked;
};
// http://dev.w3.org/csswg/cssom-view/#extensions-to-the-htmlelement-interface
partial interface HTMLElement {
// CSSOM things are not [Pure] because they can flush
readonly attribute Element? scrollParent;
readonly attribute Element? offsetParent;
readonly attribute long offsetTop;
readonly attribute long offsetLeft;
readonly attribute long offsetWidth;
readonly attribute long offsetHeight;
};
HTMLElement includes GlobalEventHandlers;
HTMLElement includes ElementContentEditable;
HTMLElement includes ElementCSSInlineStyle;
HTMLElement includes HTMLOrSVGElement;