[comp: form]: api design of all form components

[danranVm]

• I have searched the issues of this repository and believe that this is not a duplicate.

• 所有表单组件不提供 modelValue 和 update:modelValue，根据不同的组件类型提供

  • value, update:value （例如 input, textarea）
  • checked, update:checked（例如 radio, checkbox）

• 所有表单组件均需要实现 cdk 中的 forms，其实就是实现一个 control 的 Props,

  • control 的类型为 string | AbstractControl
  • 如果是 string, 就通过依赖注入去父级组件组件中查找，正常返回的是 AbstractControl, 如果返回异常，需要报 warning
  • 在表单组件内部主要用 AbstractControl 干三件事
    • 用 AbstractControl.valueRef 绑定组件的 value
    • 组件在 input 或者 change 的时候，调用一下 AbstractControl.setValue, 设置新值
    • 组件在 blur 的时候，调用一下 AbstractControl.markAsBlurred, 修改状态
  • 另外需要注意一点，control 和 v-model 不能共存
    • 存在 control 的时候，用户不能再使用 v-model, 也就是说此时表单组件是全权通过 AbstractControl 来控制的
    • 可以使用 useValueAccessor 来处理 control 和 v-model 的关系，参见：feat(cdk:forms): add useValueAccessor #173
  • control 无需单元测试，交由 ix-form 和 ix-form-item 组件负责相关测试。

• 关于 cdk forms 更多细节请参考 [cdk: forms]: reactive forms system #115

• 针对支持 v-model 的 props 的一个 API 设计原则：

  • 所有表单组件，需要支持 v-model:value 或者 v-model:checked， 同时提供 change 的 emit
  • 其他的 v-model:xxx 不需要额外提供 xxxChange 事件。