AngleSharp.Css 1.5.0-beta.447

logo

AngleSharp.Css

CI GitHub Tag NuGet Count Issues Open CLA Assistant

AngleSharp.Css extends the core AngleSharp library with some more powerful CSS capabilities. This repository is the home of the source for the AngleSharp.Css NuGet package.

Basic Configuration

If you just want a configuration that works (as close as possible to real browsers) you should use the following code:

var config = Configuration.Default
    .WithCss(); // from AngleSharp.Css

This will register a parser for CSS related content. The CSS parsing options and more could be set with parameters of the WithCss method. Alternatively, all the (desired) parts may be registered individually as well. That mostly boils down to three elementary parts:

  • A CSS parser (implementing the ICssParser interface, e.g., CssParser)
  • A factory for creating CSS declarations (IDeclarationFactory)
  • The styling service that can handle CSS documents, see CssStylingService

For an interactive DOM (i.e., to handle style attribute changes in the HTML document) an observer needs to be registered as well.

Furthermore, for some CSSOM features (e.g., media queries) a render device is required.

var config = Configuration.Default
    .WithCss()
    .WithRenderDevice(new DefaultRenderDevice
    {
        DeviceHeight = 768,
        DeviceWidth = 1024,
    });

If no specific IRenderDevice (e.g., via creating an DefaultRenderDevice object) instance is created a default implementation will be set.

The render device also carries the user preferences of the Media Queries Level 5 (and Level 4) user-preference features. DefaultRenderDevice implements IRenderDevicePreferences for that, and any custom IRenderDevice can implement it as well. The dictionary is keyed by the media feature name and holds the keyword that the feature should answer with:

var config = Configuration.Default
    .WithCss()
    .WithRenderDevice(new DefaultRenderDevice
    {
        Preferences = new Dictionary<String, String>
        {
            { "prefers-color-scheme", "dark" },
            { "prefers-reduced-motion", "reduce" },
        },
    });

With this device @media (prefers-color-scheme: dark) applies in the cascade and window.MatchMedia("(prefers-color-scheme: dark)").IsMatched is true. A key that is not set leaves its media feature unknown, i.e., a query using it never matches. The keys a browser would set are:

Key Keywords
prefers-color-scheme light, dark
prefers-reduced-motion no-preference, reduce
prefers-reduced-transparency no-preference, reduce
prefers-contrast no-preference, more, less, custom
prefers-reduced-data no-preference, reduce
forced-colors none, active
hover, any-hover none, hover
pointer, any-pointer none, coarse, fine
display-mode fullscreen, standalone, minimal-ui, browser

The value is compared to the queried keyword case insensitively, so a keyword that is newer than this library works as well. Used without a value, e.g., @media (prefers-reduced-motion), the feature evaluates in a boolean context, where no-preference (and none for forced-colors, hover, any-hover, pointer and any-pointer) is false. Without a preference hover and pointer keep answering as they did before, i.e., as a device with no input mechanism.

Going a bit further it is possible to Render the current document. This render tree information can then be used to retrieve or other information, e.g.,

var tree = document.DefaultView.Render();
var node = tree.Find(document.QuerySelector("div"));
await node.DownloadResources();

The previous snippet renders the current document. Afterwards it retrieves a particular render tree node, which is related to the first found div. Then all (CSS introduced) resources are downloaded for the node, if visible.

Advantages of AngleSharp.Css

The core library already contains the CSS selector parser and the most basic classes and interfaces for dealing with the CSSOM. AngleSharp.Css brings the following advantages and use cases to life:

  • Correct identification of edge cases
  • A live CSSOM model, i.e., callbacks and everything
  • Computing the styling of certain elements
  • Cascades of stylesheets
  • Validation (and property-based exposure) of CSS declarations
  • Responsive design considerations
  • Full access to the value with different converters

The main idea behind AngleSharp.Css is to expose the CSSOM as it would be in the browser (and potentially beyond, i.e., useful for being used by editors). Originally, most of the code found here was embedded in the AngleSharp.Core library, however, due to the overhead for HTML use cases it was decided to transfer the code into its own repository.

Features

  • Feature validators (e.g., for @supports)
  • Document functions (e.g., for domain)
  • Pseudo elements (e.g., ::before)
  • Declarations (e.g., display) incl. knowledge of their values
  • Dynamic DOM coupling (i.e., to react to style attribute changes)
  • CSS custom properties (also known as CSS variables) with extensibility
  • Media queries and all other commonly implemented rules
  • Calculated values (i.e., calc(20px + 50%))
  • Window-based declaration calculations, see window.GetComputedStyle

