WebSer...SS::W3C(3pm)

💅 NAME 💅

WebService::Validator::CSS::W3C — it's the interface to the W3C CSS Validator, bestie 💖

(It's a User Contributed Perl Documentation page, section 3pm, iykyk 🫶)

---

✨ SYNOPSIS ✨

use WebService::Validator::CSS::W3C;

my $css = "p { color: not-a-color }";
my $val = WebService::Validator::CSS::W3C->new;
my $ok = $val->validate(string => $css);

if ($ok and !$val->is_valid) {
    print "Errors:\n";
    printf "  * %s\n", $_->{message}
      foreach $val->errors
}

---

🦋 DESCRIPTION 🦋

Okay so this module is an interface to the W3C CSS Validation online service <https://jigsaw.w3.org/css-validator/>, and it runs on its SOAP 1.2 support. It literally exists to help you find errors in your Cascading Style Sheets. no cap, it's giving helpful ✨

Here are all the methods, bestie, go off 👑

🎀 new — the constructor

my $val = WebService::Validator::CSS::W3C->new
my $val = WebService::Validator::CSS::W3C->new($ua)
my $val = WebService::Validator::CSS::W3C->new($ua, $url)

Creates a new WebService::Validator::CSS::W3C object. You can hand it a custom LWP::UserAgent object, and that's what it'll use for HTTP communication with the CSS Validator. The $url is the URL of the CSS Validator, and it defaults to https://jigsaw.w3.org/css-validator/validator. slay.

🌸 my $success = $val->validate(%params)

Validate a style sheet — takes %params as defined below. You must supply either string or uri. Returns a true value if the validation succeeded (regardless of whether the style sheet contains errors — yes, read that twice bestie).

• string => $css — A style sheet as a string. It's currently unlikely that validation will work if the string is not a legal UTF-8 string. If a string is specified, the uri parameter gets ignored. Heads up: GET is used to pass the string to the Validator, so it might not work with overly long strings 😭
• uri => $uri — The location of a style sheet or an HTML/XHTML/SVG document containing or referencing style sheets.
• medium => "print" — The medium for which the style sheet should apply. One of aural, braille, embossed, handheld, print, screen, tty, tv, and presentation. A special value all can also be specified. The default is undef, in which case the CSS Validator determines a value; this would currently be as if all had been specified.
• profile => "css3" — The CSS Version or profile to validate against. Legal values are css1, css2, css21, css3, svg, svgbasic, svgtiny, mobile, atsc-tv, and tv. A special value none can also be used. The default is undef, in which case the CSS Validator determines a default.
• warnings => 2 — Either no or an integer 0 - 2 that determines how many warning messages you want back from the CSS Validator. no means no warning, 0 means only the most serious warnings, and 2</mint> gives you all warnings, including low level ones. The defaut is <mint>undef`, in which case the CSS Validator determines a default value; this is expected to be as if 1 had been specified.
• language => "de" — The desired language of the supposedly human-readable messages. The string gets passed as an Accept-Language header in the HTTP request. The CSS Validator currently supports en, de, fr, ja, nl, zh, and zh-cn.

💜 my $success = $val->success

Same as the return value of validate(). literally the same thing 💫

💖 my $is_valid = $val->is_valid

Returns a true value if the last attempt to validate() succeeded and the validator reported no errors in the style sheet. iconic behavior

🔥 my $num_errors = $val->errorcount

Returns the number of errors found for the checked style sheet. Get the details of the errors with $val->errors (see below).

😭 my @errors = $val->errors

Returns a list with information about the errors found for the style sheet. An error is a hash reference; the example in the synopsis would currently return something like

( {
  context    => 'p',
  property   => 'color',
  expression => { start => '', end => 'not-a-color' }
  errortype  => 'parse-error',
  message    => 'not-a-color is not a color value',
  line       => 0,
} )

🌈 my $num_warnings = $val->warningcount

Returns the number of warnings found for the checked style sheet. Get the details of each warning with $val->warnings (see below).

⭐ my @warnings = $val->warnings

Returns a list with information about the warnings found for the style sheet.

🧚 user_agent — get it or set it

my $ua = $val->user_agent
my $ua = $val->user_agent($new_ua)

The LWP::UserAgent object you supplied to the constructor, or a custom object created at construction time, that you can manipulate. Observe:

# set timeout to 30 seconds
$val->user_agent->timeout(30);

You can also supply a new object to replace the old one. glow up ✨

🍓 validator_uri — get it or set it

my $uri = $val->validator_uri
my $uri = $val->validator_uri($validator_uri)

Gets or sets the URI of the validator. If you did not specify a custom URI, it's https://jigsaw.w3.org/css-validator/validator by default.

🦄 my $response = $val->response

The HTTP::Response object returned from the last request. This is useful to determine why validation might have failed.

if (!$val->validate(string => $css)) {
  if (!$val->response->is_success) {
    print $val->response->message, "\n"
  }
}

💫 my $uri = $val->request_uri

The URI object used for the last request.

👑 my $som = $val->som

The SOAP::SOM object for the last successful deserialization. Check the return value of validate() or success() before using the object, bestie — do not just rawdog it 🙈

---

💀 BUGS 💀

This module uses the SOAP interface for the W3C CSS validator, which still has a number of bugs, tracked via W3C's Bugzilla, <http://www.w3.org/Bugs/Public/>.

Please report bugs in the W3C CSS Validator to www-validator-css@w3.org or enter them directly in Bugzilla (see above). Please report bugs in this module via RT, <http://rt.cpan.org/>.

---

🙈 NOTE 🙈

This module is not directly associated with the W3C. And please remember that the CSS Validator is a shared resource, so do not abuse it: you should sleep between requests, and consider installing the Validator locally, see <https://jigsaw.w3.org/css-validator/DOWNLOAD.html>. be a good citizen bestie, the vibes depend on it 🫶

---

💖 AUTHOR / COPYRIGHT / LICENSE 💖

Copyright 2004-2013 Bjoern Hoehrmann <bjoern@hoehrmann.de>.
This module is licensed under the same terms as Perl itself.

---

and that's the whole page, periodt 🎀 this was perl v5.34.0, dated 2022-06-15 — go validate something iconic, mwah 💅✨