Skip to content

[UFC-1708] Add docs for Autofocus page property #9848

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jul 30, 2025
Merged

[UFC-1708] Add docs for Autofocus page property #9848

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
80dd6e4
Add docs for Autofocus page property
brambrink Jul 15, 2025
cc9ceb3
Update page-properties.md
ConnorLand Jul 29, 2025
cc962c9
Move Autofocus from the mx9 refguide to the mx11 refguide
brambrink Jul 29, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions content/en/docs/refguide/modeling/pages/page/page-properties.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,20 @@ The title of the page that is shown using the [page title widget](/refguide/page

The title can be overridden. For example, the [Create button](/refguide/control-bar/) and the [Edit button](/refguide/control-bar/) of a data grid can refer to the same page, but they override the titles to **New** and **Edit**, respectively.

#### Autofocus {#autofocus}

The **Autofocus** property determines which element (if any) receives focus when users first arrive on a page. When enabled, it automatically sets focus to the first interactive element on the page, such as a text field, button, or dropdown menu. When an element receives focus, it typically shows a visible outline and can be immediately interacted with using keyboard controls. This feature is particularly beneficial for deterministic UX scenarios such as login forms.

However, autofocus can interfere with accessibility tools (particularly screen readers) and may disorient users by unexpectedly moving their focus position. Therefore, we recommended disabling it on most pages. Note that even with autofocus disabled, users can still navigate through interactive elements using the **Tab** key for keyboard navigation. You can choose to enable autofocus only for desktop platforms or across all devices, depending on your specific needs.

| Value | Behavior |
|-------|----------|
| Off | No autofocus |
| Desktop only | Autofocus is only enabled on desktop devices (computers/laptops) |
| All platforms | Autofocus is enabled on all devices (desktop, mobile, tablets) |

By default, **Autofocus** is set to "Off" for any newly created pages. For backwards compatibility, pages created in versions prior to Mendix 11.1 **Autofocus** default to "Desktop only", as this was the autofocus behavior in earlier versions.

#### URL {#url}

A page's URL allows end users to directly navigate to the page (for example, from external links or bookmarks). It will be shown in the address bar of the browser when you visit the page. When navigating to a page without a URL configured, the last visited URL is shown. Note that the full URL of the page will be the base URL of your application followed by `/p/` and then by the configured URL of the page (for example, `http://example.mendixcloud.com/p/home_page`).
Expand Down