Interaction

Focus

The specified element becomes the active element, allowing keyboard input to be directed to that element. If the element is editable (an INPUT of type text/email/password/search, a TEXTAREA, a contenteditable element, or anything with a text caret), Focus performs a real click on it - this both focuses the element and places the text caret, getting it ready for typing. Non-editable elements are simply focused/moved-to without a click, avoiding side effects like triggering a link navigation or button action.

NOTE

This editable-vs-not branch (via IsElementEditable) is applied consistently across every engine - Hardware, OttoMagic, Puppeteer, and Selenium all click-to-focus editable elements and move-to/focus non-editable ones the same way. It replaces an older Selenium-only special case that sent a Shift keypress to elements to focus them.

Examples

GPAL Fluent: High-level fluent C# API

//For editable elements this is equivalent to a LeftClick (focus + caret placement); for everything else it's equivalent to MoveTo/Hover (focus without a click).

browser.WithSelector(selector).Focus()

browser.Focus(selector)

MagicHelper: MagicHelper utility library

GPAL.MagicHelper.Focus(string css);

GPAL.MagicHelper.Focus(string xpath);

Puppeteer Client: Puppeteer-style C# client

browser.PuppeteerClient.Focus(string css).Execute();

browser.PuppeteerClient.Focus(string xpath).Execute();

Puppeteer Communicator: Low-level communicator

//PuppeteerCommunicator's Focus takes a resolved backendNodeId rather than a raw CSS/XPath selector. For editable elements, GPAL's editable-aware Focus calls the LeftClick path instead (which focuses and places the caret); this DOM.focus-based Focus is used for non-editable elements.

await browser.PuppeteerCommunicator.Focus(int backendNodeId, string sessionId);

REST Client: Direct REST/HTTP client

GPAL.OttoMagicClient.WithEndpoint(ApiEndpoint.Focus).WithCss(string css).Execute();

GPAL.OttoMagicClient.WithEndpoint(ApiEndpoint.Focus).WithXpath(string xpath).Execute();

Documentation Example

Documentation

Showing off some plain text in these paragraphs eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Other formats

Here you can find different accents and emphasis sit amet consectetur adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

This is a link and how it could look like bestlinkinthebeautifulworld. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Here's just some classic bold text adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam notBoldSecondbestlinkinthebeautifulworld illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Obcaecati, iste distinctio veritatis eligendi laboriosam adipisicing elit illo nostrum corporis at adipisicing elit libero vel voluptas? Expedita, adipisicing facere dolores voluptatem ad ab rem assumenda soluta!

Other cuple of colors in case we want to emphasize several ways adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam adipisicing elit illo nostrum corporis at voluptatem libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Adding Images to the content

Lorem ipsum dolor sit amet consectetur adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta! Lorem ipsum dolor, sit amet consectetur adipisicing elit. Quod veniam, quam ad expedita laborum sed at voluptates culpa ipsam ut vel. Ullam temporibus a mollitia quod aliquam ratione exercitationem nesciunt.

Coding Blocks

Lorem ipsum dolor sit amet consectetur adipisicing elit. Repudiandae quas consequuntur illo numquam assumenda autem exercitationem distinctio perspiciatis in natus. Eius dicta similique ipsam ipsa minima, nemo quae enim tempore.

GPAL

.CallIfNotFound(GenericCallIfNotFound)

.WithPublishToConsole();

//System.Drawing.Rectangle windowSize = new System.Drawing.Rectangle(10, 10, 1500, 1024);

// NOTE: we have to set browser = before we execute any steps

// this is due to the 'GenericCallIfNotFound' which might throw an exception, and BankScraper will not have the browser set when it calls scraper.Close()

// until the complete fluent line gets executed (meaning every step, meaning browser is not set until everything else succeeds)

browser = GPAL.Browser

.WithBrowserType(Enums.BrowserType.Chrome)

.WithProfileDataDirectory(ChromeProfileLocation)

.WithUseAutomationEngine(AutomationEngine.Selenium)

.WithWindowSize(new System.Drawing.Rectangle(0,0,1920,1080))

.ToGPALObject();

Interaction

Interaction

Focus

Examples

Documentation Example

Documentation

Category

Endpoint

Enpoint

Enpoint

Enpoint

Other formats

Adding Images to the content

Coding Blocks

On this page