diff --git a/docs/client/api.html b/docs/client/api.html index 80616847fb..ac6449a497 100644 --- a/docs/client/api.html +++ b/docs/client/api.html @@ -1225,6 +1225,51 @@ Returns whether `preventDefault()` has been called for this event. Returning `false` from a handler is the same as calling both `stopImmediatePropagation` and `preventDefault` on the event. +Event types and their uses include: + +
click"}}
+Mouse click on any element, including a link, button, form control, or div.
+Use `preventDefault()` to prevent a clicked link from being followed.
+Some ways of activating an element from the keyboard also fire `click`.
+{{/dtdd}}
+
+{{#dtdd "dblclick"}}
+Double-click.
+{{/dtdd}}
+
+{{#dtdd "focus, blur"}}
+A text input field or other form control gains or loses focus. You
+can make any element focusable by giving it a `tabindex` property.
+Browsers differ on whether links, checkboxes, and radio buttons are
+natively focusable.
+{{/dtdd}}
+
+{{#dtdd "change"}}
+A checkbox or radio button changes state. For text fields, use
+`blur` or key events to respond to changes.
+{{/dtdd}}
+
+{{#dtdd "mouseenter, mouseleave"}}
+The pointer enters or leaves the bounds of an element.
+{{/dtdd}}
+
+{{#dtdd "mousedown, mouseup"}}
+The mouse button is newly down or up.
+{{/dtdd}}
+
+{{#dtdd "keydown, keypress, keyup"}}
+The user presses a keyboard key. `keypress` is most useful for
+catching typing in text fields, while `keydown` and `keyup` can be
+used for arrow keys or modifier keys. These events are somewhat
+idiosyncratic and should be tested carefully.
+{{/dtdd}}
+