ladybird/Userland/Libraries/LibWeb/HTML/HTMLHtmlElement.h

/*
 * Copyright (c) 2018-2020, Andreas Kling <kling@serenityos.org>
 *
 * SPDX-License-Identifier: BSD-2-Clause
 */

#pragma once

#include <LibWeb/ARIA/Roles.h>
#include <LibWeb/HTML/HTMLElement.h>

namespace Web::HTML {

class HTMLHtmlElement final : public HTMLElement {
    WEB_PLATFORM_OBJECT(HTMLHtmlElement, HTMLElement);
    JS_DECLARE_ALLOCATOR(HTMLHtmlElement);

public:
    virtual ~HTMLHtmlElement() override;

    bool should_use_body_background_properties() const;

    // https://www.w3.org/TR/html-aria/#el-html
    virtual Optional<ARIA::Role> default_role() const override { return ARIA::Role::document; }

private:
    HTMLHtmlElement(DOM::Document&, DOM::QualifiedName);

    virtual void initialize(JS::Realm&) override;
    virtual bool is_html_html_element() const override { return true; }
};

}

namespace Web::DOM {
template<>
inline bool Node::fast_is<HTML::HTMLHtmlElement>() const { return is_html_html_element(); }
}
Meta: Add license header to source files As suggested by Joshua, this commit adds the 2-clause BSD license as a comment block to the top of every source file. For the first pass, I've just added myself for simplicity. I encourage everyone to add themselves as copyright holders of any file they've added or modified in some significant way. If I've added myself in error somewhere, feel free to replace it with the appropriate copyright holder instead. Going forward, all new source files should include a license header. 2020-01-18 11:38:21 +03:00			`/*`
			`* Copyright (c) 2018-2020, Andreas Kling <kling@serenityos.org>`
			`*`
Everything: Move to SPDX license identifiers in all files. SPDX License Identifiers are a more compact / standardized way of representing file license information. See: https://spdx.dev/resources/use/#identifiers This was done with the `ambr` search and replace tool. ambr --no-parent-ignore --key-from-file --rep-from-file key.txt rep.txt * 2021-04-22 11:24:48 +03:00			`* SPDX-License-Identifier: BSD-2-Clause`
Meta: Add license header to source files As suggested by Joshua, this commit adds the 2-clause BSD license as a comment block to the top of every source file. For the first pass, I've just added myself for simplicity. I encourage everyone to add themselves as copyright holders of any file they've added or modified in some significant way. If I've added myself in error somewhere, feel free to replace it with the appropriate copyright holder instead. Going forward, all new source files should include a license header. 2020-01-18 11:38:21 +03:00			`*/`

LibHTML: Add a way to get a Document's title You can now query Document::title() to get a String containing whatever is inside the document's <title> tag. In support of this, this patch adds the <html>, <head> and <title> elements. 2019-09-29 17:24:57 +03:00			`#pragma once`

LibWeb: Move ARIA-related code into the Web::ARIA namespace ARIA has its own spec and is not part of the DOM spec, which is what the Web::DOM namespace is for (https://www.w3.org/TR/wai-aria-1.2/). This allows us to stay closer to the spec with function names and don't have to add the word "ARIA" to identifiers constantly - the namespace now provides that clarity. 2023-01-29 01:23:16 +03:00			`#include <LibWeb/ARIA/Roles.h>`
LibWeb: Move HTML object model stuff into LibWeb/HTML/ Take a hint from SVG and more all the HTML classes into HTML instead of mixing them with the DOM classes. 2020-07-26 16:08:16 +03:00			`#include <LibWeb/HTML/HTMLElement.h>`
LibHTML: Add a way to get a Document's title You can now query Document::title() to get a String containing whatever is inside the document's <title> tag. In support of this, this patch adds the <html>, <head> and <title> elements. 2019-09-29 17:24:57 +03:00
LibWeb: Move HTML classes into the Web::HTML namespace 2020-07-28 19:20:36 +03:00			`namespace Web::HTML {`
LibWeb: Move everything into the Web namespace 2020-03-07 12:27:02 +03:00
LibWeb: Make all existing HTML elements "final" 2020-07-28 04:54:19 +03:00			`class HTMLHtmlElement final : public HTMLElement {`
LibWeb+LibJS: Make the EventTarget hierarchy (incl. DOM) GC-allocated This is a monster patch that turns all EventTargets into GC-allocated PlatformObjects. Their C++ wrapper classes are removed, and the LibJS garbage collector is now responsible for their lifetimes. There's a fair amount of hacks and band-aids in this patch, and we'll have a lot of cleanup to do after this. 2022-08-28 14:42:07 +03:00			`WEB_PLATFORM_OBJECT(HTMLHtmlElement, HTMLElement);`
LibWeb: Put most LibWeb GC objects in type-specific heap blocks With this change, we now have ~1200 CellAllocators across both LibJS and LibWeb in a normal WebContent instance. This gives us a minimum heap size of 4.7 MiB in the scenario where we only have one cell allocated per type. Of course, in practice there will be many more of each type, so the effective overhead is quite a bit smaller than that in practice. I left a few types unconverted to this mechanism because I got tired of doing this. :^) 2023-11-19 21:47:52 +03:00			`JS_DECLARE_ALLOCATOR(HTMLHtmlElement);`
LibWeb: Add a whole bunch of HTML DOM bindings Note that these aren't full implementations of the bindings. This mostly implements the low hanging fruit (namely, basic reflections) There are some attributes that should be USVString instead of DOMString. However, USVString is a slightly different definition of DOMString, so it should suffice for now. 2020-07-27 07:04:26 +03:00
LibWeb+LibJS: Make the EventTarget hierarchy (incl. DOM) GC-allocated This is a monster patch that turns all EventTargets into GC-allocated PlatformObjects. Their C++ wrapper classes are removed, and the LibJS garbage collector is now responsible for their lifetimes. There's a fair amount of hacks and band-aids in this patch, and we'll have a lot of cleanup to do after this. 2022-08-28 14:42:07 +03:00			`public:`
LibHTML: Add a way to get a Document's title You can now query Document::title() to get a String containing whatever is inside the document's <title> tag. In support of this, this patch adds the <html>, <head> and <title> elements. 2019-09-29 17:24:57 +03:00			`virtual ~HTMLHtmlElement() override;`
LibWeb: Propagate body background properties to root HTML element The Acid1 test has a bit of an unusual background - the html and body tags have different background colors. Our painting order of the DOM was such that the body background was painted first, then all other elements were painted in-phase according to Appendix E of CSS 2.1. So the html element's background color was painted over the body background. This removes the special handling of the body background from InitialContainingBlockBox and now all boxes are painted in-phase. Doing this also exposed that we weren't handling Section 2.11.2 of the spec; when the html background is unset, the body's background should be propagated to the html element. 2021-05-13 16:39:30 +03:00
			`bool should_use_body_background_properties() const;`
