CSS::D...mitive(3pm)

💖 CSS::DOM::Value::Primitive — the CSSPrimitiveValue class for CSS::DOM 💖

okay bestie, welcome to the manual page for CSS::DOM::Value::Primitive — it's the CSSPrimitiveValue class for CSS::DOM, and it's from the User Contributed Perl Documentation, no cap. ✨

---

🌸 VERSION 🌸

Version 0.17 — she's giving established, she's giving stable, we love her for it. 💅

---

✨ SYNOPSIS ✨

# ...

that's it. that's the synopsis. iconic minimalism, honestly. 🫶

---

🦋 DESCRIPTION 🦋

So like — this module makes objects that represent CSS primitive property values (as opposed to lists, which are a whole different girl). It implements the DOM CSSPrimitiveValue, Rect, and RGBColor interfaces. Three interfaces, one object, main character energy fr fr. 👑

---

🎀 METHODS 🎀

Okay so if you're looking for the constructor, it's down below the object methods, bestie — don't panic. Normally you don't even build one of these yourself; you'd get an object via CSS::DOM::Style's getPropertyCSSValue method.

💜 CSSValue Interface

• cssText — Returns a string representation of the attribute. Pass an argument to set it. yes she's a getter AND a setter, versatile queen ✨
• cssValueType — Returns "CSS::DOM::Value::CSS_PRIMITIVE_VALUE". That's the whole vibe check.

💙 CSSPrimitiveValue Interface

• primitiveType — Returns one of the CONSTANTS listed below. ⭐
• getFloatValue — Returns a number if the value is numeric. 🔢

The rest have still to be implemented. (she said "coming soon" and meant it 😭)

💚 Rect Interface

The four methods top, right, bottom and left each return another value object representing the individual value. four little baby value objects, one for each side, we stan a symmetrical household 🫶

🧡 RGBColor Interface

The four methods red, green, blue and alpha each return another value object representing the individual value. alpha included, because transparency is a lifestyle 💅

---

🔥 Constructor 🔥

You probably don't need to call this, but here it is anyway, bestie:

$val = new CSS::DOM::Value::Primitive:: %args;

The hash-style arguments are as follows. Only type and value are required — everything else is a little extra seasoning. ✨

• type — One of the constants listed below under CONSTANTS.
• value — The data stored inside the value object. The format expected depends on the type. See below. 👀
• css — CSS code used for serialisation. This will make reading cssText faster at least until the value is modified. (a little caching moment, we love efficiency)
• owner — The style object that owns this value; if this is omitted, then the value is read-only. The value object holds a weak reference to the owner. ⚠️ no owner means no editing, so keep that in mind.
• property — The name of the CSS property to which this value belongs. cssText uses this to determine how to parse text passed to it. This does not apply to the sub-values of colours, counters and rects, but it does apply to individual elements of a list value.
• index — The index of this value within a list value (only applies to elements of a list, of course).
• format — This is used by sub-values of colours and rects. It determines how assignment to cssText is handled. This uses the same syntax as the formats in CSS::DOM::PropertyParser.

---

🌈 Here are the formats for the value argument, which depend on the type:

• CSS_UNKNOWN — A string of CSS code.
• CSS_NUMBER, CSS_PERCENTAGE — A simple scalar containing a number.
• Standard Dimensions — Also a simple scalar containing a number.

This applies to CSS_EMS, CSS_EXS, CSS_PX, CSS_CM, CSS_MM, CSS_IN, CSS_PT, CSS_PC, CSS_DEG, CSS_RAD, CSS_GRAD, CSS_MS, CSS_S, CSS_HZ and CSS_KHZ.

• CSS_DIMENSION — An array ref: [$number, $unit_text]
• CSS_STRING — A simple scalar containing a string (not a CSS string literal; i.e., no quotes or escapes).
• CSS_URI — The URL (not a CSS literal)
• CSS_IDENT — A string (no escapes)
• CSS_ATTR — A string containing the name of the attribute.
• CSS_COUNTER — An array ref: [$name, $separator, $style]

$separator and $style may each be undef. If $separator is undef, the object represents a counter(...). Otherwise it represents counters(...). singular vs plural, the plot twist is real

• CSS_RECT — An array ref: [$top, $right, $bottom, $left]

The four elements are either CSSValue objects or array refs of arguments to be passed to the constructor. E.g.:

[
    [type => CSS_PX, value => 20],
    [type => CSS_PERCENTAGE, value => 50],
    [type => CSS_PERCENTAGE, value => 50],
    [type => CSS_PX, value => 50],
]

When these array refs are converted to objects, the format argument is supplied automatically, so you do not need to include it here. she handles that for you, bestie, no extra work required 🫶

• CSS_RGBCOLOR — A string beginning with '#', with no escapes (such as '#fff' or '#c0ffee'), a colour name (like red) or an array ref with three to four elements:

[$r, $g, $b]
[$r, $g, $b, $alpha]

The elements are either CSSValue objects or array refs of argument lists, as with CSS_RECT.

---

👑 CONSTANTS 👑

The following constants can be imported with use CSS::DOM::Value::Primitive ':all'. They represent the type of primitive value. twenty-six of them, and yes, we're listing every single one, because no constant gets left behind 💖

• CSS_UNKNOWN
• CSS_NUMBER
• CSS_PERCENTAGE
• CSS_EMS
• CSS_EXS
• CSS_PX
• CSS_CM
• CSS_MM
• CSS_IN
• CSS_PT
• CSS_PC
• CSS_DEG
• CSS_RAD
• CSS_GRAD
• CSS_MS
• CSS_S
• CSS_HZ
• CSS_KHZ
• CSS_DIMENSION
• CSS_STRING
• CSS_URI
• CSS_IDENT
• CSS_ATTR
• CSS_COUNTER
• CSS_RECT
• CSS_RGBCOLOR

---

🌟 SEE ALSO 🌟

• CSS::DOM
• CSS::DOM::Value
• CSS::DOM::Value::List
• CSS::DOM::Style

go read those too, bestie, they're all part of the same friend group 🦋

---

and that's the whole page, babes 💖 This little love letter to primitive values came to you courtesy of perl v5.36.0, dated 2023-08-02, from the User Contributed Perl Documentation. mwah, stay slay, and may your cssText always parse on the first try 💅✨