导航 SVG – Navigation & Inspection SVG – Aspose.SVG for .NET

有时您需要检查 SVG 文件的内容，例如，获取有关文件、元素和层次结构的信息。 Aspose.SVG for .NET API 与官方 SVG 规范 完全兼容，可用于遍历 SVG 文档对象模型 (DOM)。该 API 支持 SVG 内容的各种导航和检查功能。

在本节中，您将了解：

• 如何以字符串形式查看 SVG 内容；
• 如何使用 API 对文档及其元素进行详细检查；
• 有哪些方法可以获取有关 SVG 文件中特定元素的信息；
• 关于迭代文档元素的自定义过滤器用法；
• 如何使用 CSS 选择器或 XPath 查询浏览文档。

您可以从 GitHub 下载完整的示例和数据文件。关于从 GitHub 下载并运行示例，您可以从 如何运行示例 部分找到。

查看 SVG 内容

检查文档内容的最简单方法是将内容视为字符串。 Element 类的属性 InnerHTML 和 OuterHTML 返回表示元素及其内容的 XML(或 HTML)片段。它们是专门为将 SVG 内容作为字符串查看而开发的。 以下代码示例演示如何在控制台中查看 bezier-curves.svg 文件的内容。

using Aspose.Svg;
using System.IO;

// Get SVG document OuterHTML in C#

// Load an SVG document
using (SVGDocument document = new SVGDocument(Path.Combine(DataDir, "bezier-curves.svg")))
{
    // Use the OuterHTML property
    string html = document.DocumentElement.OuterHTML;

    Console.WriteLine(html);
}
// View the document content

使用 DOM 导航和检查 SVG

提取有关特定 SVG 元素的信息

以下示例演示如何从文件 shapes.svg 中提取有关特定 SVG 元素的信息：

using Aspose.Svg;
using System.IO;
using System.Linq;

// Extract information about specific SVG element

string documentPath = Path.Combine(DataDir, "shapes_svg.svg");

// Load a document from a file
using (SVGDocument document = new SVGDocument(documentPath))
{
    // Get the root <svg> element of the document
    Element svg = document.DocumentElement;

    // Find the first child element with a given tag name
    SVGGElement g = svg.GetElementsByTagName("g").First() as SVGGElement;
    SVGRectElement rect = g.FirstElementChild as SVGRectElement;

    Console.WriteLine("Height: {0}", rect.Height);// 100
    Console.WriteLine("Width: {0}", rect.Width); // 100
}

在示例中， DocumentElement 属性的使用允许直接访问文档的 <svg> 元素。 Element 类的方法 GetElementsByTagName() 返回具有给定标签名称的所有后代元素的 NodeList；在这种情况下，返回元素是第一个 <g> 元素。 FirstElementChild 属性返回该元素的第一个子元素节点。在示例中， <g> 元素中的第一个子元素是 <rect> 元素，将打印该元素的宽度和高度值。

检查 SVG 文档及其元素

Aspose.SVG 包含基于 元素遍历规范 的方法列表。您可以使用 API ( shapes.svg) 对文档及其元素执行详细检查。以下代码示例显示了元素遍历功能的一般用法。

using Aspose.Svg;
using System.IO;

// Traverse SVG elements in C# programmatically

// Load an SVG document
using (SVGDocument document = new SVGDocument(Path.Combine(DataDir, "shapes_svg.svg")))
{
    // Get direct access to the <svg> element of the document
    Element element = document.DocumentElement;
    Console.WriteLine(element.TagName); // svg

    // Use the LastElementChild property
    element = element.LastElementChild;
    Console.WriteLine(element.TagName); // g

    // Use the FirstElementChild property
    element = element.FirstElementChild;
    Console.WriteLine(element.TagName); // rect
}

<svg> 元素是一个容器，它用作 SVG 文档的最外层元素。要指向 <svg> 元素，您可以应用几种方法：

