CSS selectors for Selenium with example

When we don't have an option to choose Id or Name, we should prefer using CSS locators as the best alternative.
CSS is "Cascading Style Sheets" and it is defined to display HTML in structured and colorful styles are applied to webpage.

Selectors are patterns that match against elements in a tree, and as such form one of several technologies that can be used to select nodes in an XML document. Visit to know more W3.Org Css selectors

  • CSS has more Advantage than Xpath
  • CSS is much more faster and simpler than the Xpath.
  • In IE Xpath works very slow, where as Css works faster when compared to Xpath.

Click here to view examples compared with xpath and css

Syntax:

tagName[attributename=attributeValue]
Example 1: input[id=email]
Example 2: input[name=email][type=text]

In CSS there are two special characters which has important role to play.

1. dot(.) refers to class.
Syntax:

css=input.submitbtn

For example if the below is the html for a sign button

<button class="submit btn primary-btn flex-table-btn js-submit" type="submit" style="background-color: rgb(85, 172, 238);">
 Log in
 </button>

In the above html there are multiple classes used for the single button. How to work in such a situation????
Below are the examples to work with classes. If you observe, we have combined multiple classes to work. As the class is not unique like ID, we may require to join two classes and find the accurate element.

The CSS class selector matches elements based on the contents of their class attribute. In the below exampleprimary-btn is class attribute value.

Example 1: css=.primary-btn
Example 2: css=.btn.primary-btn
Example 3: css=.submit.primary-btn

The above can be written like below in selenium

WebElement ele1 = driver.findElement(By.cssSelector(".primary-btn"));
WebElement ele2 = driver.findElement(By.cssSelector(".btn.primary-btn"));
WebElement ele3 = driver.findElement(By.cssSelector(".submit.primary-btn"));

Hash(#) refers to Id

Example:

css=input[id=email]

The above one can be re-written as

css=input#destination

CSS locator Examples using ID and Class attributes

/* below syntax will find "input" tag node which contains "id=email" attribute */

css=input[id=email]

In selenium we can write it as

WebElement Email = driver.findElement(By.cssSelector("input[id=email]"));
Email.SendKeys("hello@sampleemail.com");

You can make use of Selenium IDE to verify if the identifier is working fine or not. If the element has identified, it will highlight the field and html code in Yellow color.

Below syntax will find "input" tag which contains "id=email" and "type=text" attribute. Again here we have added multiple attributes which the input tag has. For username, we will have the text type as 'text' and for password the text type will be 'password'.

css=input[name=email][type=text]

Below is the syntax for using input Tag and class attribute: It will find input tag which contains "submitButton" class attribute.

css=input.rc-button.rc-button-submit

Please find the below screen shot with example:
single elements

Using CSS locators, we can also locate elements with sub-strings. Which are really help full when there are dynamically generated ids in webpage

There are there important special characters in css selectors:
1. '^' symbol, represents the starting text in a string.
2. '$' symbol represents the ending text in a string.
3. '*' symbol represents contains text in a string.

CSS Locators for Sub-string matches(Start, end and containing text) in selenium
/*It will find input tag which contains 'id' attribute starting with 'ema' text. Email starts with 'ema' */

css=input[id^='ema']

If you remove the symbol an try to find the element with same sub-string, it will display error as "locator not found". We can observe the error in the below screen shot. one with error and the other with success

starting substring

/*It will find input tag which contains 'id' attribute ending with 'ail' text. Email ends with 'mail' */

css=input[id$='mail'] 

/* It will find input tag which contains 'id' attribute containing 'mai' text. Email contains 'mai' */

css=input[id*='mai'] 

CSS Element locator using child Selectors

/* First it will find Form tag following remaining path to locate child node.*/

css=form>label>input[id=PersistentCookie] 

CSS Element locator using adjacent selectors
/* It will try to locate "input" tag where another "input" tag is present on page. the below example will select third input adjacent tag.

css=input + input + input

CSS selector to select first element

We can do this in two ways : -

First using first-of-type - which represents the first element among siblings of its element type and :nth-of-type() matches elements of a given type, based on their position among a group of siblings.

Let us see an example on this using html.

<div class="home">   
    <span>blah</span>   
    <p>first</p>   
    <p class="red">second</p>   
    <p class="red">third</p>   
    <p class="red">fourth</p> 
</div>

To select the first element with class 'red', css selector should be .red:first-of-type and using nth-of-type, css should be .red:nth-of-type(1)

CSS selector to select last element

Using :last-of-typeselector, we can target the last occurrence of an element within its container. let us look at the below example with html :-

<div class="cList">
    <div class="test"> hello test example1 </div>
    <div class="test"> hello test example2 </div>
    <div class="test"> hello test example3 </div>
</div>

In the above example, if we want to select ' hello test example3', css selector should be .test:last-of-type.

Selenium Tutorials: 

Comments

How to identify the web images using css selector for this html line
<img width="100"height="110" alt="Mercury Tours" src="http://newtours.demoaut.com/images/nav/logo.gif"/>

Its main home page of mercury website and wants validate the leftmost image "Mercury Tours".

I tried with xpath and css,unable.Please help me on this

You can take the help of image tag and write both css and xpaths.
css=img[alt='Mercury Tours'] and
Xpath - //img[@alt='Facebook logo']

Hope this works

here in the above example to write unique CSS locator there is no unique class name or ID so that we can not write CSS locator uniquely, if in that particular page only single image tag is exists then u can write css selector as driver.findElement(By.cssSelector(img)); or driver.findElement(By.cssSelector(img[alt~="Mercury Tours"])); it will works hope.

Hi
Could you please explain what this(~) symbol will does in the css.

plz send all documents

Hi,
How to get a css and xpath for the following html code?

<div class="validation-summary-errors">
<ul>
<li style="background-color: transparent;">Invalid admin credentials (incorrect username or password).</li>
</ul>
</div>

Hi,
Try this
For xpath...
//div[@class='validation-summary-errors']/li

This was very useful to me. Thank you

Simple and Nice, PLZ give more and more example

How to write css for visible text. for ex:
xpath for <a href="">Birds</a> would be //a[text()='Birds']
Similarly how can we write css for the same.

Add new comment

Image CAPTCHA