> For the complete documentation index, see [llms.txt](https://ebay.gitbook.io/mindpatterns/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ebay.gitbook.io/mindpatterns/antipatterns/open-new-window.md). # Open New Window Forcing links to open in a new window is an anti-pattern because we are taking control *away* from the user and forcing web-browsing behaviour upon them. If a user wishes to open a link in a new window, they can do so by using their mouse or keyboard shortcut, without our intervention. If you must create a link that opens in a new window, screen reader users **must** be pre-warned of the behaviour. We achieve this with clipped suffix text: ```markup Shop Now - opens in new window or tab ``` ### Using an Icon Ideally we should also warn *sighted* users of this behaviour. We can do this by adding the text to a foreground image: ```markup Shop Now - opens in new window or tab ``` Alternatively, using a CSS background image: ```markup Shop Now ``` ### References * [Pattern : Link](/mindpatterns/navigation/link.md) * [Technique: Clipped Text](/mindpatterns/techniques/offscreen-text.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ebay.gitbook.io/mindpatterns/antipatterns/open-new-window.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.