📝 [RFC] Support source in the onSearch handler of Input Component when the value had changed

[kiner-tang]

Summary

Currently, Input.search will fire onSearch event when the clear button is clicked. Sometimes the user does not know what the trigger is for, so when we fire onSearch events, You should tell the user what the trigger source is so that you can make logical decisions and take special actions.

Motivation

As mentioned above and mentioned #44371, we should pass source which user fire into onSearch hander.

API

export interface SearchProps extends InputProps {
  onSearch?: (
    value: string,
    event?:
      | React.ChangeEvent<HTMLInputElement>
      | React.MouseEvent<HTMLElement>
      | React.KeyboardEvent<HTMLInputElement>,
    source?: "clear" | "input"
  ) => void;
}

Example

<Input.Search 
  allowClear
  onSearch={(e, source) => {
    if (source === "clear") {
      // do something
    } else {
      // do something
    }
  }} 
 />

[kiner-tang]

Completed in #44457