Skip to content

[csslib] Parse CSS hsl() angles and percentages in Color.css - #2829

Merged
kevmoo merged 5 commits into
dart-lang:mainfrom
palmoni5:csslib/functional-colors
Nov 16, 2026
Merged

kevmoo merged 5 commits into
dart-lang:mainfrom
palmoni5:csslib/functional-colors

Conversation

@palmoni5

Copy link
Copy Markdown
Contributor

Color.css mishandled CSS functional colors:

  • In hsl()/hsla(), percentage components threw a FormatException, and the hue (a CSS angle in degrees) was passed straight to Hsla, which expects a 0..1 fraction, so every hue of 1 degree or more came out red.
  • rgb()/rgba() did not accept percentage channels or percentage alpha.
  • A functional color with too few components threw a RangeError, and extra components were silently ignored.

This change parses the hue as a CSS angle (degrees by default, plus deg, grad, rad and turn, case-insensitive) and wraps it into 0..360, accepts percentages for saturation, lightness, RGB channels and alpha, and throws a FormatException for the wrong number of components or non-finite values. Bare saturation, lightness and alpha numbers keep their previous 0..1 meaning; a bare hue is now read as degrees, as CSS specifies.

Tests: test/color_function_test.dart covers primary hues, wrap-around and negative angles, every angle unit, fractional and percentage alpha, RGB percentages and malformed input; they fail without the change.

@palmoni5
palmoni5 requested a review from a team as a code owner November 10, 2026 15:57

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates Color.css in pkgs/csslib to support CSS angle units (deg, grad, rad, turn) for HSL/HSLA hues, accept percentages for RGB/RGBA/HSL/HSLA channels, and throw a FormatException for invalid component counts or non-finite values. It also adds comprehensive unit tests and updates the changelog. The review feedback suggests improving error handling in parseNumber by catching and rethrowing FormatException with the full CSS color string, and simplifying parseRgbChannel to avoid redundant calls to parseFraction.

Comment thread pkgs/csslib/lib/src/property.dart Resolved
Comment thread pkgs/csslib/lib/src/property.dart Resolved
Comment thread pkgs/csslib/CHANGELOG.md Resolved
Comment thread pkgs/csslib/lib/src/property.dart Resolved
Comment thread pkgs/csslib/lib/src/property.dart Resolved
@kevmoo
kevmoo merged commit b0d3be2 into dart-lang:main Nov 16, 2026
3 checks passed
copybara-service Bot pushed a commit to dart-lang/sdk that referenced this pull request Nov 17, 2026
Revisions updated by `dart tools/rev_sdk_deps.dart`.