• Document 类的 DocumentElement 属性提供对文档的 <svg> 元素的直接访问。在上面的代码片段中，我们使用了这种方式。
• SVGDocument 类的 RootElement 属性返回文档层次结构中的根 <svg> 元素。要指示<svg>元素，您可以应用以下代码：

var svgElement = document.RootElement;

Document 类的 LastElementChild 属性返回<svg>元素的最后一个子元素。它是 <g> 元素。根据上面的代码片段，变量元素再次被重载，FirstElementChild 属性返回 <g> 元素的第一个子元素。它是 <rect> 元素。

自定义过滤器的使用

Aspose.SVG API 允许您定义自定义过滤器并使用它们来迭代文档元素，如以下代码示例所示：

using Aspose.Svg;
using System.IO;
using Aspose.Svg.Dom;
using Aspose.Svg.Dom.Traversal.Filters;

// Iterate SVG nodes with NodeIterator in C#

using (SVGDocument document = new SVGDocument(Path.Combine(DataDir, "shapes.svg")))
{
    // Create a node iterator
    using (INodeIterator iterator = document.CreateNodeIterator(document, NodeFilter.SHOW_ALL, new RectFilter()))
    {
        Node node;
        while ((node = iterator.NextNode()) != null)
        {
        }
    }
}

where the RectFilter class is defined as follows:

    public class RectFilter : NodeFilter
    {
        public override short AcceptNode(Node n)
        {
            return string.Equals("rect", n.NodeName) ? FILTER_ACCEPT : FILTER_REJECT;
        }
    }

IDocumentTraversal 接口的 CreateNodeIterator(Node, Int64, INodeFilter) 方法创建一个以指定 Node 为根的新迭代器(在我们的示例中，它是 document)。该方法采用 Node 、指定迭代器节点类型的 Int64 标志以及要使用的 INodeFilter 作为参数(在我们的示例中，它是 RectFilter())。

RectFilter 类继承自 NodeFilter 类的 AcceptNode(Node n) 方法。该方法采用一个 Node 并测试它是否通过过滤器；该方法返回一个短值，指示是否找到该节点。

在迭代器中，我们使用 INodeIterator 接口的 NextNode() 方法来访问文档的所有节点。第一次调用 NextNode() 返回第一个节点并移动迭代器在集合中的位置。 Element 类的 OuterHTML 属性返回将要打印的元素的内容。

您可以从 GitHub 下载完整的示例和数据文件。关于从 GitHub 下载并运行示例，您可以从 如何运行示例 部分找到。

使用 CSS 选择器编辑 SVG

Aspose.SVG for .NET 还实现了 CSS 选择器规范，允许您使用类似 CSS 的样式来浏览文档。

Element 类的 QuerySelector(selector) 方法允许您获取文档中与指定选择器匹配的第一个元素。 QuerySelectorAll(selector) 方法将查询选择器作为参数，并返回与选择器匹配的所有元素的 NodeList。使用生成的元素，您可以进行各种操作：更改其文本、属性、CSS 样式等。

在以下示例中，我们使用 QuerySelector() 和 QuerySelectorAll() 方法在 SVG 文档中导航并搜索所需的元素。

实施例1

在示例 1 中，我们编辑源 owl.svg 文件 – 是由路径和圆形元素绘制的猫头鹰 SVG 图片。

• 我们找到 SVG 文档中的所有圆形元素并更改它们的属性 – 为猫头鹰制作蓝色的大眼睛；
• 我们找到猫头鹰翅膀的路径元素并装饰它。

使用 CSS 选择器：

using Aspose.Svg;
using System.IO;
using Aspose.Svg.Dom;
using Aspose.Svg.Collections;

// Edit SVG elements with CSS selectors in C#