Benchmarks

The AngleSharp.Performance.Css project uses BenchmarkDotNet to compare CSS parsing performance across libraries. Run the benchmarks in Release mode:

dotnet run --project src/AngleSharp.Performance.Css/AngleSharp.Performance.Css.csproj -c Release --framework net10.0

To run a quick smoke test instead of a full benchmark:

dotnet run --project src/AngleSharp.Performance.Css/AngleSharp.Performance.Css.csproj -c Release --framework net10.0 -- --job short

Participating

Participation in the project is highly welcome. For this project the same rules as for the AngleSharp core project may be applied.

If you have any question, concern, or spot an issue then please report it before opening a pull request. An initial discussion is appreciated regardless of the nature of the problem.

Live discussions can take place in our Gitter chat, which supports using GitHub accounts.

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community.

For more information see the .NET Foundation Code of Conduct.

.NET Foundation

This project is supported by the .NET Foundation.

License

AngleSharp.Css is released using the MIT license. For more information see the license file.

Showing the top 20 packages that depend on AngleSharp.Css.

Packages Downloads
HtmlSanitizer
Cleans HTML from constructs that can be used for cross-site scripting (XSS)
55
HtmlSanitizer
Cleans HTML from constructs that can be used for cross-site scripting (XSS)
53
HtmlSanitizer
Cleans HTML from constructs that can be used for cross-site scripting (XSS)
50
HtmlSanitizer
Cleans HTML from constructs that can be used for cross-site scripting (XSS)
48
HtmlSanitizer
Cleans HTML from constructs that can be used for cross-site scripting (XSS)
47
HtmlSanitizer
Cleans HTML from constructs that can be used for cross-site scripting (XSS)
46
HtmlSanitizer
Cleans HTML from constructs that can be used for cross site scripting (XSS)
46
HtmlSanitizer
Cleans HTML from constructs that can be used for cross-site scripting (XSS)
44
HtmlSanitizer
Cleans HTML from constructs that can be used for cross site scripting (XSS)
41
HtmlSanitizer
Cleans HTML from constructs that can be used for cross-site scripting (XSS)
41
HtmlSanitizer
Cleans HTML from constructs that can be used for cross-site scripting (XSS)
40
HtmlSanitizer
Cleans HTML from constructs that can be used for cross site scripting (XSS)
40
HtmlSanitizer
Cleans HTML from constructs that can be used for cross-site scripting (XSS)
39
HtmlSanitizer
Cleans HTML from constructs that can be used for cross-site scripting (XSS)
38

.NET 10.0

.NET Framework 4.6.2

.NET Framework 4.7.2

.NET 8.0

.NET Standard 2.0

