PositionAssertions
public
final
class
PositionAssertions
extends Object
java.lang.Object | |
↳ | androidx.test.espresso.assertion.PositionAssertions |
A collection of ViewAssertion
s for checking relative position of elements on the screen.
These comparisons are on the x,y plane; they ignore the z plane.
Summary
Public methods | |
---|---|
static
ViewAssertion
|
isAbove(Matcher<View> matcher)
This method is deprecated.
Use |
static
ViewAssertion
|
isBelow(Matcher<View> matcher)
This method is deprecated.
Use |
static
ViewAssertion
|
isBottomAlignedWith(Matcher<View> matcher)
Returns a |
static
ViewAssertion
|
isCompletelyAbove(Matcher<View> matcher)
Returns a |
static
ViewAssertion
|
isCompletelyBelow(Matcher<View> matcher)
Returns a |
static
ViewAssertion
|
isCompletelyLeftOf(Matcher<View> matcher)
Returns a |
static
ViewAssertion
|
isCompletelyRightOf(Matcher<View> matcher)
Returns a |
static
ViewAssertion
|
isLeftAlignedWith(Matcher<View> matcher)
Returns a |
static
ViewAssertion
|
isLeftOf(Matcher<View> matcher)
This method is deprecated.
Use |
static
ViewAssertion
|
isPartiallyAbove(Matcher<View> matcher)
Returns a |
static
ViewAssertion
|
isPartiallyBelow(Matcher<View> matcher)
Returns a |
static
ViewAssertion
|
isPartiallyLeftOf(Matcher<View> matcher)
Returns a |
static
ViewAssertion
|
isPartiallyRightOf(Matcher<View> matcher)
Returns a |
static
ViewAssertion
|
isRightAlignedWith(Matcher<View> matcher)
Returns a |
static
ViewAssertion
|
isRightOf(Matcher<View> matcher)
This method is deprecated.
Use |
static
ViewAssertion
|
isTopAlignedWith(Matcher<View> matcher)
Returns a |
Inherited methods | |
---|---|
Public methods
isAbove
public static ViewAssertion isAbove (Matcher<View> matcher)
This method is deprecated.
Use isCompletelyAbove(Matcher)
instead.
Returns a ViewAssertion
that asserts that view displayed is completely above the view
matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if there is any vertical overlap. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isBelow
public static ViewAssertion isBelow (Matcher<View> matcher)
This method is deprecated.
Use isCompletelyBelow(Matcher)
instead.
Returns a ViewAssertion
that asserts that view displayed is completely below the view
matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if there any vertical overlap. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isBottomAlignedWith
public static ViewAssertion isBottomAlignedWith (Matcher<View> matcher)
Returns a ViewAssertion
that asserts that view displayed is bottom aligned with the
view matching the given matcher.
The bottom 'y' coordinate of the view displayed must equal the bottom 'y' coordinate of the view matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if the views are not aligned bottom. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isCompletelyAbove
public static ViewAssertion isCompletelyAbove (Matcher<View> matcher)
Returns a ViewAssertion
that asserts that view displayed is completely above the view
matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if there is any vertical overlap. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isCompletelyBelow
public static ViewAssertion isCompletelyBelow (Matcher<View> matcher)
Returns a ViewAssertion
that asserts that view displayed is completely below the view
matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if there is any vertical overlap. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isCompletelyLeftOf
public static ViewAssertion isCompletelyLeftOf (Matcher<View> matcher)
Returns a ViewAssertion
that asserts that view displayed is completely left of the view
matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if there is any horizontal overlap. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isCompletelyRightOf
public static ViewAssertion isCompletelyRightOf (Matcher<View> matcher)
Returns a ViewAssertion
that asserts that view displayed is completely right of the
view matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if there is any horizontal overlap. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isLeftAlignedWith
public static ViewAssertion isLeftAlignedWith (Matcher<View> matcher)
Returns a ViewAssertion
that asserts that view displayed is left aligned with the view
matching the given matcher.
The left 'x' coordinate of the view displayed must equal the left 'x' coordinate of the view matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if the views are not aligned to the left. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isLeftOf
public static ViewAssertion isLeftOf (Matcher<View> matcher)
This method is deprecated.
Use isCompletelyLeftOf(Matcher)
instead.
Returns a ViewAssertion
that asserts that view displayed is completely left of the view
matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if there is any horizontal overlap. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isPartiallyAbove
public static ViewAssertion isPartiallyAbove (Matcher<View> matcher)
Returns a ViewAssertion
that asserts that view displayed is partially above the view
matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if there is no vertical overlap. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isPartiallyBelow
public static ViewAssertion isPartiallyBelow (Matcher<View> matcher)
Returns a ViewAssertion
that asserts that view displayed is partially below the view
matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if there is no vertical overlap. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isPartiallyLeftOf
public static ViewAssertion isPartiallyLeftOf (Matcher<View> matcher)
Returns a ViewAssertion
that asserts that view displayed is partially left of the view
matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if there is no horizontal overlap. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isPartiallyRightOf
public static ViewAssertion isPartiallyRightOf (Matcher<View> matcher)
Returns a ViewAssertion
that asserts that view displayed is partially right of the view
matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if there is no horizontal overlap. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isRightAlignedWith
public static ViewAssertion isRightAlignedWith (Matcher<View> matcher)
Returns a ViewAssertion
that asserts that view displayed is right aligned with the view
matching the given matcher.
The right 'x' coordinate of the view displayed must equal the right 'x' coordinate of the view matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if the views are not aligned to the right. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isRightOf
public static ViewAssertion isRightOf (Matcher<View> matcher)
This method is deprecated.
Use isCompletelyRightOf(Matcher)
instead.
Returns a ViewAssertion
that asserts that view displayed is completely right of the
view matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if there is any horizontal overlap. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |
isTopAlignedWith
public static ViewAssertion isTopAlignedWith (Matcher<View> matcher)
Returns a ViewAssertion
that asserts that view displayed is top aligned with the view
matching the given matcher.
The top 'y' coordinate of the view displayed must equal the top 'y' coordinate of the view matching the given matcher.
Parameters | |
---|---|
matcher |
Matcher |
Returns | |
---|---|
ViewAssertion |
Throws | |
---|---|
AssertionFailedError |
if the views are not aligned top. |
AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
NoMatchingViewException |
if no views match the given matcher. |