HTML::O...t::Body(3)

📦 version 0.6.0, in alpine 3.24

💖 HTML::Object::DOM::Element::Body — bestie edition 💖

okay so this page is all about HTML::Object::DOM::Element::Body, the HTML Object DOM Body Class 🫶 (yes, it's Perl, yes it's a DOM, yes we're doing this).

✨ SYNOPSIS ✨

use HTML::Object::DOM::Element::Body;
my $body = HTML::Object::DOM::Element::Body->new ||
    die( HTML::Object::DOM::Element::Body->error, "\n" );

like, that's literally it. new it or die trying, no cap 💅

🌸 VERSION 🌸

v0.2.0

🦋 INHERITANCE 🦋

so the whole family tree goes like this, and honestly the way that chain ate:

+-----------------------+     +---------------------------+     +-------------------------+     +----------------------------+     +----------------------------------+
| HTML::Object::Element | --> | HTML::Object::EventTarget | --> | HTML::Object::DOM::Node | --> | HTML::Object::DOM::Element | --> | HTML::Object::DOM::Element::Body |
+-----------------------+     +---------------------------+     +-------------------------+     +----------------------------+     +----------------------------------+

✨ DESCRIPTION ✨

The HTML::Object::DOM::Element::Body interface is here to serve 🎀 — it gives you special properties (like, on top of the ones it already inherits from the regular HTML::Object::DOM::Element interface) for manipulating <body> elements. that's the whole vibe. body stuff. iconic.

👑 PROPERTIES 👑

Inherits properties from its parent HTML::Object::DOM::Element. periodt.

💀 OBSOLETE PROPERTIES 💀

ngl bestie, these are deprecated — and all of them literally just return undef 💀

aLink — a string representing the color of active hyperlinks. iykyk.
background — a string representing the description of the location of the background image resource. ⚠️ heads up: this is not an URI, though some older version of some browsers do expect it. (yes, fr fr, that's the actual caveat.)
bgColor — a string representing the background color for the document.
link — a string representing the color of unvisited links.
text — a string representing the foreground color of text.
vLink — a string representing the color of visited links.

and each one has its own Mozilla documentation link, because of course:

aLink → <https://developer.mozilla.org/en-US/docs/Web/API/HTMLBodyElement/aLink>
background → <https://developer.mozilla.org/en-US/docs/Web/API/HTMLBodyElement/background>
bgColor → <https://developer.mozilla.org/en-US/docs/Web/API/HTMLBodyElement/bgColor>
link → <https://developer.mozilla.org/en-US/docs/Web/API/HTMLBodyElement/link>
text → <https://developer.mozilla.org/en-US/docs/Web/API/HTMLBodyElement/text>
vLink → <https://developer.mozilla.org/en-US/docs/Web/API/HTMLBodyElement/vLink>

🌈 METHODS 🌈

Inherits methods from its parent HTML::Object::DOM::Element. that's the tea 🍓

🔥 EVENT HANDLERS 🔥

Below are the event handlers you can use that are implemented in this interface. BUT — and this is the important part, bestie — it is up to you to fire those related events. the library is not gonna do it for you, no cap 🙈

💜 `onafterprint`

Is an event handler representing the code to be called when the afterprint event is raised.

💜 `onbeforeprint`

Is an event handler representing the code to be called when the beforeprint event is raised.

💜 `onbeforeunload`

Is an event handler representing the code to be called when the beforeunload event is raised.

Example, slay:

use HTML::Object::DOM qw( window );
window->addEventListener( beforeunload => sub
{
    # Cancel the event
    # If you prevent default behavior in Mozilla Firefox prompt will always be shown
    $e->preventDefault();
    # Chrome requires returnValue to be set
    $e->returnValue = '';
});

💜 `onhashchange`

Is an event handler representing the code to be called when the hashchange event is raised.

💜 `onlanguagechange`

Is an event handler representing the code to be called when the languagechange event is raised.

Example:

object->onlanguagechange = function;

window->onlanguagechange = sub
{
    say( 'languagechange event detected!' );
};

💜 `onmessage`

Is an event handler called whenever an object receives a message event.

💜 `onmessageerror`

Is an event handler called whenever an object receives a messageerror event.

💜 `onoffline`

Is an event handler representing the code to be called when the offline event is raised.

See also Mozilla documentation <https://developer.mozilla.org/en-US/docs/Web/API/HTMLBodyElement/onoffline>

💜 `ononline`

Is an event handler representing the code to be called when the online event is raised.

See also Mozilla documentation <https://developer.mozilla.org/en-US/docs/Web/API/HTMLBodyElement/ononline>

💜 `onpagehide`

Is an event handler representing the code to be called when the pagehide event is raised.

See also Mozilla documentation <https://developer.mozilla.org/en-US/docs/Web/API/HTMLBodyElement/onpagehide>

💜 `onpageshow`

Is an event handler representing the code to be called when the pageshow event is raised.

See also Mozilla documentation <https://developer.mozilla.org/en-US/docs/Web/API/HTMLBodyElement/onpageshow>

💜 `onpopstate`

Is an event handler representing the code to be called when the popstate event is raised.

Example — this one's a whole mini saga, bestie:

window->onpopstate = sub
{
    my $event = shift( @_ );
    say( "location: " . $doc->location . ", state: " . JSON->new->encode( $event->state ) );
};

$history->pushState({page => 1}, "title 1", "?page=1");
$history->pushState({page => 2}, "title 2", "?page=2");
$history->replaceState({page => 3}, "title 3", "?page=3");
$history->back(); # alerts "location: https://example.org/example.html?page=1, state => {"page" => 1}"
$history->back(); # alerts "location: https://example.org/example.html, state: null
$history->go(2);    # alerts "location: https://example.org/example.html?page=3, state => {"page" =>3}

💜 `onrejectionhandled`

An event handler representing the code executed when the rejectionhandled event is raised, indicating that a Promise was rejected and the rejection has been handled. 😌 closure, we love to see it.

💜 `onresize`

Is an event handler representing the code to be called when the resize event is raised.

💜 `onstorage`

Is an event handler representing the code to be called when the storage event is raised.

💜 `onunhandledrejection`

An event handler representing the code executed when the unhandledrejection event is raised, indicating that a Promise was rejected but the rejection was not handled. 😭 the drama of it all.

💜 `onunload`

Is an event handler representing the code to be called when the unload event is raised.

🎀 AUTHOR 🎀

Jacques Deguest <jack@deguest.jp> — king behavior, honestly 👑

🧚 SEE ALSO 🧚

Mozilla documentation <https://developer.mozilla.org/en-US/docs/Web/API/HTMLBodyElement>
Mozilla documentation on anchor element <https://developer.mozilla.org/en-US/docs/Web/HTML/Element/body>

⭐ COPYRIGHT & LICENSE ⭐

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

and that's the page, bestie 💖 this doc shipped as perl v5.42.2, dated 2026-02-15, and yes we're crediting the perl manpage family for the whole HTML::O...t::Body(3) glow-up. go forth and manipulate those <body> elements 🦋🌸💅

📦 where this page comes from

alpine 3.24: perl-html-object-doc 0.6.0-r1 · GPL-1.0-or-later OR Artistic-1.0-Perl
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms

HTML::O...t::Body(3)

💖 HTML::Object::DOM::Element::Body — bestie edition 💖

✨ SYNOPSIS ✨

🌸 VERSION 🌸

🦋 INHERITANCE 🦋

✨ DESCRIPTION ✨

👑 PROPERTIES 👑

💀 OBSOLETE PROPERTIES 💀

🌈 METHODS 🌈

🔥 EVENT HANDLERS 🔥

💜 onafterprint

💜 onbeforeprint

💜 onbeforeunload

💜 onhashchange

💜 onlanguagechange

💜 onmessage

💜 onmessageerror

💜 onoffline

💜 ononline

💜 onpagehide

💜 onpageshow

💜 onpopstate

💜 onrejectionhandled

💜 onresize

💜 onstorage

💜 onunhandledrejection

💜 onunload