// Load an SVG document
using (SVGDocument document = new SVGDocument(new Url("https://docs.aspose.com/svg/files/owl.svg")))
{
    // Get the root <svg> element of the document
    SVGSVGElement svgElement = document.RootElement;

    // Find the first element that matches the specified in selector
    SVGGElement gElement = svgElement.QuerySelector("g") as SVGGElement;

    // Find all <circle> elements in a <g> element
    NodeList circleNodes = gElement.QuerySelectorAll("circle");

    // Make big blue eyes
    foreach (Node circleNode in circleNodes)
    {
        SVGCircleElement circleElement = circleNode as SVGCircleElement;
        circleElement.R.BaseVal.Value *= 1.5F;
        circleElement.SetAttribute("stroke", "blue");
    }

    // Get a path for the owl's wing
    SVGPathElement wingPath = gElement.QuerySelector("path:nth-child(2)") as SVGPathElement;

    // Apply style attributes to the wing
    wingPath.SetAttribute("stroke-width", "16");
    wingPath.SetAttribute("stroke-dasharray", "2 8");

    document.Save(Path.Combine(OutputDir, "owl-edited1.svg"));
}

您可以通过链接 – owl-edited1.svg 查看并保存编辑后的 ​​SVG 文件。

实施例2

在此示例中，我们展示了如何使用 CSS 选择器来导航文档以进行编辑。我们继续编辑源 owl.svg 文件：

• 在示例2的第一部分中，猫头鹰的圆眼睛将更改为方形并重新着色。

我们创建一个新的 <g> 元素，向其中添加子元素的公共属性(它们将是新的方眼)并将其附加为 <svg> 元素中的最后一个子元素(请参阅 编辑SVG文件);使用 QuerySelectorAll(“g:first-child > circle”) 方法我们找到第一个 <g> 元素中的所有圆；然后我们创建具有大小属性​​的 <rect> 元素，将矩形添加到第二个 <g> 元素中并删除圆形元素。

下面的代码片段演示了如何实现这个任务：

using Aspose.Svg;
using System.IO;
using Aspose.Svg.Dom;
using Aspose.Svg.Collections;

// Replace SVG circles with rectangles in C#

// Load an SVG document
using (SVGDocument document = new SVGDocument(new Url("https://docs.aspose.com/svg/files/owl.svg")))
{
    // Get the root <svg> element of the document
    SVGSVGElement svgElement = document.RootElement;

    // Create a new <g> element with style attributes and append it as the last child of the <svg> element
    SVGGElement gElement = (SVGGElement)document.CreateElementNS(SvgNamespace, "g");
    gElement.SetAttribute("fill", "none");
    gElement.SetAttribute("stroke-width", "2");
    svgElement.AppendChild(gElement);

    // Find all <circle> elements from the first <g> element
    NodeList circleNodes = svgElement.QuerySelectorAll("g:first-child > circle");

    // Make square sky-blue eyes
    foreach (Node circleNode in circleNodes)
    {
        SVGCircleElement circleElement = circleNode as SVGCircleElement;

        float cx = circleElement.Cx.BaseVal.Value;
        float cy = circleElement.Cy.BaseVal.Value;
        float r = circleElement.R.BaseVal.Value;

        SVGRectElement rectElement = (SVGRectElement)document.CreateElementNS(SvgNamespace, "rect");
        rectElement.X.BaseVal.Value = cx - r;
        rectElement.Y.BaseVal.Value = cy - r;
        rectElement.Width.BaseVal.Value = 3 * r;
        rectElement.Height.BaseVal.Value = 3 * r;
        rectElement.SetAttribute("stroke", "SkyBlue");

        // Add a <rectangle> element into the second (new) <g> element and remove <circle> elements
        gElement.AppendChild(rectElement);
        circleElement.Remove();
    }
    // Recolor last rectangle in the second (new) <g> element
    Element lastRect = gElement.LastElementChild;
    lastRect.SetAttribute("stroke", "red");

    document.Save(Path.Combine(OutputDir, "owl-svg-eyes.svg"));
}

