Some applications require selector fine-tuning. This depends on the complexity of your application. With the manual selector option, you can hook into the automatically recorded selector to make sure that it always finds the right element.
How it works
You can define a selector by manually adding
- An element class or an element id or an element attribute
- A content selector
- A subSelector (e.g. for iFrames)
- ParentNum for a bigger element frame
Where to find it
You can find and manually edit the automatically recorded selector of an element within the Editor in the black step options of the respective recorded step:
Userlane Selector structure
- Color red: The value for the selector defines the highlighted element, e.g. a DIV box or an INPUT element.
- You can separate multiple elements by space or greater than character (>). By doing so, you go one level deeper in the code structure (you select a more specific element within the bigger element).
- Color blue: The class of an element is added to the element with a dot (‘.’). If the element class has a space in its value, use another dot instead of the space. A space would mean to go undefined level deeper in the code structure.
- Color yellow: The id of an element is added to an element with a ‘#’.
- orderNum defines the number of elements that match the selector value. It starts with 0, so if the orderNum is 2, the third element that matches the selector value will be chosen.
Example 1: General selector structure with class and id:
"selector": "DIV.element.class > INPUT#elementid",
Example 2: Selector Structure with attributes
Example 3: Selector structure with (stable) parts of attributes or classes
“selector”: “DIV[class*=CustomerSearch__InputContainer] INPUT[class*=SearchInput__StyledInput]“,
How to manually adjust the selector
Change the value of an element
You can look up any element in your browser’s developer tools and define the selector value by yourself with the rules above. To get to the HTML code, you can right-click on the element and click at ‘Inspect’.
Add a content selector
You can also modify the selector to make sure that it chooses an element that has a specific content. The detailed process is described in this article. Alternatively:
- Open the selector in the step options of the respective recorded step
- Add the content selector with the “Add content selector” button. If this button is not available this doesn’t work,
- Copy-paste the following selector code in the selector input field (beneath the old selector).
- For label please insert the label code of the respective element (copy-paste the “selector” part from the old/recorded selector).
- For text-to-look-for insert the text/content which is in the element you would like to highlight.
- Delete the old code of the recorded selector.
- Save your selector changes with the respective button. Double check your changes by opening the selector pop up again because if the syntax of your code is not correct, the new selector will not be saved.
Content selector structure:
"value": ["text-first-language", "text-second-language"]
This is a content selector with "type": "contains". Therefore, only a part of the text of the element has to be typed into the content selector. If you want to make sure that an element with the exact same content written in the element is selected, you can use a content selector with "type": "matches":
Adding a subSelector (e.g. for iFrames)
SubSelectors are necessary for iFrames (you cannot have a normal selector that goes inside an iFrame) or for other elements where you want to find a smaller ‘child’ element within a defined bigger ‘parent’ element.
Each subSelector has the same general syntax structure as a normal selector:
With this selector code, the Userlane selector would search for a DIV element with the class ‘example class’ (subSelector ), which is inside the iFrame element with the id ‘same-origin-iframe-id’ (selector ). You can insert and adapt this general code in the same way than described in the content selector above.
ParentNum will take an ascendant (‘parent’) of the selected element. This is useful when you need to enlarge the highlighted area of a specifically defined element. This is also helpful to select elements bigger than the target element you want to highlight, especially when you want your userlane to appear visually more appealing. Here is a code example with parentNum value of 2, which therefore would select the ‘grandparent’ element (two levels up) of the targeted DIV-box:
This is useful when some elements in your page have oppacity:0 until a user hovers over them. You can add this to your selector if you whish to have Userlane find the element even if it's not visible for the end user:
"selector": "DIV > DIV > DIV > DIV > BUTTON > SVG",
Good to know
- Manually editing selectors can be pretty complex. Please don’t hesitate to schedule an assistance call in case of any issues you run into and we’ll help you to make it work:)
- Always make sure that the syntax of the edited selector is correct. We suggest you to always copy-paste the examples from this article and to then adapt the new selector so that you do not forget a comma or quotes. You can also always double check your changed selector by simply opening it again after you saved it.
- Too much technical information? Follow the simpler version of this article to find out how to add a content selector.
Do you need more info?
Contact us via our Intercom Chat or via firstname.lastname@example.org.