Web page attributes
The following is a list of the web page attributes used for Chrome, Edge, and Firefox automation. They can be returned by the Windows spy tool in all spy modes.
Specifies a shortcut key to activate/focus an element.
Alternative text specified in the ‘alt’ attribute within an <img> tag. This is used in case an image cannot be displayed.
Indicates how many child windows the element contains. This can include windows which are not visible, windows with small sizes, and windows obscured by other windows, hence the number indicated may not correspond to what is visible on the screen.
The class name of the tag representing the element, as used in cascading style sheets (CSS). For example in the html tag <div class="navigation">, the class name is "navigation".
Returns the viewable height of an element in pixels, including padding, but not the border, scrollbar or margin. If the element's content is taller than the actual height of the element, this attribute will only return the height that is visible.
Returns the viewable width of an element in pixels, including padding, but not the border, scrollbar or margin. If the element's content is wider than the actual width of the element, this attrbute will only return the width that is visible.
The X location of the element (ie horizontal location as measured from the left), in pixel coordinates, relative to the elements parent window. Note that this parent window may not necessarily be a top-level window but could also be some other type of container.
The Y location of the element (ie vertical location as measured from the top), in pixel coordinates, relative to the elements parent window. Note that this parent window may not necessarily be a top-level window but could also be some other type of container.
CSS selectors provide an alternative method to find or select HTML elements you want to use in Blue Prism. The selectors enhance the existing capabilities of Blue Prism of finding elements by using ID, class name, or type attributes. They provide a different syntax to achieve the same result as when using the Web Path/XPath attribute.
For basic selectors which only use ID, class name, and element type, the preferred approach is to use the existing Web ID, Web Class, or Web Element Type attributes.
To formulate a CSS selector you can use # followed by the ID of the element given in the HTML. For example, if the ID of the element was login_button then the CSS selector would be #login_button. As another example, you could select an element by its class attribute using a . prefix to the selector, for example if the class of the element is red the CSS selector would be .red.
A useful tool for finding CSS selectable data within the browser's web page is the F12 developer tool available in Chrome, Edge, and Firefox. Elements can be inspected by clicking the select element button or by pressing CTRL+SHIFT+C. The example below shows an element with the CSS selector of input.gLFyf.gsfi inspected using Chrome. The view on the right shows this element in the HTML alongside further CSS attributes which can be used to match against.
Indicates the user can change the contents of this web element. This is usually used primarily for web elements that allow the user to enter text. For example, the following <div> element <div contenteditable="true"> would set Web Element Is Editable to “True”.
Indicates the type of the web element, for example, DIV for a <div> element and P for a <p> element.
The height of the web element, in pixels.
The unique ID of the html tag representing the element, as specified in the html source. For example the tag <a id="Section3> has an id of "Section3".
Specifies a regular expression that the <input> element's value is checked against on form submission.
Defines the type of data to be input, e.g. text, date, search, url, tel, email, and password.
Defines the type of hyperlink or the relationship between the source and destination resources. In HTML these are designated with the rel attribute on link, a, or area elements. e.g. <link rel="stylesheet" href="example.css"/> indicates that the external resource linked to with the href attribute is a stylesheet, so a web browser will generally fetch this file to render the page.
Specifies where to open the linked document. e.g. <a href="https://www.blueprism.com" target="_blank">Meet your digital workforce</a>
The name of the element. For example, in the html tag <input name="search">, the web name is "search".
Returns the viewable height of an element in pixels, including padding, border and scrollbar, but not the margin. If the element's content is taller than the actual height of the element, this attribute will only return the height that is visible.
Returns the viewable width of an element in pixels, including padding, border and scrollbar, but not the margin. If the element's content is wider than the actual width of the element, this attribute will only return the width that is visible.
The horizontal coordinate of the element's upper left corner relative to its parent element.
The vertical coordinate of the element's upper left corner relative to its parent element.
The web page URL.
A text representation of the path of the element in the Document Object Model (DOM). For example the path HTML/BODY(1)/TABLE(4) refers to the fourth table element declared under the first body element, declared under the html element in the DOM.
Provides a hint to the user of what can be entered in the field.?
Returns the entire height of an element in pixels, including padding, but not the border, scrollbar or margin.
Returns the entire width of an element in pixels, including padding, but not the border, scrollbar or margin.
Returns the horizontal position (in pixels) of a scroll bar relative to the web element it is contained within.
Returns the vertical position (in pixels) of a scroll bar relative to the web element it is contained within.
Defines the source for an <audio>, <video>, or <picture> element.
Indicates the CSS style applied to an element, such as color, font, or size.
Specifies the tab order of an element (when the Tab button is used for navigating).
The target URL of a web page a hyperlink links to.
The text value contained within the web element.
The value displayed in the element, if any. Relevant only for elements such as edit fields, checkboxes or labels.
The width of the element, in screen pixels.
The horizontal coordinate of the element's upper left corner at the position it is rendered in the browser.
The vertical coordinate of the element's upper left corner at the position it is rendered in the browser.