User description

In this commit i have added the code inside LocatorsTest, for various types of locators (className, id, xpath), and reffered that code in the corresponding documentation files.

This PR intends in helping to "move code" for elements -> locators -> java bindings.

Right now i haven't added the code examples for relative locators, because i felt there are different websites to show the practical code examples for the same.

Although that code is also ready, if you feel its fine, then in the next commit i can include the following code, and make appropriate changes in the documentation files. But in this case, i guess we will have to change the static image (that is currently attached), or give a better context, that how we are using multiple websites to show the relative locators strategies.

public void findElementByAboveRelativeLocator() {
 WebDriver driver = new ChromeDriver();
 driver.get("https://www.saucedemo.com/");
 // Find element by above relative locator
 By emailLocator = RelativeLocator.with(By.tagName("input")).above(By.id("password"));
 WebElement element = driver.findElement(emailLocator);
}
public void findElementByBelowRelativeLocator() {
 WebDriver driver = new ChromeDriver();
 driver.get("https://www.saucedemo.com/");
 // Find element by below relative locator
 By passwordLocator = RelativeLocator.with(By.tagName("input")).below(By.id("user-name"));
 WebElement element = driver.findElement(passwordLocator);
}
public void findElementByLeftOfRelativeLocator() {
 WebDriver driver = new ChromeDriver();
 driver.get("https://www.selenium.dev/selenium/web/login.html");
 // Find element by left of relative locator
 By emailLocator = RelativeLocator.with(By.tagName("input")).toLeftOf(By.id("password-field"));
 WebElement element = driver.findElement(emailLocator);
}
public void findElementByRightOfRelativeLocator() {
 WebDriver driver = new ChromeDriver();
 driver.get("https://www.selenium.dev/selenium/web/login.html");
 // Find element by right of relative locator
 By passwordLocator = RelativeLocator.with(By.tagName("input")).toRightOf(By.id("username-field"));
 WebElement element = driver.findElement(passwordLocator);
}
public void findElementByNearRelativeLocator() {
 WebDriver driver = new ChromeDriver();
 driver.get("https://www.selenium.dev/selenium/web/login.html");
 // Find element by near relative locator
 By loginButtonLocator = RelativeLocator.with(By.id("login-form-submit")).near(By.id("password-field"));
 WebElement element = driver.findElement(loginButtonLocator);
}
public void findElementByChainingRelativeLocators() {
 WebDriver driver = new ChromeDriver();
 driver.get("https://www.selenium.dev/selenium/web/locators_tests/locators.html");
 // Find element by chaining relative locators
 By newsLetterCheckboxLocator = RelativeLocator.with(By.name("newsletter"))
 .toRightOf(By.xpath("//label[@for='newsletter']")).below(By.id("lname"));
 WebElement element = driver.findElement(newsLetterCheckboxLocator);
}

Also i haven't added any assertions, since they were not present before, although if you want i can add assertion and convert each method as a test case too.

I wasn't able to verify the changes by running hugo server cause the required code only doesn't exist, and its being added right now.

Please let me know if any changes are needed.

Thanks for contributing to the Selenium site and documentation!
A PR well described will help maintainers to review and merge it quickly

Before submitting your PR, please check our contributing guidelines.
Avoid large PRs, and help reviewers by making them as simple and short as possible.

Description

Motivation and Context

Types of changes

• Change to the site (I have double-checked the Netlify deployment, and my changes look good)
• Code example added (and I also added the example to all translated languages)
• Improved translation
• Added new translation (and I also added a notice to each document missing translation)

Checklist

• I have read the contributing document.
• I have used hugo to render the site/docs locally and I am sure it works.

PR Type

Documentation, Enhancement

Description

• Added Java methods for various locator strategies (className, id, cssSelector, etc.) in LocatorsTest.

• Introduced relative locators and their usage in Java, with examples for above, below, toLeftOf, and toRightOf.

• Updated formatting, alignment, and examples in locators documentation across multiple languages (Portuguese, Chinese, Japanese, and English).

• Replaced inline code examples in documentation with references to external Java code files.

• Improved descriptions, explanations, and clarity for locator strategies in the documentation.

Changes walkthrough 📝

Need help?

Type /help how to ... in the comments thread for any questions about Qodo Merge usage.

Check out the documentation for more information.