SwiftSoup项目中的选择器(Selector)使用指南

2025-06-11 22:39:07作者：谭伦延

背景介绍

SwiftSoup是一个用Swift编写的HTML解析库，它移植自著名的Java库jsoup。在HTML解析过程中，选择器(Selector)是一个非常重要的功能，它允许开发者通过CSS选择器语法快速定位和提取HTML文档中的元素。

选择器文档的演变

在SwiftSoup的早期版本中，选择器的使用文档是直接包含在README文件中的。但在后续更新中，这部分内容被移除了。这主要是因为SwiftSoup是从jsoup翻译而来，而原始的选择器文档并非开源内容。

当前解决方案

目前开发者可以通过以下两种方式获取选择器的完整文档：

官方Cookbook：包含了选择器语法的详细说明和使用示例，涵盖了基本选择器、组合选择器、属性选择器等常见用法。
API文档：详细列出了所有可用的选择器方法及其参数说明，这是项目MIT许可证的一部分。

选择器的基本用法

虽然具体文档需要参考外部资源，但选择器在SwiftSoup中的基本使用方式如下：

let html = "<html><head><title>First parse</title></head><body><p>Parsed HTML into a doc.</p></body></html>"
let doc = try SwiftSoup.parse(html)
let elements = try doc.select("p")  // 使用CSS选择器

常见选择器类型

标签选择器：通过HTML标签名选择元素，如"div"、"p"等
类选择器：通过class属性选择，如".classname"
ID选择器：通过id属性选择，如"#idname"
属性选择器：通过属性选择，如"[href]"或"[width=500]"
组合选择器：可以组合使用上述选择器，如"div.content > p.intro"

最佳实践建议

对于复杂的选择器表达式，建议先在小段HTML上测试
优先使用更具体的选择器以提高性能
考虑使用链式调用组合多个简单选择器
处理可能不存在的元素时使用try?避免异常

未来展望

随着SwiftSoup社区的成长，期待能有更多原创的Swift-specific选择器使用文档和示例出现，这将极大地方便Swift开发者使用这个强大的HTML解析库。

SwiftSoup

SwiftSoup: Pure Swift HTML Parser, with best of DOM, CSS, and jquery (Supports Linux, iOS, Mac, tvOS, watchOS)

项目地址：https://gitcode.com/gh_mirrors/sw/SwiftSoup

登录后查看全文

项目优选

收起

kernel

deepin linux kernel

pytorch

Ascend Extension for PyTorch

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer（第 2 版）》、《程序员面试金典（第 6 版）》题解

openGauss kernel ~ openGauss is an open source relational database management system

C++

160

218