更改 SVG 背景颜色 – C# 示例

SVG 背景颜色对于提供视觉清晰度和对比度、提高内容的可见性和美观度至关重要。它对于保持设计一致性、通过提供可读文本来提高可访问性以及定义多层组合中的边界至关重要。您可以通过直接修改 SVG 或使用 CSS 或 JavaScript 应用样式来更改 SVG 的背景颜色。

Aspose.SVG for .NET API 允许您编辑 SVG 文档并更改其内容。

在本文中，您将了解如何使用 Aspose.SVG for .NET 将背景颜色应用于 SVG 文件，以及如何使用 Aspose.HTML C# 库在 HTML 文档中处理 SVG 图像的背景颜色。

直接修改SVG

要设置 SVG 图像的背景颜色，您应该插入一个新的 SVG 元素(例如矩形或圆形)作为 SVG 文档中的第一个子元素。此方法采用有关 SVG 元素顺序的规则 - SVG 代码中较晚出现的元素出现在较早出现的元素之上。通过在 SVG 的开头放置一个矩形或圆形，您可以有效地创建一个位于所有其他图形元素下方的背景层。

向 SVG 添加背景

在 SVG 中设置背景颜色的最常见方法是创建一个覆盖整个 SVG 画布的<rect>元素。这种方法确保背景是 SVG 内容本身的一部分。以下代码片段说明了如何向 SVG 添加背景 - 在 SVG 中创建一个新的矩形元素作为背景。为此，矩形被赋予 width="100%"、height="100%" 和 fill="#ebf3f6" 属性，并放置在所有其他 SVG 内容后面：

using Aspose.Svg;
using System.IO;

// Add background color rectangle to existing SVG using C#

// Load an SVG document from a file
SVGDocument document = new SVGDocument(Path.Combine(DataDir, "tree.svg"));

// Get the root SVG element of the document
SVGSVGElement svgElement = document.RootElement;

// Create a rectangle element and set attributes values
SVGRectElement rectElement = (SVGRectElement)document.CreateElementNS("http://www.w3.org/2000/svg", "rect");
rectElement.X.BaseVal.Value = 3;
rectElement.Y.BaseVal.Value = 3;            
rectElement.SetAttribute("width", "100%");
rectElement.SetAttribute("height", "100%");
rectElement.SetAttribute("fill", "#ebf3f6");

// Add the rectangle element as the first child to <svg> element
svgElement.InsertBefore(rectElement, svgElement.FirstChild);

// Save the SVG document
document.Save(Path.Combine(OutputDir, "add-background-color.svg"));

更改 SVG 背景颜色

如果您的 SVG 文档有一个用作背景的元素(例如上例中的矩形)，则更改背景颜色涉及几个步骤：

• 打开源 SVG 文件。
• 获取文档的根<svg>元素。
• 获取第一个矩形元素(或用作背景的另一个 SVG 元素)来更改颜色。
• 为<rect>元素设置新的填充属性值。
• 保存编辑后的 ​​SVG 文档。

using Aspose.Svg;
using System.IO;

// Change background rectangle fill color in SVG using C#

// Load an SVG document from a file
SVGDocument document = new SVGDocument(Path.Combine(DataDir, "add-background-color.svg"));

// Get the root SVG element of the document
SVGSVGElement svgElement = document.RootElement;

// Get the first <rect> element to change color
SVGRectElement rectElement = svgElement.QuerySelector("rect") as SVGRectElement;

// Set a new "fill" attribute value for the <rect> element
rectElement.SetAttribute("fill", "#fef4fd");

// Save the SVG document
document.Save(Path.Combine(OutputDir, "change-background-color-in.svg"));

注意： 这种方式(<rect> 方法)在各个浏览器中最为一致，并确保背景颜色是 SVG 的一部分，即使 SVG 导出或在不同的上下文中使用时也是如此。

下图显示了原始 SVG 图像 (a)、添加背景的图像 (b) 和更改 SVG 背景颜色的图像 (c)：

使用 CSS 更改背景颜色

使用 CSS 更改 SVG 背景颜色是一项常见任务，可增强网页中 SVG 图像的视觉呈现效果。虽然 SVG 元素不支持本机background-color属性，但您可以通过使用 CSS 设置其他 SVG 元素(如<rect>)的样式或通过外部、内部或内联 CSS 应用样式来实现此效果。

内联 CSS – 了解陷阱

您可以直观地尝试直接在 <svg> 元素上使用 style="background-color" 属性，期望它的工作方式与对 <div> 或 <p> 等 HTML 元素的工作方式相同。然而，这种方法充满了陷阱和误解。但有时它确实有效！在以下示例中，我们在<svg>元素的style属性中使用background-color属性：

using Aspose.Svg;
using System.IO;

