如何用Selenium匹配span data-role文本并勾选对应复选框

方法一：遍历元素匹配目标文本 #

遍历所有复选框容器元素，提取文本内容与目标字符串对比，匹配后点击对应的复选框：

// 可动态替换为目标名称
string targetText = "GAF";
IReadOnlyCollection<IWebElement> items = driver.FindElements(By.XPath("//*[@data-role='checkbox']"));

foreach (IWebElement item in items)
{
    // 去除文本首尾空白，避免空格干扰匹配
    string itemText = item.Text.Trim();
    
    // 精准匹配文本（如需忽略大小写，可改用StringComparison.OrdinalIgnoreCase）
    if (itemText.Equals(targetText))
    {
        // 定位当前容器内的span.gj-icon复选框
        IWebElement checkbox = item.FindElement(By.CssSelector("span.gj-icon"));
        // 仅当复选框未勾选时执行点击
        if (!checkbox.Selected)
        {
            checkbox.Click();
        }
        // 找到目标后终止遍历，提升效率
        break;
    }
}

方法二：直接通过XPath精准定位（更高效） #

无需遍历所有元素，直接用XPath定位包含目标文本的复选框，减少不必要的DOM操作：

string targetText = "GAF";
// 使用normalize-space处理文本中的换行、空格，确保匹配准确
IWebElement targetCheckbox = driver.FindElement(By.XPath($"//*[@data-role='checkbox'][normalize-space(text())='{targetText}']//span[@class='gj-icon']"));

if (!targetCheckbox.Selected)
{
    targetCheckbox.Click();
}

优化建议 #

1. 处理特殊字符：如果目标文本包含单引号等XPath特殊字符，需要对字符串进行转义，避免语法错误。
2. 显式等待元素加载：若页面加载较慢，结合显式等待确保元素可被定位：

WebDriverWait wait = new WebDriverWait(driver, TimeSpan.FromSeconds(10));
string targetText = "GAF";
IWebElement targetCheckbox = wait.Until(d => 
    d.FindElement(By.XPath($"//*[@data-role='checkbox'][normalize-space(text())='{targetText}']//span[@class='gj-icon']"))
);

if (!targetCheckbox.Selected)
{
    targetCheckbox.Click();
}

内容的提问来源于stack exchange，提问作者tj26