diff --git a/packages/react-events/docs/Focus.md b/packages/react-events/docs/Focus.md index ea4151bf7302d..1fef78e370ff4 100644 --- a/packages/react-events/docs/Focus.md +++ b/packages/react-events/docs/Focus.md @@ -1,21 +1,31 @@ # Focus The `Focus` module responds to focus and blur events on its child. Focus events -are dispatched for `mouse`, `pen`, `touch`, and `keyboard` -pointer types. +are dispatched for all input types, with the exception of `onFocusVisibleChange` +which is only dispatched when focusing with a keyboard. Focus events do not propagate between `Focus` event responders. ```js // Example -const TextField = (props) => ( - - - -); +const Button = (props) => { + const [ focusVisible, setFocusVisible ] = useState(false); + + return ( + +