Skip to content

usePointerLock

Toggle the pointer lock mode on a target element using this hook.

Parameters

  • a ref object of the target element.

Return Values

NameTypeDescription
refRefObjectthe target element reference.
isEnabledBooleanindicates whether the pointerlock mode is enabled on the target element or not.
isErrorUnknownindicates whether is there an error or not.
enterFunctionenter to pointer lock mode, and it can take some pointer lock options.
exitFunctionexit from the pointer lock mode .
toggleFunctiontoggle between enter and exit, and it can take a boolean to force it.

Example Usage

tsx
import { usePointerLock } from 'react-pre-hooks';

export default function Example() {
  const pointerLock = usePointerLock();

  return (
    <main>
      <div ref={pointerLock.ref} onClick={() => pointerLock.toggle()}>
        Click to {pointerLock.isEnabled ? 'exit' : 'enter'}.
      </div>
    </main>
  );
}
import { usePointerLock } from 'react-pre-hooks';

export default function Example() {
  const pointerLock = usePointerLock();

  return (
    <main>
      <div ref={pointerLock.ref} onClick={() => pointerLock.toggle()}>
        Click to {pointerLock.isEnabled ? 'exit' : 'enter'}.
      </div>
    </main>
  );
}

Released under the MIT License.