doc: update api

Author: tangjinzhou

components/input-number/index.en-US.md

@@ -14,7 +14,7 @@ When a numeric value needs to be provided.
 ## API
 
 | property | description | type | default |
-| --- | --- | --- | --- |
+| --- | --- | --- | --- | --- |
 | autofocus | get focus when component mounted | boolean | false |
 | defaultValue | initial value | number |  |
 | disabled | disable the input | boolean | false |
@@ -27,17 +27,34 @@ When a numeric value needs to be provided.
 | size | height of input box | string | - |
 | step | The number to which the current value is increased or decreased. It can be an integer or decimal. | number\|string | 1 |
 | value(v-model) | current value | number |  |
+| bordered | Whether has border style | boolean | true | 3.0 |
+| addonAfter | The label text displayed after (on the right side of) the input field | slot | - | 3.0 |
+| addonBefore | The label text displayed before (on the left side of) the input field | slot | - | 3.0 |
+| controls | Whether to show `+-` controls | boolean | true | 3.0 |
+| keyboard | If enable keyboard behavior | boolean | true | 3.0 |
+| stringMode | Set value as string to support high precision decimals. Will return string value by `change` | boolean | false | 3.0 |
 
 ### events
 
 | Events Name | Description | Arguments | Version |
 | --- | --- | --- | --- | --- |
 | change | The callback triggered when the value is changed. | function(value: number \| string) |  |  |
 | pressEnter | The callback function that is triggered when Enter key is pressed. | function(e) |  | 1.5.0 |
+| step | The callback function that is triggered when click up or down buttons | (value: number, info: { offset: number, type: 'up' \| 'down' }) => void | 3.0 |
 
 ## Methods
 
 | Name    | Description  |
 | ------- | ------------ |
 | blur()  | remove focus |
 | focus() | get focus    |
+
+## FAQ
+
+### Why `value` can exceed `min` or `max` in control?
+
+Developer handle data by their own in control. It will make data out of sync if InputNumber change display value. It also cause potential data issues when use in form.
+
+### Why dynamic change `min` or `max` which makes `value` out of range will not trigger `change`?
+
+`change` is user trigger event. Auto trigger will makes form lib can not detect data modify source.

components/input-number/index.zh-CN.md

@@ -16,31 +16,48 @@ cover: https://gw.alipayobjects.com/zos/alicdn/XOS8qZ0kU/InputNumber.svg
 
 属性如下
 
-| 成员 | 说明 | 类型 | 默认值 |
-| --- | --- | --- | --- |
-| autofocus | 自动获取焦点 | boolean | false |
-| defaultValue | 初始值 | number |  |
-| disabled | 禁用 | boolean | false |
-| formatter | 指定输入框展示值的格式 | function(value: number \| string): string | - |
-| max | 最大值 | number | Infinity |
-| min | 最小值 | number | -Infinity |
-| parser | 指定从 formatter 里转换回数字的方式，和 formatter 搭配使用 | function( string): number | - |
-| precision | 数值精度 | number | - |
-| decimalSeparator | 小数点 | string | - |
-| size | 输入框大小 | string | 无 |
-| step | 每次改变步数，可以为小数 | number\|string | 1 |
-| value(v-model) | 当前值 | number |  |
+| 成员 | 说明 | 类型 | 默认值 | 版本 |
+| --- | --- | --- | --- | --- |
+| autofocus | 自动获取焦点 | boolean | false |  |
+| defaultValue | 初始值 | number |  |  |
+| disabled | 禁用 | boolean | false |  |
+| formatter | 指定输入框展示值的格式 | function(value: number \| string): string | - |  |
+| max | 最大值 | number | Infinity |  |
+| min | 最小值 | number | -Infinity |  |
+| parser | 指定从 formatter 里转换回数字的方式，和 formatter 搭配使用 | function( string): number | - |  |
+| precision | 数值精度 | number | - |  |
+| decimalSeparator | 小数点 | string | - |  |
+| size | 输入框大小 | string | 无 |  |
+| step | 每次改变步数，可以为小数 | number\|string | 1 |  |
+| value(v-model) | 当前值 | number |  |  |
+| bordered | 是否有边框 | boolean | true | 3.0 |
+| addonAfter | 带标签的 input，设置后置标签 | slot | - | 3.0 |
+| addonBefore | 带标签的 input，设置前置标签 | slot | - | 3.0 |
+| controls | 是否显示增减按钮 | boolean | true | 3.0 |
+| keyboard | 是否启用键盘快捷行为 | boolean | true | 3.0 |
+| stringMode | 字符值模式，开启后支持高精度小数。同时 `change` 事件将返回 string 类型 | boolean | false | 3.0 |
 
 ### 事件
 
-| 事件名称   | 说明           | 回调参数                          | 版本 |
-| ---------- | -------------- | --------------------------------- | ---- |
-| change     | 变化回调       | Function(value: number \| string) |      |
-| pressEnter | 按下回车的回调 | function(e)                       |      |
+| 事件名称 | 说明 | 回调参数 | 版本 |
+| --- | --- | --- | --- |
+| change | 变化回调 | Function(value: number \| string) |  |
+| pressEnter | 按下回车的回调 | function(e) |  |
+| step | 点击上下箭头的回调 | (value: number, info: { offset: number, type: 'up' \| 'down' }) => void | 3.0 |
 
 ## 方法
 
 | 名称    | 描述     |
 | ------- | -------- |
 | blur()  | 移除焦点 |
 | focus() | 获取焦点 |
+
+## FAQ
+
+### 为何受控模式下，`value` 可以超出 `min` 和 `max` 范围？
+
+在受控模式下，开发者可能自行存储相关数据。如果组件将数据约束回范围内，会导致展示数据与实际存储数据不一致的情况。这使得一些如表单场景存在潜在的数据问题。
+
+### 为何动态修改 `min` 和 `max` 让 `value` 超出范围不会触发 `change` 事件？
+
+`change` 事件为用户触发事件，自行触发会导致表单库误以为变更来自用户操作。我们以错误样式展示超出范围的数值。