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

2025-06-11 01:50:59作者：谭伦延

背景介绍

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

登录后查看全文

项目优选

收起

Ascend Extension for PyTorch

Claude Code 的开源替代方案。连接任意大模型，编辑代码，运行命令，自动验证 — 全自动执行。用 Rust 构建，极致性能。｜ An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get Started

Rust

463

ops-math

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

openEuler内核是openEuler操作系统的核心，既是系统性能与稳定性的基石，也是连接处理器、设备与服务的桥梁。

409

329

RuoYi-Vue3

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

本项目是CANN开源社区的核心管理仓库，包含社区的治理章程、治理组织、通用操作指引及流程规范等基础信息

653

232