• 在示例 2 的第二部分中，猫头鹰翅膀的路径将从曲线更改为折线并重新着色。

using Aspose.Svg;
using System.IO;
using Aspose.Svg.Dom;
using Aspose.Svg.Collections;

// Modify and rewrite SVG path data in C#

// Load an SVG document
using (SVGDocument document = new SVGDocument(Path.Combine(DataDir, "owl-svg-eyes.svg")))
{
    SVGSVGElement svgElement = document.RootElement;

    // Get a path for owl's body from the first <g> element
    Element bodyPath = (svgElement.QuerySelector("g:first-child") as SVGGElement).FirstElementChild;
    bodyPath.SetAttribute("stroke", "Teal");

    // Get a path for the owl's wing from the first <g> element
    SVGPathElement wingPath = svgElement.QuerySelector("g:first-child > path:nth-child(2)") as SVGPathElement;

    // Form new wing path data based on the old
    string d = "";
    foreach (SVGPathSeg pathSeg in wingPath.PathSegList)
    {
        if (pathSeg is SVGPathSegMovetoAbs)
        {
            SVGPathSegMovetoAbs pathSegMovetoAbs = pathSeg as SVGPathSegMovetoAbs;

            d += string.Format(" M {0} {1}", pathSegMovetoAbs.X, pathSegMovetoAbs.Y);
        }
        if (pathSeg is SVGPathSegCurvetoCubicAbs)
        {
            SVGPathSegCurvetoCubicAbs pathSegCurvetoCubicAbs = pathSeg as SVGPathSegCurvetoCubicAbs;

            d += string.Format(
                " L {0} {1} L {2} {3}",
                (pathSegCurvetoCubicAbs.X1 + pathSegCurvetoCubicAbs.X2) / 2F,
                (pathSegCurvetoCubicAbs.Y1 + pathSegCurvetoCubicAbs.Y2) / 2F,
                pathSegCurvetoCubicAbs.X,
                pathSegCurvetoCubicAbs.Y
            );
        }
    }
    // Set d attribute - new path data formation
    wingPath.SetAttribute("d", d.Trim());
    wingPath.SetAttribute("stroke", "Teal");

    document.Save(Path.Combine(OutputDir, "owl-edited2.svg"));
}

上图：源图片(a)、根据示例1编辑后的图片(b)、根据示例2编辑后的图片(c)。

在上面的示例中，我们采用源 owl.svg 文件并编辑一些元素。我们尝试使用导航和检查 Aspose.SVG API 函数以各种方式装饰猫头鹰的眼睛和翅膀。您可以通过链接 – owl-edited2.svg 查看并保存编辑后的 ​​SVG 文件。

使用 XPath 查询导航 SVG

XPath 查询( XML 路径语言)，通常简称为 XPath，是一种用于从文档查询数据的查询语言。它基于 SVG 文档的 DOM 表示，并根据各种标准选择节点。 XPath 表达式的语法非常简单，更重要的是，它易于阅读和支持。

Aspose.SVG 还具有强大的 XPath 规范实现以及遍历规范。这使您能够使用 XPath 查询来浏览文档 ( shapes.svg)，如以下代码示例所示：

using Aspose.Svg;
using System.IO;
using Aspose.Svg.Dom;
using Aspose.Svg.Collections;
...

    using (var document = new SVGDocument(Path.Combine(DataDir, "shapes.svg")))
    {
        //  Evaluate XPath expression
        var xpathResult = document.Evaluate("//rect[@x='120']", document, null, (Dom.XPath.XPathResultType)XPathResultType.Any, null);

        //  Get the next evaluated node
        Console.WriteLine((xpathResult.IterateNext() as Element)?.OuterHTML); 
    }

您可以从 GitHub 下载完整的示例和数据文件。

关于从 GitHub 下载并运行示例，您可以从 如何运行示例 部分找到。