HTML::O...ttribute(3)

📦 version 0.6.0, in alpine 3.24

💅 HTML::O...ttribute(3) — HTML Object Element Attribute Class 💅

okay bestie so this page is straight out of User Contributed Perl Documentation, and it's all about the ✨ attribute ✨ layer of HTML::Object. sit down, hydrate, let's go 🍓

🌸 NAME 🌸

HTML::Object::Attribute — the HTML Object Element Attribute Class. that's it, that's the name, she's an icon, periodt 👑

🦋 SYNOPSIS 🦋

like, literally the fastest way in:

use HTML::Object::Attribute;
my $attr = HTML::Object::Attribute->new( 'id' );
$attr->value = "hello";

no cap, that's the whole vibe 🔥

⭐ VERSION ⭐

v0.3.0 — she's serving version v0.3.0 and she knows it 💜

🎀 DESCRIPTION 🎀

okay so this class represents an element attribute — like the id="hello" part of a tag, iykyk. it's used as part of HTML::Object, and it also contains methods to interface with HTML::Object::XPath. so she's dual-purpose and honestly? main character energy 👑

🧚 CONSTRUCTOR 🧚

✨ new ✨

Creates a new HTML::Object::Attribute object. 🫶

It may also take an hash like arguments, that also are method of the same name. so you can pass the name straight up or as a named arg, both slay:

my $attr = HTML::Object::Attribute->new( 'id' );
# or
my $attr = HTML::Object::Attribute->new( name => 'id' );

🌈 PROPERTIES 🌈

💖 nodeValue 💖

This returns or sets the value of the current node.

For document, element or collection, this returns undef 😭 and for attribute, text or comment, this returns the objct value. (yes, "objct" — i'm not fixing the original's makeup, i don't do that 💅)

See for more information <https://developer.mozilla.org/en-US/docs/Web/API/Node/nodeValue>

🔥 METHODS 🔥

💫 element 💫

Returns the HTML::Object::Element object to which this attribute belongs. her home, her origin story 🫶

💫 getAttributes 💫

Returns an array object of the related element's attributes as HTML::Object::Attribute objects. it's giving squad goals ✨

💫 getLocalName 💫

Returns the attribute name. simple. iconic. no notes.

💫 getNextSibling 💫

Returns the next attribute object, or undef. sometimes you get a friend, sometimes you get nothing 😭

💫 getParentNode 💫

Returns the parent HTML::Object::Element object. found family fr fr 💖

💫 getPreviousSibling 💫

Returns the previous attribute object, or undef. the one who came before 👑

💫 getValue 💫

Returns the attribute value.

💫 isAttributeNode 💫

Always returns true. always. she's confident, she knows what she is 💅

💫 is_inside 💫

Provided with an HTML::Object::Element and this will return true if this attribute is inside it, or false otherwise. vibe check: are you in your element? literally 🦋

💫 lineage 💫

Add the parent element to our lineage. See "lineage" in HTML::Object::Element — gotta know your roots, bestie 🌸

💫 localName 💫

Read-only.

A string representing the local part of the qualified name of the attribute.

This is the same as "getName", because this interface does not use xml "prefix".

See for more information <https://developer.mozilla.org/en-US/docs/Web/API/Attr/localName>

💫 name 💫

Set or get the attribute name.

Normally, under JavaScript, this is read-only, but under perl you can change it. Still be careful. ⚠️ like yes you can, but should you? the manpage said be careful and i'm just the messenger 🙈

See for more information <https://developer.mozilla.org/en-US/docs/Web/API/Attr/name>

💫 namespaceURI 💫

Read-only.

A string representing the URI of the namespace of the attribute, or undef if there is no namespace.

This actually always return undef, because this interface does not use xml "prefix". so she's mysterious and unreachable, tragic 💀

See for more information <https://developer.mozilla.org/en-US/docs/Web/API/Attr/namespaceURI>

💫 nodeValue 💫

This returns or sets the value of the current element.

See for more information <https://developer.mozilla.org/en-US/docs/Web/API/Node/nodeValue>

💫 ownerElement 💫

Returns the element object to which this attribute object belongs.

See for more information <https://developer.mozilla.org/en-US/docs/Web/API/Attr/ownerElement>

💫 prefix 💫

Read-only.

This always return undef, because this interface does not use xml "prefix".

Normally, under JavaScript, this would return a string representing the namespace prefix of the attribute, or undef if a namespace without prefix or no namespace are specified.

See for more information <https://developer.mozilla.org/en-US/docs/Web/API/Attr/prefix>

💫 rank 💫

Set or get the attribute rank. This returns a number object. she's got a ranking and she's not sorry 📊

💫 string_value 💫

This is an alias for "value".

💫 to_boolean 💫

Returns the attribute value as a boolean. true or false bestie, binary queen 🎀

💫 to_literal 💫

Returns the attribute value as a litteral. (yes, "litteral" — again, not my typo to fix, i respect the original's choices 💜)

💫 to_number 💫

Returns the attribute value as a number. math era 🔢

💫 toString 💫

Returns a stringification of this attribute such as attribute="value" — so she can introduce herself at parties ✨

💫 value 💫

Set or get the value of this attribute as a scalar object. For example:

$attr->value( "hello" );

See for more information <https://developer.mozilla.org/en-US/docs/Web/API/Attr/value>

🫶 AUTHOR 🫶

Jacques Deguest <jack@deguest.jp> — thank you for your service king 👑

🌟 SEE ALSO 🌟

obsessed with this list, look at all these icons:

  • HTML::Object
  • HTML::Object::Attribute
  • HTML::Object::Boolean
  • HTML::Object::Closing
  • HTML::Object::Collection
  • HTML::Object::Comment
  • HTML::Object::Declaration
  • HTML::Object::Document
  • HTML::Object::Element
  • HTML::Object::Exception
  • HTML::Object::Literal
  • HTML::Object::Number
  • HTML::Object::Root
  • HTML::Object::Space
  • HTML::Object::Text
  • HTML::Object::XQuery

and the reading material 📚:

Copyright (c) 2021 DEGUEST Pte. Ltd.

All rights reserved

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. slay, open source queen 🌈

ok that's the whole page bestie, go forth and attribute responsibly 💅✨

small cute sign-off before you go: this lil beauty is perl v5.42.2, dated 2026-02-15, and filed under HTML::O...ttribute(3) — the truncated name is canon, don't come for her 🎀🦋

📦 where this page comes from