SLStaticElement Class Reference
| Inherits from | SLUIAElement : NSObject |
| Declared in | SLStaticElement.h |
Overview
Instances of SLStaticElement represent user interface elements
which cannot be dynamically matched to elements within the element hierarchy,
but which elements have well-defined (“static”) UIAutomation representations.
A UIAutomation representation of an element identifies that element by its position within the element hierarchy: the representation is the path to that element. Components of the path are separated by periods and represent indexes into arrays of accessibility elements. For instance, the following representation identifies the first cell of the first table view of an application:
UIATarget.localTarget().frontMostApp().mainWindow().tableViews()[0].cells()[0];
The representation of a particular element may be discovered using Instruments, by recording a test script and examining the output of the Automation instrument when that element is tapped.
For more information, see the “Understanding the Element Hierarchy” section of this document.
Warning: SLStaticElement does not support the ability of SLElement to dynamically
match objects within the element hierarchy and so is completely dependent
on UIAutomation to access and manipulate those elements.
Note also that for all but app-level elements, a particular static UIAutomation representation cannot be guaranteed to continue to identify a particular user interface element if the application’s element hierarchy changes.
For these reasons, use of SLStaticElement (instead of SLElement)
should be avoided unless absolutely necessary (i.e. a user interface element
does not have any properties that can be described by Subliminal without
referencing private APIs).
Tasks
-
– initWithUIARepresentation:Initializes and returns a newly allocated element with the specified UIAutomation representation.
-
isScrollViewInforms Subliminal that this element identifies an instance of
propertyUIScrollView.
Properties
isScrollView
Informs Subliminal that this element identifies an instance of UIScrollView.
@property (nonatomic) BOOL isScrollViewDiscussion
Developers must set this to YES for an element used to represent a scroll view
so that Subliminal can work around (or at the least warn of) bugs concerning
scroll views in various iOS SDK versions:
When this is set to
YESand tests are running on an iPad simulator or device running iOS 5.x, Subliminal will not try to determine tappability when simulating user interaction with that scroll view, because UIAutomation will always say that the scroll view is not tappable.When this is set to
YESand tests are running on a simulator or device (whether iPhone or iPad) running iOS 7.x or above, Subliminal will issue a warning if it is asked to drag the scroll view, as it will likely fail. See the documentation on-dragWithStartOffset:endOffset:for more information.
Defaults to NO.
Declared In
SLStaticElement.hInstance Methods
initWithUIARepresentation:
Initializes and returns a newly allocated element with the specified UIAutomation representation.
- (instancetype)initWithUIARepresentation:(NSString *)UIARepresentationParameters
- UIARepresentation
The UIAutomation representation of the element, which identifies the element by its position within the element hierarchy. See the class description for more information.
Return Value
An initialized static element.
Discussion
This is the designated initializer for static elements.
Declared In
SLStaticElement.h