Skip to content

How to Select Elements by Class in XPath: The Ultimate Guide

If you‘re looking to extract data from websites, chances are you‘ll need to select specific elements based on their classes. Classes are a fundamental way of categorizing and styling elements in HTML. Luckily, XPath provides powerful ways to select elements by their class attribute.

In this in-depth guide, we‘ll walk through exactly how to select elements by class using XPath. Whether you‘re a beginner or an experienced web scraper, by the end of this article you‘ll be expertly navigating HTML documents and precisely targeting the elements you need. Let‘s get started!

A Quick Recap on XPath

Before we dive into class selectors, let‘s briefly review what XPath is and how it works. XPath is a query language used to navigate and select nodes in an XML or HTML document. It allows you to write expressions that pinpoint specific elements based on their tag name, attributes, position, and more.

Here are a few key things to know about XPath:

  • XPath treats the document like a tree structure, with a root node and child nodes branching off it
  • Expressions are evaluated from left to right
  • Forward slashes (/) are used to navigate between nodes
  • Elements can be selected based on their name (e.g. //div selects all <div> elements)
  • Predicates in square brackets allow for more precise selection (e.g. //div[@id=‘main‘] selects <div> elements with an id of "main")

With that foundation in place, let‘s turn our attention to classes and how to leverage them in XPath expressions.

Understanding HTML Classes

Classes are an HTML attribute that allows you to assign one or more classnames to elements. They are primarily used for styling purposes with CSS, but are also very useful for targeting specific elements when web scraping.

Here‘s an example of a paragraph element with two classes:

<p class="highlight text-center">This is some text.</p>

In this case, the <p> element has two classes applied to it: "highlight" and "text-center". An element can have any number of classes, which are separated by spaces in the class attribute value.

One thing to keep in mind is that class names are case-sensitive. So class="highlight" and class="Highlight" would be considered two different classes.

Now that we understand what HTML classes are, let‘s look at how we can select elements based on their classes using XPath.

Selecting Elements by Class in XPath

XPath provides two main ways to select elements by their class attribute:

  1. Using the contains() function
  2. Exact class name matching

Let‘s explore each of these approaches in more depth.

Approach 1: Using the contains() Function

The contains() function allows you to select elements whose class attribute contains a specific class name. Here‘s the basic syntax:


For example, to select all <div> elements that have a class of "container", you would use:


The contains() function has a few key characteristics:

  • It is case-sensitive (so "container" and "Container" would be treated as different)
  • The class name can appear anywhere in the class attribute value
  • The element can have other classes applied as well, as long as it contains the specified one

So contains(@class,‘container‘) would match elements like:

<div class="container"></div>
<div class="wrapper container card"></div>
<div class="container highlighted"></div>

But it would not match:

<div class="containery"></div>
<div class="wrapper"></div>

The contains() approach is versatile and can be a good choice when you want to match elements that have a certain class as part of a set of classes. But if you need to be more precise, the next approach may be preferable.

Approach 2: Exact Class Name Matching

To select elements that have a class attribute that exactly matches a specific value, you can use this syntax:


For instance, to select <p> elements where the class is exactly "highlight", you would use:


This expression would match:

<p class="highlight"></p>  

But not:

<p class="highlight text-center"></p>
<p class="highlights"></p>
<p class="Highlight"></p>

As you can see, the exact match approach is more strict. The class attribute must contain only the specified class name in order to match. No other classes can be present, and the case must match exactly.

This approach is useful when you need to be very precise in your element selection, and want to avoid accidentally matching elements that happen to contain the class as part of a larger set.

XPath and Classes – Key Considerations

When using XPath to select elements by class, there are a few important things to keep in mind:

  • Class names are case-sensitive. As mentioned earlier, "highlight" and "Highlight" are treated as distinct class names. Make sure your XPath expressions match the case exactly.

  • Elements can have multiple classes. It‘s very common for elements to have more than one class applied, separated by spaces. The contains() approach will match elements as long as they contain the specified class somewhere in their class attribute.

  • Exact matching is more precise but less flexible. If you use [@class=‘classname‘], the class attribute must only contain that class. If there are other classes applied, the element won‘t be matched. In contrast, contains(@class,‘classname‘) will match as long as the class appears somewhere in the attribute value.

  • XPath is supported by most web scraping tools and libraries. Whether you‘re using Python with BeautifulSoup or Scrapy, JavaScript with Puppeteer or Cheerio, or another language/framework, you‘ll likely be able to use XPath expressions to extract data. The syntax for class selection remains the same.

  • Performance matters for large-scale scraping. While XPath is very powerful, it can also be slower than other methods like CSS selectors, especially for more complex expressions. If you‘re scraping a large number of pages, it‘s worth benchmarking different approaches to see which yields the best performance.

Class Selector Best Practices and Tips

To get the most out of XPath class selectors, consider these best practices and tips:

  • Use the simplest expression that gets the job done. Sometimes a simple //element[@class=‘classname‘] is all you need. Avoid unnecessary complexity.

  • Combine class selectors with other criteria when needed. You can use predicates to select elements based on multiple attributes (e.g. //button[@class=‘primary‘ and @type=‘submit‘]), or combine class selectors with positional selectors (e.g. (//div[@class=‘row‘])[2] to select the second row).

  • Be mindful of changes to the site‘s HTML. Classes are often used for styling purposes, which means they may change more frequently than other attributes like IDs. If your scraper breaks, double check that the classes you‘re targeting are still present on the page.

  • Use relative XPaths to avoid repeating long expressions. If you‘ve already selected a parent element, you can use a dot (.) to select children relative to that element, like //div[@class=‘container‘]/./p.

  • Consider other methods like CSS selectors or regex for specific use cases. While XPath is versatile, there may be times when another approach is simpler or faster. CSS selectors are performant and well-suited for basic selection tasks. Regular expressions can be useful for pattern-matching or extracting data from text content.

Class Selection Examples

Let‘s walk through a few examples of class selection in action using Python and the lxml library.

Suppose we have this HTML:

        <div class="container">
            <p class="highlight">Paragraph 1</p>
            <p>Paragraph 2</p>
            <p class="highlight">Paragraph 3</p>

To select all <p> elements with a class of "highlight", we can use contains():

from lxml import html

tree = html.fromstring(html_string)
highlighted_paragraphs = tree.xpath(‘//p[contains(@class,"highlight")]‘)

for paragraph in highlighted_paragraphs:

# Output: 
# Paragraph 1
# Paragraph 3

If we wanted to select only the <p> elements where the class is exactly "highlight", we would use:

exact_match_paragraphs = tree.xpath(‘//p[@class="highlight"]‘)

To select the <div> element and then find <p> elements with the "highlight" class inside it, we can use a relative XPath:

div = tree.xpath(‘//div[@class="container"]‘)[0]
highlighted_paragraphs = div.xpath(‘./p[contains(@class,"highlight")]‘)

Putting It All Together

In this guide, we‘ve taken an in-depth look at how to select elements by class using XPath. We‘ve covered the two main approaches – using the contains() function and exact class name matching – as well as key considerations, best practices, and examples.

To summarize:

  • XPath is a powerful query language for selecting elements in HTML/XML documents
  • Classes are a way of assigning categories to elements, often for styling or selection purposes
  • The contains(@class,‘classname‘) approach selects elements that contain the specified class as part of their class attribute value
  • The [@class=‘classname‘] approach selects elements where the class attribute exactly matches the specified class
  • XPath class selectors are case-sensitive and can be combined with other criteria or relative selectors
  • It‘s important to choose the simplest expression that accomplishes your goal and to be mindful of changes to the site‘s HTML over time

Armed with this knowledge, you‘re well-equipped to tackle a wide variety of web scraping challenges using XPath and class selectors. Whether you‘re a beginner or a seasoned pro, understanding how to precisely target the elements you need is an essential skill.

As you put these techniques into practice, remember to always be respectful of website owners and abide by any applicable terms of service or robots.txt files. Happy scraping!

Join the conversation

Your email address will not be published. Required fields are marked *