docs: add allowClear documentation & examples

Author: hawwei913

docs/api.md

@@ -117,6 +117,18 @@ nav:
           <td>Number</td>
           <td></td>
           <td>Specifies the defaultValue of an InputNumber</td>
+        </tr>
+         <tr>
+          <td>allowClear</td>
+          <td>boolean | { clearIcon?: React.ReactNode; clearValue: T }</td>
+          <td>false</td>
+          <td>If allow to remove input content with clear icon</td>
+        </tr>
+        <tr>
+          <td>onClear</td>
+          <td>Function</td>
+          <td></td>
+          <td>Called when value of an InputNumber cleared</td>
         </tr>
         <tr>
           <td>onChange</td>

docs/demo/allow-clear.tsx

@@ -0,0 +1,55 @@
+/* eslint no-console:0 */
+import InputNumber from '@rc-component/input-number';
+import React from 'react';
+import '../../assets/index.less';
+
+export default () => {
+  const [value, setValue] = React.useState<string | number>(100);
+
+  const onChange = (val: number) => {
+    console.log('onChange:', val, typeof val);
+    setValue(val);
+  };
+
+  return (
+    <div style={{ margin: 10 }}>
+      <InputNumber style={{ width: 200 }} value={value} onChange={onChange} allowClear={true} />
+
+      <hr />
+      <h3>with suffix</h3>
+
+      <InputNumber
+        style={{ width: 200 }}
+        value={value}
+        onChange={onChange}
+        prefix="¥"
+        suffix="RMB"
+        allowClear={true}
+      />
+
+      <hr />
+      <h3>with custom clear value</h3>
+
+      <InputNumber
+        style={{ width: 200 }}
+        value={value}
+        onChange={onChange}
+        prefix="¥"
+        suffix="RMB"
+        allowClear={{ clearValue: 1 }}
+      />
+
+      <hr />
+      <h3>with custom clear icon</h3>
+
+      <InputNumber
+        style={{ width: 200 }}
+        value={value}
+        onChange={onChange}
+        prefix="¥"
+        suffix="RMB"
+        allowClear={{ clearIcon: <span style={{ color: 'red' }}>clear</span> }}
+      />
+    </div>
+  );
+};

docs/example.md

@@ -60,3 +60,7 @@ nav:
 ## spinner
 
 <code src="./demo/spinner.tsx"></code>
+
+## allow-clear
+
+<code src="./demo/allow-clear.tsx"></code>