导航和检测 SVG – Aspose.SVG for Python via .NET

通常需要检查 SVG 文件的内容来提取有关文件、其元素及其层次结构的信息。通过 .NET API 实现的 Aspose.SVG for Python 完全符合官方 SVG 规范，并提供了使用 SVG 文档对象模型 (DOM) 的广泛功能。此 API 支持 SVG 内容的各种导航和检查功能。

在本文中，您将了解到：

• 如何以字符串形式查看 SVG 内容，以字符串格式提取整个 SVG 内容，以便于查看和操作；
• 如何使用 API 检查文档及其元素。
• 如何获取有关 SVG 文件中特定元素的信息，例如属性和样式。
• 如何使用 CSS 选择器和 XPath 查询导航文档以查找和操作元素。

要继续学习本教程，您应该在 Python 项目中 安装和配置 Aspose.SVG for Python via .NET 库。我们的代码示例可帮助您使用 Python 库创建、加载和读取 SVG 文件。

查看 SVG 内容

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

1. 定义要加载的 SVG 文件的完整路径。
2. 使用 SVGDocument类从指定路径加载SVG文件。
3. 使用 outer_html 属性检索文档根元素的外部 HTML。
4. 将SVG文档的HTML内容打印到控制台，以查看其结构和内容。

using Aspose.Svg;
using System.IO;
...
import os
from aspose.svg import *

# Setup directories
data_dir = "data/"
document_path = os.path.join(data_dir, "document.svg")

# Load an SVG document
with SVGDocument(document_path) as document:
    html = document.document_element.outer_html

    print(html)
# View the document content

使用 DOM 导航和检查 SVG

文档对象模型 (DOM) 通过提供文档元素及其关系的结构化视图，对于导航 SVG 文件至关重要。它提供对 SVG 元素和属性的编程访问，允许详细的检查和操作。通过 DOM，开发人员可以使用按标签名称、类或 ID 选择元素的方法来导航 SVG 结构。他们还可以使用 CSS 选择器和 XPath 查询来有效地查找特定元素。这种分层模型可以轻松读取和修改 SVG 内容，获取特定元素的详细信息，并灵活而强大地与 SVG 交互。

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

以下示例演示如何从文件 shapes.svg 中提取有关特定 SVG 元素的信息。此代码片段演示了如何加载 SVG 文档、迭代特定元素(本例中为<rect>)以及安全访问和打印其属性：

1. 调整 input_path 变量以指向您的实际 SVG 文件位置。
2. 使用SVGDocument(input_path)构造函数从指定的input_path加载SVG文件。
3. 使用 get_elements_by_tag_name(“rect”) 方法迭代 SVG 文档中的所有 <rect> 元素。
4. 打印每个<rect>元素的标签名称和ID。

fimport os
from aspose.svg import *

# Prepare a path to the source and output SVG file
data_dir = "data/"
input_path = os.path.join(data_dir, "shapes.svg")

# Load the SVG document
document = SVGDocument(input_path)

# Iterate over elements in the SVG document
for element in document.get_elements_by_tag_name("rect"):
    print(f"Element: {element.tag_name}, ID: {element.id}")

# Print attributes of the element
    attributes = element.attributes
    for i in range(attributes.length):
        attr = attributes[i]
        if attr is not None:
            print(f" Attribute: {attr.name} = {attr.value}")

运行此示例后，您将得到以下结果：

Element: rect, ID: first-rect
  Attribute: id = first-rect
  Attribute: x = 50
  Attribute: y = 90
  Attribute: width = 100
  Attribute: height = 90
  Attribute: style = stroke-width:5; stroke:FireBrick
Element: rect, ID: second-rect
  Attribute: id = second-rect
  Attribute: x = 120
  Attribute: y = 150
  Attribute: width = 120
  Attribute: height = 120
  Attribute: style = stroke-width:10; stroke:DarkCyan
Element: rect, ID: third-rect
  Attribute: id = third-rect
  Attribute: x = 170
  Attribute: y = 220
  Attribute: width = 90
  Attribute: height = 90
  Attribute: style = stroke-width:5; stroke:FireBrick

检查 SVG 文档及其元素

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

以下是加载 SVG 文档 ( shapes.svg)、浏览其元素并打印标签名称的 Python 代码：

import os
from aspose.svg import *

# Setup directories
data_dir = "data/"
document_path = os.path.join(data_dir, "shapes.svg")

# Load a document
with SVGDocument(document_path) as document:
    # Get the root element
    element = document.document_element
    print(element.tag_name)  # svg

    # Get the last child element of the root (which should be a <g> element)
    element = element.last_element_child
    print(element.tag_name)  # g

    # Get the first child element of the <g> element (which should be a <rect> element)
    element = element.first_element_child
    print(element.tag_name)  # rect

1. <svg> 元素是一个容器，它用作 SVG 文档的最外层元素。要指向<svg>元素，您可以使用 SVGDocument 类的document_element属性来直接访问文档的<svg>元素。在上面的代码片段中，我们使用了这种方式。
2. last_element_child 属性返回该元素的最后一个子元素节点。在上面的示例中，它是<g>元素。
3. 根据上面的代码片段，first_element_child属性返回<g>元素的第一个子元素。它是<rect>元素。

使用 CSS 选择器编辑 SVG

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

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

在下面的示例中，我们使用query_selector()方法来导航 SVG 文档并搜索所需的元素以进行编辑：

import os
from aspose.svg import *

# Setup directories
output_dir = "output/"
data_dir = "data/"

document_path = os.path.join(data_dir, "shapes.svg")

# Load an SVG document from the file
document = SVGDocument(document_path)

# Get root svg element of the document
svg_element = document.root_element

# Get circle element to change color
circle_element = svg_element.query_selector("circle")

# Set a new "fill" attribute value for the circle element
circle_element.set_attribute("stroke", "DarkCyan")

# Save the SVG document to a file
output_path = os.path.join(output_dir, "circle-color.svg")
document.save(output_path)

上图：源图片(a)和编辑后的图片(b)。

使用 XPath 查询导航 SVG

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

Aspose.SVG 还具有强大的 XPath 规范实现以及遍历规范。 XPath 查询主要使用 Document 类的 evaluate() 方法进行。 evaluate(expression, contextNode, resolver, type, result)方法接受 XPath 表达式和其他给定参数，并返回指定类型的结果。这使您能够使用 XPath 查询来浏览文档 ( shapes.svg)，如以下代码示例所示：

import os
from aspose.svg import *
from aspose.svg.dom.xpath import XPathResultType

# Setup directories
output_dir = "output/"
data_dir = "data/"
if not os.path.exists(output_dir):
    os.makedirs(output_dir)

# Prepare a path to a file loading
document_path = os.path.join(data_dir, "shapes.svg")

# Load an SVG document from the file
document = SVGDocument(document_path)

# Evaluate XPath expression
xpath_expression = "//rect[@x='120']"
xpath_result = document.evaluate(xpath_expression, document, None, XPathResultType.ANY, None)

# Get the next evaluated node and print its parent_element
node = xpath_result.iterate_next()
if node:
    print(node.parent_element)

参见

• 安装 文章提供了有关如何在您的机器上安装 Aspose.SVG for Python via .NET 的分步指南。
• 如果您有兴趣设置许可证、应用计量许可证，或者想尝试 Aspose.SVG Python 库的评估版本，请参阅 许可 文章。
• 将 SVG 转换和渲染为其他格式的场景可在 在 Python 中转换 SVG 文件 部分查看。