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

2025-06-11 14:30:27作者：谭伦延

背景介绍

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

登录后查看全文

项目优选

收起

docs

OpenHarmony documentation | OpenHarmony开发者文档

Ascend Extension for PyTorch

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

🎉 (RuoYi)官方仓库基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统

旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件，通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求，让密码技术应用更简单，同时探索后量子等先进算法创新实践，构建密码前沿技术底座！

1.03 K

448

openGauss-server

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

C++

154

205