// Set SVG background color using style attribute on root element in C#

// Prepare a path to a source SVG file
string documentPath = Path.Combine(DataDir, "tulips.svg");

// Load an SVG document from the file
SVGDocument document = new SVGDocument(documentPath);

// Get the root SVG element of the document
SVGSVGElement svgElement = document.RootElement;

// Create a style attribute for the <svg> element
svgElement.SetAttribute("style", "background: grey");

// Save the SVG document
document.Save(Path.Combine(OutputDir, "with-background-color.svg"));

为什么它看起来有效？

在某些浏览器或渲染上下文中，将background-color应用于 SVG 元素可能看起来可行，因为浏览器可能会使用指定的颜色填充分配给 SVG 的空间。但是，这种效果不会发生，因为 SVG 本身有背景，而是因为 SVG 内容周围或后面的区域是彩色的。这可能是一种意外行为，而不是 SVG 规范 定义的功能。

这种方法的问题

在 SVG style 属性中使用 background-color 的主要问题是它不是 SVG 规范的一部分。 SVG 标准不将background-color识别为 SVG 元素的有效样式属性。这意味着：

1. 在一种浏览器中有效的内容可能在另一种浏览器中无效。
2. 背景实际上并不是 SVG 内容的一部分，因此您对其行为和外观的控制较少，尤其是在导出、打印或在其他上下文中处理 SVG 时。

内部CSS

内部 CSS 是指直接嵌入到 HTML 或 SVG 文档中的样式，通常位于<style>标记中。这允许您定义仅适用于当前文档的特定样式，而不会影响其他文档或需要外部样式表。

在下面的示例中，

• 创建<style>元素并将其添加到 SVG 中，以定义用于设置 SVG 背景颜色的 CSS 类.background；
• 创建<rect>元素时，其class属性设置为background，它应用 CSS 中定义的灰色填充；
• 首先插入<style>元素，然后插入<rect>元素，确保矩形充当 SVG 的背景。

using Aspose.Svg;
using System.IO;

// Add SVG background color using CSS style element and rectangle with class in C#

// Set SVG Namespace URL
string SvgNamespace = "http://www.w3.org/2000/svg";

// Load an SVG document from a file
SVGDocument document = new SVGDocument(Path.Combine(DataDir, "tulips.svg"));

// Get the root <svg> element of the document
SVGSVGElement svgElement = document.RootElement;

// Create a <style> element
SVGStyleElement styleElement = (SVGStyleElement)document.CreateElementNS(SvgNamespace, "style");

// Set the CSS content to define a background color class
styleElement.TextContent = @".background {fill: grey;}";

// Insert the <style> element at the beginning of the <svg> element
svgElement.InsertBefore(styleElement, svgElement.FirstChild);

// Create a rectangle element and set the class to "background"
SVGRectElement rectElement = (SVGRectElement)document.CreateElementNS(SvgNamespace, "rect");
rectElement.X.BaseVal.Value = -120;
rectElement.Y.BaseVal.Value = 0;
rectElement.SetAttribute("width", "100%");
rectElement.SetAttribute("height", "100%");
rectElement.SetAttribute("class", "background");

// Add the rectangle element as the first child to the <svg> element, after the <style> element
svgElement.InsertBefore(rectElement, svgElement.ChildNodes[1]);

// Save the SVG document
document.Save(Path.Combine(OutputDir, "add-background-color-with-css.svg"));

这种方法可以将样式和结构完全分离，利用 CSS 来简化管理以及 SVG 背景颜色的潜在未来更改。所有现代浏览器都广泛支持内部 CSS，确保 SVG 图像的渲染一致。

该图显示了原始 SVG 文件 (a) 和添加背景颜色的同一文件 (b) 的可视化效果：

使用 SVG Builder 更改背景颜色

在以下代码中， SVG Builder 以编程方式将背景颜色添加到现有 SVG 文档(对于前面的情况中的 tulips.svg 文件)。

using Aspose.Svg.Builder;
using System.Drawing;
using System.IO;

// Change a background color for an SVG document using SVG Builder

//  Initialize an SVG document
using (SVGDocument document = new SVGDocument(Path.Combine(DataDir, "tulips.svg")))
{
    SVGSVGElement svg = new SVGSVGElementBuilder()
        .Width(100, LengthType.Percentage)
        .Height(100, LengthType.Percentage)
        .Build(document.FirstChild as SVGSVGElement);

    // Create a new <g> element using SVGGElementBuilder and add <style> and <rect> elements to it
    SVGElement g = new SVGGElementBuilder()
        .Id("backgound")
        .AddStyle(style => style
            .Type("text/css")
            .AddRule(".background", r => r.Fill(Color.Gray)
        )
        .AddRect(rect => rect
            .X(-120).Y(0).Width(100, LengthType.Percentage).Height(100, LengthType.Percentage)
            .Class("background")
        ).BuildElement(document));
    svg.InsertBefore(g, svg.FirstElementChild);

    // Save the document
    document.Save(Path.Combine(OutputDir, "add-background-color-with-builder.svg"));
}

