AOM Input Event Types

1. Introduction

This section is non-normative.

Input events will be triggered by certain user interactions, in certain contexts, as well as via assistive technology interactions.

2. Use Cases

This section is non-normative.

2.1. Implementing an ARIA slider

TODO: Use case

3. Input Events

The [UIEVENTS] specification defines the InputEvent type which is used by the beforeinput and input events.

3.1. Input event interfaces

The InputEvent interface extends the Event interface.

partial interface InputEvent : UIEvent {
  readonly attribute DOMString? inputType;
};

3.2. Input Event Types

3.2.1. actionIncrement

An InputEvent event with inputType set to actionIncrement fires in response to an input action that increments a control. For example, as a result of a ArrowRight or ArrowUp key press.

This event type is valid for the following roles:

• "progressbar"

• "scrollbar"

• "slider"

• "spinbutton"

3.2.2. actionDecrement

An InputEvent event with inputType set to actionDecrement fires in response to an input action that increments a control. For example, as a result of a ArrowLeft or ArrowDown key press.

This event type is valid for the following roles:

• "progressbar"

• "scrollbar"

• "slider"

• "spinbutton"

3.2.3. actionDismiss

An InputEvent event with inputType set to actionDismiss fires when a dialog or other dismissable ACTION element is closed.

This event type is valid for the following roles:

• "menu"

• "dialog"

• "alertdialog"

3.2.4. actionScrollPageUp

An InputEvent event with inputType set to actionScrollPageUp fires when user requests the current content to scroll up (or right) by a "page", where a page of data is typically equal to one screen.

This type differs from actionIncrement in that it applies only to scrollable content.

This event type is intended for scrollable content, but is valid for all roles (since it can bubble up to the `body` element, which is scrollable).

3.2.5. actionScrollPageDown

An InputEvent event with inputType set to actionScrollPageDown fires when user requests the current content to scroll down (or left) by a "page", where a page of data is typically equal to one screen.

This type differs from actionDecrement in that it applies only to scrollable content.

This event type is intended for scrollable content, but is valid for all roles (since it can bubble up to the `body` element, which is scrollable).

4. Security Considerations

Not applicable. This specification simply adds new possible values for an existing InputEvent attribute.

5. Privacy Considerations

Not applicable. This specification defines new inputType values that will be sent for all users, not just those with accessibility features enabled.

6. Acknowledgements

This section is non-normative

We would like to acknowledge the contributions made by the following:

Dominic Mazzoni, Ian Pouncey,