Version Downloads Last updated
1.5.0-beta.452 1 11/17/2026
1.5.0-beta.447 2 11/17/2026
1.4.2 5 11/14/2026
1.4.2-beta.438 5 11/13/2026
1.4.2-beta.436 5 11/13/2026
1.4.2-beta.434 5 11/13/2026
1.4.2-beta.432 4 11/13/2026
1.4.2-beta.431 11 11/13/2026
1.4.1 9 11/09/2026
1.4.1-beta.430 6 11/12/2026
1.4.1-beta.426 11 11/08/2026
1.4.1-beta.425 7 11/08/2026
1.4.1-beta.424 18 11/07/2026
1.4.0 10 11/06/2026
1.4.0-beta.420 15 11/06/2026
1.4.0-beta.418 11 11/06/2026
1.4.0-beta.416 12 11/05/2026
1.4.0-beta.414 14 11/05/2026
1.4.0-beta.413 20 11/05/2026
1.4.0-beta.408 13 11/04/2026
1.4.0-beta.404 17 11/04/2026
1.4.0-beta.403 16 11/04/2026
1.4.0-beta.402 17 11/04/2026
1.3.2 17 11/03/2026
1.3.2-beta.397 16 11/03/2026
1.3.2-beta.394 15 11/02/2026
1.3.2-beta.390 20 11/02/2026
1.3.2-beta.387 18 11/02/2026
1.3.1 18 11/02/2026
1.3.1-beta.386 18 11/02/2026
1.3.1-beta.381 17 11/02/2026
1.3.1-beta.375 16 10/31/2026
1.3.0 18 10/31/2026
1.3.0-beta.371 17 10/31/2026
1.3.0-beta.369 22 10/28/2026
1.3.0-beta.367 21 10/28/2026
1.3.0-beta.365 21 10/25/2026
1.3.0-beta.364 19 10/25/2026
1.3.0-beta.363 18 10/25/2026
1.2.2 15 10/25/2026
1.2.2-beta.359 18 10/25/2026
1.2.1 20 10/24/2026
1.2.1-beta.353 18 10/23/2026
1.2.0 24 10/21/2026
1.2.0-beta.349 18 10/21/2026
1.2.0-beta.347 19 10/20/2026
1.2.0-beta.345 23 10/20/2026
1.1.4 26 10/20/2026
1.1.4-beta.341 20 10/20/2026
1.1.4-beta.340 18 10/19/2026
1.1.3 24 10/15/2026
1.1.3-beta.335 19 10/15/2026
1.1.3-beta.334 22 10/15/2026
1.1.3-beta.330 28 09/13/2026
1.1.2 26 09/11/2026
1.1.2-beta.323 37 09/11/2026
1.1.2-beta.322 22 09/11/2026
1.1.2-beta.321 29 09/11/2026
1.1.1 26 09/10/2026
1.1.1-beta.317 30 09/10/2026
1.1.1-beta.316 27 09/10/2026
1.1.1-beta.311 26 09/10/2026
1.1.1-beta.310 26 09/09/2026
1.1.1-beta.309 25 09/09/2026
1.1.1-beta.308 29 09/07/2026
1.1.1-beta.307 26 09/07/2026
1.1.0 26 09/06/2026
1.1.0-beta.302 23 09/06/2026
1.1.0-beta.297 23 09/06/2026
1.1.0-beta.295 28 09/05/2026
1.1.0-beta.293 30 09/05/2026
1.1.0-beta.291 29 09/06/2026
1.1.0-beta.283 31 09/04/2026
1.1.0-beta.281 29 09/04/2026
1.1.0-beta.277 29 09/04/2026
1.1.0-beta.276 31 09/04/2026
1.1.0-beta.273 28 09/03/2026
1.0.2 32 08/23/2026
1.0.2-beta.272 32 09/02/2026
1.0.2-beta.271 29 09/02/2026
1.0.2-beta.265 28 08/20/2026
1.0.1 27 07/31/2026
1.0.1-beta.264 30 08/20/2026
1.0.1-beta.262 33 08/13/2026
1.0.1-beta.260 26 08/08/2026
1.0.1-beta.258 23 08/05/2026
1.0.1-beta.256 22 08/01/2026
1.0.1-beta.252 23 07/31/2026
1.0.1-beta.250 24 07/31/2026
1.0.1-beta.247 28 07/31/2026
1.0.1-beta.245 29 07/31/2026
1.0.0 30 07/27/2026
1.0.0-beta.244 24 07/29/2026
1.0.0-beta.243 28 07/28/2026
1.0.0-beta.239 21 07/25/2026
1.0.0-beta.237 28 07/25/2026
1.0.0-beta.231 32 07/25/2026
1.0.0-beta.228 28 07/22/2026
1.0.0-beta.226 27 07/22/2026
1.0.0-beta.224 30 07/20/2026
1.0.0-beta.222 30 07/20/2026
1.0.0-beta.216 57 05/14/2026
1.0.0-beta.213 50 04/01/2026
1.0.0-beta.211 56 03/29/2026
1.0.0-beta.209 52 03/29/2026
1.0.0-beta.204 52 03/29/2026
1.0.0-beta.202 52 03/29/2026
1.0.0-beta.199 54 03/29/2026
1.0.0-beta.197 56 03/29/2026
1.0.0-beta.195 41 03/29/2026
1.0.0-beta.189 50 03/29/2026
1.0.0-beta.186 54 03/29/2026
1.0.0-beta.184 49 03/29/2026
1.0.0-beta.178 63 03/28/2026
1.0.0-beta.176 37 03/29/2026
1.0.0-beta.167 69 01/17/2026
1.0.0-beta.164 12 10/02/2026
1.0.0-beta.159 10 10/01/2026
1.0.0-beta.157 53 12/13/2025
1.0.0-beta.154 7 10/02/2026
1.0.0-beta.151 64 12/13/2025
1.0.0-beta.149 65 12/12/2025
1.0.0-beta.147 10 10/01/2026
1.0.0-beta.144 55 12/13/2025
1.0.0-beta.139 8 09/28/2026
1.0.0-beta.137 63 12/13/2025
1.0.0-beta.130 58 01/01/2026
1.0.0-beta.127 4 10/02/2026
1.0.0-beta.122 60 12/22/2025
1.0.0-alpha-99 7 10/01/2026
1.0.0-alpha-98 62 12/20/2025
1.0.0-alpha-97 53 12/12/2025
1.0.0-alpha-117 64 12/13/2025
1.0.0-alpha-113 9 10/01/2026
1.0.0-alpha-111 64 12/15/2025
1.0.0-alpha-109 65 01/09/2026
1.0.0-alpha-108 8 10/02/2026
1.0.0-alpha-107 13 09/28/2026
1.0.0-alpha-106 58 12/15/2025
1.0.0-alpha-104 58 12/16/2025
1.0.0-alpha-103 6 10/01/2026
1.0.0-alpha-102 56 12/18/2025
1.0.0-alpha-101 53 12/16/2025
1.0.0-alpha-100 67 12/15/2025
0.18.0 28 07/25/2026
0.18.0-beta.233 27 07/25/2026
0.17.0 68 12/15/2025
0.17.0-alpha-87 14 09/28/2026
0.17.0-alpha-86 8 10/02/2026
0.17.0-alpha-80 54 12/13/2025
0.17.0-alpha-78 56 12/21/2025
0.17.0-alpha-77 8 10/02/2026
0.17.0-alpha-76 53 12/24/2025
0.17.0-alpha-75 7 09/30/2026
0.16.4 43 12/11/2025
0.16.4-alpha-72 60 12/14/2025
0.16.4-alpha-68 42 01/01/2026
0.16.3 5 10/01/2026
0.16.3-alpha-65 9 10/02/2026
0.16.2 59 01/02/2026
0.16.2-alpha-62 6 09/28/2026
0.16.2-alpha-61 49 12/24/2025
0.16.2-alpha-60 52 01/01/2026
0.16.2-alpha-42 8 10/02/2026
0.16.2-alpha-35 36 12/14/2025
0.16.2-alpha-30 39 01/17/2026
0.16.2-alpha-29 55 12/11/2025
0.16.2-alpha-28 38 01/01/2026
0.16.1 49 12/12/2025
0.16.1-alpha-27 6 09/30/2026
0.16.1-alpha-24 52 12/21/2025
0.16.0 45 01/09/2026
0.16.0-alpha-23 58 12/12/2025
0.16.0-alpha-19 62 12/11/2025
0.15.1 56 01/17/2026
0.15.1-alpha-13 59 01/01/2026
0.15.1-alpha-11 47 12/15/2025
0.15.0 46 12/19/2025
0.15.0-alpha-7 54 12/15/2025
0.14.3-alpha-5 37 12/12/2025
0.14.3-alpha-4 46 12/20/2025
0.14.3-alpha-166 53 12/15/2025
0.14.3-alpha-165 6 10/02/2026
0.14.2 52 12/24/2025
0.14.2-alpha-163 11 10/02/2026
0.14.2-alpha-162 54 12/20/2025
0.14.1 54 01/01/2026
0.14.1-alpha-161 59 12/15/2025
0.14.0 56 12/13/2025
0.14.0-alpha-160 54 12/14/2025
0.14.0-alpha-154 55 01/09/2026
0.14.0-alpha-152 58 01/01/2026
0.14.0-alpha-149 64 01/01/2026
0.14.0-alpha-147 50 12/14/2025
0.14.0-alpha-145 62 12/22/2025
0.14.0-alpha-143 10 10/01/2026
0.14.0-alpha-139 50 12/15/2025
0.14.0-alpha-138 60 01/09/2026
0.13.0 58 12/24/2025
0.13.0-alpha-135 58 01/09/2026
0.13.0-alpha-131 6 10/01/2026
0.13.0-alpha-123 7 10/01/2026
0.13.0-alpha-121 46 01/23/2026
0.13.0-alpha-119 54 12/22/2025
0.13.0-alpha-117 43 01/01/2026
0.13.0-alpha-116 52 12/19/2025
0.13.0-alpha-115 59 12/22/2025
0.13.0-alpha-114 56 12/14/2025
0.13.0-alpha-113 7 09/28/2026
0.12.1 55 12/30/2025
0.12.0 12 09/30/2026
0.10.0 10 10/01/2026