LibWeb: Add fast_is<T>() for HTML::HTMLHtmlElement Another one spotted in a scroll-up-and-down profile. 2021-10-27 18:58:57 +03:00
LibWeb: Add Support for the ARIA Element Properties Element now supports getting and setting ARIA properties from JS and HTML. 2022-11-29 02:58:13 +03:00			`// https://www.w3.org/TR/html-aria/#el-html`
LibWeb: Move ARIA-related code into the Web::ARIA namespace ARIA has its own spec and is not part of the DOM spec, which is what the Web::DOM namespace is for (https://www.w3.org/TR/wai-aria-1.2/). This allows us to stay closer to the spec with function names and don't have to add the word "ARIA" to identifiers constantly - the namespace now provides that clarity. 2023-01-29 01:23:16 +03:00			`virtual Optional<ARIA::Role> default_role() const override { return ARIA::Role::document; }`
LibWeb: Add Support for the ARIA Element Properties Element now supports getting and setting ARIA properties from JS and HTML. 2022-11-29 02:58:13 +03:00
LibWeb: Add fast_is<T>() for HTML::HTMLHtmlElement Another one spotted in a scroll-up-and-down profile. 2021-10-27 18:58:57 +03:00			`private:`
LibWeb+LibJS: Make the EventTarget hierarchy (incl. DOM) GC-allocated This is a monster patch that turns all EventTargets into GC-allocated PlatformObjects. Their C++ wrapper classes are removed, and the LibJS garbage collector is now responsible for their lifetimes. There's a fair amount of hacks and band-aids in this patch, and we'll have a lot of cleanup to do after this. 2022-08-28 14:42:07 +03:00			`HTMLHtmlElement(DOM::Document&, DOM::QualifiedName);`

LibJS: Make Cell::initialize() return void Stop worrying about tiny OOMs. Work towards #20405 2023-08-07 09:41:28 +03:00			`virtual void initialize(JS::Realm&) override;`
LibWeb: Add fast_is<T>() for HTML::HTMLHtmlElement Another one spotted in a scroll-up-and-down profile. 2021-10-27 18:58:57 +03:00			`virtual bool is_html_html_element() const override { return true; }`
LibHTML: Add a way to get a Document's title You can now query Document::title() to get a String containing whatever is inside the document's <title> tag. In support of this, this patch adds the <html>, <head> and <title> elements. 2019-09-29 17:24:57 +03:00			`};`
LibHTML: Add is<ElementType> and to<ElementType> helper functions These will help us write node-type-aware template functions. 2019-10-06 21:37:39 +03:00
			`}`
LibWeb: Add fast_is<T>() for HTML::HTMLHtmlElement Another one spotted in a scroll-up-and-down profile. 2021-10-27 18:58:57 +03:00
			`namespace Web::DOM {`
			`template<>`
			`inline bool Node::fast_is<HTML::HTMLHtmlElement>() const { return is_html_html_element(); }`
			`}`