代码中的关键步骤涉及使用 SVGGElementBuilder 定义一个组元素 (<g>)，其中包含具有内部 CSS 的<style>元素。此 CSS 通过.background类定义背景颜色。然后添加一个<rect>元素以使用此类应用背景。该组插入到 SVG 的开头，有效设置背景颜色。

在章节 SVG Builder – 高级 SVG 创建和修改 中，您将找到使用 Aspose.SVG Builder API 有效操作 SVG 的指南，涵盖从创建基本元素到高级技术 例如 mixins 和语法糖。

为 HTML 内的 SVG 图像添加背景颜色

要继续学习本教程，您应该在 C# 项目中安装并配置 Aspose.HTML for .NET 库。

处理包含 SVG 图像的 HTML 文档时，您可能需要向 SVG 元素添加背景颜色。尽管 SVG 通常是透明的，但添加背景可以提高可视性和美观性。以下 C# 示例演示如何使用 C# 和适用于 .NET 的 Aspose.HTML 库以编程方式向 HTML 文档中的所有 SVG 元素添加背景颜色。

1. 使用 HTMLDocument() 构造函数之一加载 HTML 文件。
2. 使用 QuerySelector() 方法在 HTML 文档中查找<style>元素，您将在其中添加新的 CSS 规则。
3. 使用 InnerHTML 属性输出 <style> 元素的当前内容，以确保不会覆盖重要规则。
4. 更新 <style> 元素的 TextContent 属性以附加用于设置 SVG 元素背景颜色的 CSS 规则。
5. 使用 Save() 方法将更新的 HTML 文档导出到新文件。

源 HTML 文件 aspose-svg.html 包含内部 CSS。要为所有 SVG 图像添加彩色背景，我们将检查 <style> 元素的当前内容，并向 SVG 元素添加样式规则，指定将应用于 HTML 文件中所有 SVG 图像的背景颜色。

using System.IO;
using Aspose.Html;
...

    // Prepare a path to a source HTML file with SVG image
    string documentPath = Path.Combine(DataDir, "aspose-svg.html");

    // Load an HTML document from the file
    var document = new HTMLDocument(documentPath);

    // Find a <style> element and assign a background color value for all svg elements
    var styleElement = document.QuerySelector("style");

    // Print content of the <style>
    Console.WriteLine(styleElement.InnerHTML);

    // Assign a text content for the style element
    styleElement.TextContent = styleElement.InnerHTML + "svg {background-color: #fef4fd;}";

    // Save the HTML document
    document.Save(Path.Combine(OutputDir, "with-background-color.html"));

该图显示了原始 HTML 文件和添加了 SVG 图像背景颜色的同一文件的可视化效果：

使用 JavaScript 更改背景颜色

SVG 文档

要使用 JavaScript 向 SVG 文件动态添加背景颜色，您可以将 <script> 元素直接嵌入到 SVG 中。以下是有关如何实现此目标的分步指南：

1. 使用 SVGDocument 类加载 SVG 文件。
2. 从加载的文档中访问根<svg>元素。这是您要添加背景的元素。
3. 使用 CreateElementNS() 方法创建一个新的 <script> 元素。该脚本将包含用于添加 SVG 背景颜色的 JavaScript 代码。
4. 定义 JavaScript 代码。选择 SVG 元素，创建一个具有完整尺寸和背景颜色的<rect>，并将其作为第一个子元素插入以设置背景。
5. 将新创建的<script>元素添加到 SVG 文档中。
6. 使用嵌入的 JavaScript 代码保存更新的 SVG 文档，其中现在包含背景颜色逻辑。

using Aspose.Svg;
using System.IO;

// Add SVG background color using embedded JavaScript <script> element in C#

// Load an SVG document from a file
SVGDocument document = new SVGDocument(Path.Combine(DataDir, "tree.svg"));

// Get the root <svg> element of the document
SVGSVGElement svgElement = document.RootElement;

// Create a new <script> element
Element scriptElement = document.CreateElementNS("http://www.w3.org/2000/svg", "script");

// Define JavaScript code to add a <rect> element as the background
scriptElement.TextContent = @"
    var svgElement = document.getElementsByTagName('svg')[0];
    if (svgElement) {
        var rectElement = document.createElementNS('http://www.w3.org/2000/svg', 'rect');
        rectElement.setAttribute('x', '0');
        rectElement.setAttribute('y', '0');
        rectElement.setAttribute('width', '100%');
        rectElement.setAttribute('height', '100%');
        rectElement.setAttribute('fill', '#fef4fd');
        svgElement.insertBefore(rectElement, svgElement.firstChild);
    };
