CSS::DOM::Rule(3pm)

📦
version 0.17 · 5 versions
, in debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 CSS::DOM::Rule — the vibe 💖

okay bestie, so you wanna know about CSS::DOM::Rule? it's the CSS rule class for CSS::DOM, and it's part of the User Contributed Perl Documentation collection. yes, we're doing perldoc today, and honestly? we ate. 💅

Version: 0.17 ✨

🎀 SYNOPSIS 🎀

like, here's the whole vibe in code, no notes:

use CSS::DOM::Rule ':all'; # import constants

use CSS::DOM;
$sheet = new CSS::DOM;
$sheet->insertRule('bla blah blah {}');
$rule = $sheet->cssRules->[0];

$rule->type; # STYLE_RULE
$rule->cssText; # 'bla blah blah {}' or similar
$rule->cssText('p { margin: 0 }'); # replace it
$rule->parentStyleSheet; # $sheet

see how it all just… flows? that's the energy we're bringing. 🦋

🌸 DESCRIPTION 🌸

so this module is the one that hands you the CSS rule class for CSS::DOM. it implements the CSSRule and CSSUnknownRule DOM interfaces. that's it, that's the whole job, and it does it flawlessly. 👑

✨ METHODS ✨

🧚 Constructor

okay so here's the thing — only call the constructor on this class if you want to make an 'unknown' rule. if you want literally any other type of rule, you gotta call the constructor on the specific subclass instead. and ngl, most of the time you don't even need to call it directly anyway (peep CSS::DOM's "parse" and "insertRule" methods, they handle it). but just in case you're feeling brave, here it is:

new CSS::DOM::Rule $parent; # unknown rule

require CSS::DOM::Rule::Style
new CSS::DOM::Rule::Style $parent;
# etc.

and <lavender>$parent</lavender>? that's the parent rule if your rule is nested, or the parent style sheet if it's not. either way, it's the thing that owns it. 🫶

💜 Object Methods

  • type — hands you one of the constants listed down below that says what kind of rule this is. simple. iconic.
  • cssText — gives you this rule's CSS code back. but wait, there's more: if you pass it an argument, that argument gets parsed as the new CSS code for this rule (so it replaces all the existing data), and then you get the old value returned to you. cute, right? 🎀
⚠️ but fr fr — this method will die if the replacement CSS code you gave it creates a different type of rule. so don't try it. or do, but know the consequences. 😭
  • parentStyleSheet — returns the style sheet that this rule belongs to. that's the whole thing. 💖
  • parentRule — returns the rule's parent rule if there is one, otherwise it returns an empty list. and heads up: there's only a parent rule if this one is nested, like, say, inside a media rule. iykyk. 🌈

🍓 EXPORTS 🍓

these constants — which tell you the type of the rule — get exported on request (you can ask for them one at a time, or just grab them all with the ':all' tag):

UNKNOWN_RULE
STYLE_RULE
CHARSET_RULE
IMPORT_RULE
MEDIA_RULE
FONT_FACE_RULE
PAGE_RULE

all seven of them, all accounted for, no skips. periodt. 💅

👑 SEE ALSO 👑

go read these too, bestie, they're all part of the family:

  • CSS::DOM
  • CSS::DOM::Rule::Style
  • CSS::DOM::Rule::Media
  • CSS::DOM::Rule::Page
  • CSS::DOM::Rule::Import

and that's the whole page!! this one came to you from perl v5.36.0, dated 2023-08-02, and it's filed under CSS::DOM::Rule(3pm). ty for coming to my ted talk, now go write some CSS from Perl like the main character you are 💖✨🦋

📦 where this page comes from