styleguidist/react-styleguidist

Support for useImperativeHandle

Open

#1,426 opened on 2019年8月30日

GitHub で見る
 (0 comments) (3 reactions) (0 assignees)TypeScript (1,416 forks)github user discovery
help wanted

Repository metrics

Stars
 (11,091 stars)
PR merge metrics
 (PR metrics pending)

説明

The problem

useImperativeHandle allows components to expose some of their API similarly to instance class methods.

function FancyInput(props, ref) {
  const inputRef = useRef();
  useImperativeHandle(ref, () => ({
    focus: () => {
      inputRef.current.focus();
    }
  }));
  return <input ref={inputRef} ... />;
}
FancyInput = forwardRef(FancyInput);

allows calling fancyInputRef.current.focus() in other component.

Proposed solution

It would be great to treat functions returned from this hook as part of the external API and add them to the documentation

Alternative solutions

I guess, this needs to be done in the react-dogen but I'd like to keep track of this in this repo. We could also move the issue over.

コントリビューターガイド