org.fluentlenium.core.annotation.Unshadow Maven / Gradle / Ivy

package org.fluentlenium.core.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * Experimental: Find element in shadow root using CSS selector
 *
 *  * public class HomepageTest extends FluentPage {
 *
 *      @Unshadow(css = {"outer-shadow-root", "inner-shadow-root", ".element"})
 *      FluentWebElement element;
 *
 *      //Element is instantiated and can be used by test methods.
 * }
 * 
 *
 * It can also handle List and Set collections if many objects are found
 *  * public class HomepageTest extends FluentPage {
 *
 *      @Unshadow(css = {"outer-shadow-root", "inner-shadow-root", "div"})
 *      List<FluentWebElement> elementsList;
 *
 *      @Unshadow(css = {"outer-shadow-root", "inner-shadow-root", "span"})
 *      Set<FluentWebElement> elementsSet;
 *
 *      //elementsList and elementsSet are instantiated and can be used by test methods.
 * }
 * 
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface Unshadow {
  String[] css();
}