";

// Append the <script> element to the SVG document
svgElement.AppendChild(scriptElement);

// Save the modified SVG document
document.Save(Path.Combine(OutputDir, "svg-background-color-using-script.svg"));

HTML 文档中的 SVG

要继续学习本教程，您应该在 C# 项目中安装并配置 Aspose.HTML for .NET 库。

要使用 JavaScript 和 Aspose.HTML for .NET 更改 HTML 文档中 SVG 图像的背景颜色，您可以将 JavaScript 直接嵌入到 SVG 代码中，然后使用 Aspose.HTML 执行脚本。以下是实现这一目标的方法：

1. 使用 HTMLDocument() 构造函数加载 HTML 文档。
2. 使用 QuerySelector() 通过 ID 或其他属性查找 SVG 元素。
3. 使用 CreateElement() 方法创建一个新的 <script> 元素。将其 TextContent 设置为修改 SVG 背景颜色的 JavaScript 代码。
4. 使用AppendChild()方法将新的<script>元素附加到文档主体，确保执行 JavaScript 代码。
5. 包括条件检查以处理未找到 SVG 元素的情况，并在必要时输出相关消息。
6. 使用 Save() 方法将更新后的包含嵌入脚本的 HTML 文档导出到新文件。

using Aspose.Html;
using System.IO;
...

    // Prepare a path to a source HTML file with SVG image
    string documentPath = Path.Combine(DataDir, "aspose-svg.html");

    // Load an HTML document from the file
    var document = new HTMLDocument(documentPath);

    // Find the SVG element by its ID (or any other attribute)
    var svgElement = document.QuerySelector("svg[id='mySvg']");

    if (svgElement != null)
    {
        // Create a new <script> element
        var scriptElement = document.CreateElement("script");

        // Define JavaScript code to add a <rect> element as the background
        scriptElement.TextContent = @"
            var svgElement = document.getElementById('mySvg');
            if (svgElement) {
                var rectElement = document.createElementNS('http://www.w3.org/2000/svg', 'rect');
                rectElement.setAttribute('x', '0');
                rectElement.setAttribute('y', '0');
                rectElement.setAttribute('width', '100%');
                rectElement.setAttribute('height', '100%');
                rectElement.setAttribute('fill', '#fef4fd');
                svgElement.insertBefore(rectElement, svgElement.firstChild);
            };
        ";

        // Append the <script> element to the HTML document's body
        document.Body.AppendChild(scriptElement);
    }
    else
    {
        // Handle the case where the svgElement was not found
        Console.WriteLine("SVG element not found.");
    }

    // Save the SVG document
    document.Save(Path.Combine(OutputDir, "svg-background-color-html-script.html"));

结论

在本文中，我们研究了使用 Aspose.SVG for .NET 和 Aspose.HTML for .NET 库应用和更改 SVG 图像背景颜色的几种方法：

• 最可靠且符合标准的方法是直接修改 SVG 文档。添加<rect>元素作为 SVG 的第一个子元素会创建一个位于所有其他图形元素下方的纯色背景。此方法特别有用，可确保所有渲染上下文的外观一致和兼容性。
• 对于将 SVG 图像嵌入 HTML 文档的情况，可以使用 CSS 和 JavaScript 来设置 SVG 背景的样式。然而，由于不同的浏览器行为，JavaScript 可能不那么可移植或可靠。

总之，您选择的方法应取决于使用 SVG 的上下文以及所需的控制和一致性级别。直接修改 SVG 通常是最可靠的方法，尤其是对于独立的 SVG 文件。在 HTML 文档中使用 SVG 时，CSS 和 JavaScript 提供了灵活性，但也存在潜在的限制。

参见

• 如何添加新的 SVG 元素并设置其颜色属性，我们在文章 编辑 SVG 文件 中详细介绍了 C# 示例。
• SVG 背景颜色 文章讨论了 SVG 中的背景。它还提供了 SVG 代码示例以及有关如何设置或更改背景颜色的综合指南。
• 文章 SVG 颜色 着眼于如何对 SVG 文本和形状进行着色。您将了解如何定义颜色的概述，包括控制 SVG 内容透明度的各种方法。
• 您可以从 GitHub 下载完整的示例和数据文件。关于从 GitHub 下载并运行示例，您可以在 如何运行示例 部分找到。
• 颜色转换器 是一个免费的在线应用程序，用于在颜色格式之间转换颜色。只需输入颜色代码即可立即获得结果！您不需要任何额外的软件。立即尝试我们强大的颜色转换器！