http (https://github.com/dart-lang/http/compare/e81e6fe..e319115):
  e319115  Mon Nov 16 12:31:18 2026 -0800  Brian Quinlan  chore(http2): release 3.2.0 (dart-lang/http#2043)

shelf (https://github.com/dart-lang/shelf/compare/b175e9f..2856b69):
  2856b69  Mon Nov 16 15:08:37 2026 -0800  Kevin Moore  test(shelf_static): verify sub-second file mtime on If-Modified-Since (dart-lang/shelf#560)

tools (https://github.com/dart-lang/tools/compare/1d77f5d..e97f625):
  e97f62582  Tue Nov 17 01:12:37 2026 +0200  palmoni5  [markdown] Split fenced code info strings at a tab as well as a space (dart-lang/tools#2861)
  8b4bd9035  Tue Nov 17 01:12:08 2026 +0200  palmoni5  [markdown] Scan whitespace directly for blank lines and dedent (dart-lang/tools#2856)
  0ccdf5a2f  Tue Nov 17 01:11:40 2026 +0200  palmoni5  [markdown] Fast-path single-line text in HtmlRenderer and reset state on reuse (dart-lang/tools#2857)
  9ccd1f06f  Tue Nov 17 01:11:10 2026 +0200  palmoni5  [markdown] Keep first-reference order for footnotes with non-ASCII labels (dart-lang/tools#2862)
  1611e7840  Tue Nov 17 01:10:41 2026 +0200  palmoni5  [markdown] Don't double-encode percent escapes in extended autolinks (dart-lang/tools#2863)
  91de4afe0  Tue Nov 17 01:09:24 2026 +0200  palmoni5  [html] Avoid duplicate code-unit buffers and serialization copies (dart-lang/tools#2848)
  6ae9b3661  Tue Nov 17 01:08:47 2026 +0200  palmoni5  [html] Extract DOM text iteratively to avoid stack overflows (dart-lang/tools#2853)
  9ae835ddf  Tue Nov 17 01:08:18 2026 +0200  palmoni5  [html] Keep parent links consistent and move node lists in linear time (dart-lang/tools#2849)
  514a1441a  Tue Nov 17 01:07:48 2026 +0200  palmoni5  [html] Look up elements by ID, tag and class without the CSS parser (dart-lang/tools#2850)
  4d5fd4800  Tue Nov 17 01:07:17 2026 +0200  palmoni5  [html] Fix structural selectors and split class values on ASCII whitespace (dart-lang/tools#2852)
  c4545deae  Tue Nov 17 00:56:28 2026 +0200  palmoni5  [csslib] Index keyword tables by length in TokenKind matchers (dart-lang/tools#2835)
  f04ce9c23  Tue Nov 17 00:56:01 2026 +0200  palmoni5  [csslib] Avoid per-character allocations when tokenizing identifiers (dart-lang/tools#2836)
  bb9fa57b0  Tue Nov 17 00:55:33 2026 +0200  palmoni5  [csslib] Skip comments and whitespace without recursion (dart-lang/tools#2838)
  017d0c369  Tue Nov 17 00:55:04 2026 +0200  palmoni5  [csslib] Keep line height and family list in Font.scale (dart-lang/tools#2845)
  f38c2b28f  Tue Nov 17 00:54:35 2026 +0200  palmoni5  [csslib] Serialize partial Font styles as valid CSS (dart-lang/tools#2847)
  29d0ed107  Tue Nov 17 00:54:06 2026 +0200  palmoni5  [csslib] Hash all Font fields compared by == (dart-lang/tools#2846)
  b0d3be20f  Tue Nov 17 00:53:37 2026 +0200  palmoni5  [csslib] Parse CSS hsl() angles and percentages in Color.css (dart-lang/tools#2829)
  d53e0929a  Tue Nov 17 00:53:09 2026 +0200  palmoni5  [csslib] Fix Rgba/Hsla ARGB conversions and keep exact alpha (dart-lang/tools#2826)
  b81adb5fe  Tue Nov 17 00:52:40 2026 +0200  palmoni5  [csslib] Keep numeric Color alpha and normalize CSS hex colors (dart-lang/tools#2828)
  2a4c12867  Tue Nov 17 00:52:11 2026 +0200  palmoni5  [csslib] Simplify TokenKind.decimalToHex and stop hanging on negatives (dart-lang/tools#2831)
  65f097ca3  Tue Nov 17 00:51:43 2026 +0200  palmoni5  [csslib] Index the named color table for color lookups (dart-lang/tools#2832)
  0ba8cf932  Tue Nov 17 00:51:15 2026 +0200  palmoni5  [csslib] Recognize the rebeccapurple color keyword (dart-lang/tools#2834)
  c745e413e  Tue Nov 17 00:50:47 2026 +0200  palmoni5  [csslib] Parse unit-like type selectors at the start of a rule (dart-lang/tools#2830)
  59f7f0698  Tue Nov 17 00:50:20 2026 +0200  palmoni5  [csslib] Emit valid @namespace directives in the pretty printer (dart-lang/tools#2827)
  a7a5db527  Tue Nov 17 00:49:49 2026 +0200  palmoni5  [csslib] Deep-clone selectors and keep legacy pseudo-elements (dart-lang/tools#2842)
  c66db3c58  Tue Nov 17 00:49:21 2026 +0200  palmoni5  [csslib] Keep group terms and declaration flags when cloning (dart-lang/tools#2843)
  484417860  Tue Nov 17 00:48:54 2026 +0200  palmoni5  [csslib] Fix the @left-bottom page-margin directive (dart-lang/tools#2833)

web is held back at 4e60e61, before dart-lang/web#596, because it changes
`package:web` signatures (e.g. `innerHTML=`, `parseFromString`, `Worker()`)
from `JSAny` to `String` in ways that break SDK and google3 callers (see
reverted roll in fe6e88e).

Change-Id: I42ad0ebf774fac1acdf6a411aea26001d8093d4f
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/578343
Reviewed-by: Kevin Moore <kevmoo@google.com>
Reviewed-by: Samuel Rawlins <srawlins@google.com>
Commit-Queue: Nate Bosch <nbosch@google.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants