• 表单组件
    • 交互属性
    • 受限组件
      • 复选框与单选按钮的潜在问题
    • 不受限组件
      • 默认值
    • 高级主题
      • 为什么使用受限组件？
      • 为什么 <textarea> 使用 value 属性？
      • 为什么 <select> 使用 value 属性

    表单组件

    诸如 <input>、<textarea>、<option> 这样的表单组件不同于其他组件，因为他们可以通过用户交互发生变化。这些组件提供的界面使响应用户交互的表单数据处理更加容易。

    关于 <form> 事件详情请查看 表单事件。

    交互属性

    表单组件支持几个受用户交互影响的属性：

    • value，用于 <input>、<textarea> 组件。
    • checked，用于类型为 checkbox 或者 radio 的 <input> 组件。
    • selected，用于 <option> 组件。

    在 HTML 中，<textarea> 的值通过子节点设置；在 React 中则应该使用 value 代替。

    表单组件可以通过 onChange 回调函数来监听组件变化。当用户做出以下交互时，onChange 执行并通过浏览器做出响应：

    • <input> 或 <textarea> 的 value 发生变化时。
    • <input> 的 checked 状态改变时。
    • <option> 的 selected 状态改变时。

    和所有 DOM 事件一样，所有的 HTML 原生组件都支持 onChange 属性，而且可以用来监听冒泡的 change 事件。

    注意:

    对于 <input> and <textarea>， onChange 替代 — 一般应该用来替代 — the DOM’s 内建的 oninput 事件处理。

    受限组件

    设置了 value 的 <input> 是一个受限组件。 对于受限的 <input>，渲染出来的 HTML 元素始终保持 value 属性的值。例如：

    1.   render: function() {
    2.     return <input type="text" value="Hello!" />;
    3.   }

    上面的代码将渲染出一个值为 Hello! 的 input 元素。用户在渲染出来的元素里输入任何值都不起作用，因为 React 已经赋值为 Hello!。如果想响应更新用户输入的值，就得使用 onChange 事件：

    1.   getInitialState: function() {
    2.     return {value: 'Hello!'};
    3.   },
    4.   handleChange: function(event) {
    5.     this.setState({value: event.target.value});
    6.   },
    7.   render: function() {
    8.     var value = this.state.value;
    9.     return <input type="text" value={value} onChange={this.handleChange} />;
    10.   }

    上面的代码中，React 将用户输入的值更新到 <input> 组件的 value 属性。这样实现响应或者验证用户输入的界面就很容易了。例如：

    1.   handleChange: function(event) {
    2.     this.setState({value: event.target.value.substr(0, 140)});
    3.   }

    上面的代码接受用户输入，并截取前 140 个字符。

    复选框与单选按钮的潜在问题

    当心，在力图标准化复选框与单选按钮的变换处理中，React使用click 事件代替 change 事件。在大多数情况下它们表现的如同预期，除了在change handler中调用preventDefault 。preventDefault 阻止了浏览器视觉上更新输入，即使checked被触发。变通的方式是要么移除preventDefault的调用，要么把checked 的触发放在一个setTimeout里。

    不受限组件

    没有设置 value(或者设为 null) 的 <input> 组件是一个不受限组件。对于不受限的 <input> 组件，渲染出来的元素直接反应用户输入。例如：

    1.   render: function() {
    2.     return <input type="text" />;
    3.   }

    上面的代码将渲染出一个空值的输入框，用户输入将立即反应到元素上。和受限元素一样，使用 onChange 事件可以监听值的变化。

    默认值

    如果想给组件设置一个非空的初始值，可以使用 defaultValue 属性。例如：

    1.   render: function() {
    2.     return <input type="text" defaultValue="Hello!" />;
    3.   }

    这个例子会像上面的 不受限组件 例子一样运行。

    同样的， <input> 支持 defaultChecked 、 <select> 支持 defaultValue.

    注意:

    defaultValue 和 defaultChecked props 只能在内部渲染时被使用。 如果你需要在随后的渲染更新值, 你需要使用 受限组件.

    高级主题

    为什么使用受限组件？

    在 React 中使用诸如 <input> 的表单组件时，遇到了一个在传统 HTML 中没有的挑战。比如下面的代码：

    1.   <input type="text" name="title" value="Untitled" />

    在 HTML 中将渲染 初始值 为 Untitled 的输入框。用户改变输入框的值时，节点的 value 属性( property)将随之变化，但是 node.getAttribute('value') 还是会返回初始设置的值 Untitled.

    与 HTML 不同，React 组件必须在任何时间点描绘视图的状态，而不仅仅是在初始化时。比如在 React 中：

    1.   render: function() {
    2.     return <input type="text" name="title" value="Untitled" />;
    3.   }

    该方法在任何时间点渲染组件以后，输入框的值就应该 始终 为 Untitled。

    为什么 <textarea> 使用 value 属性？

    在 HTML 中， <textarea> 的值通常使用子节点设置：

    1.   <!-- 反例：在 React 中不要这样使用！ -->
    2.   <textarea name="description">This is the description.</textarea>

    对 HTML 而言，让开发者设置多行的值很容易。但是，React 是 JavaScript，没有字符限制，可以使用 \n 实现换行。简言之，React 已经有 value、defaultValue 属性，</textarea> 组件的子节点扮演什么角色就有点模棱两可了。基于此， 设置 <textarea> 值时不应该使用子节点：

    1.   <textarea name="description" value="This is a description." />

    如果 非要 使用子节点，效果和使用 defaultValue 一样。

    为什么 <select> 使用 value 属性

    HTML 中 <select> 通常使用 <option> 的 selected 属性设置选中状态；React 为了更方面的控制组件，采用以下方式代替：

    1.   <select value="B">
    2.     <option value="A">Apple</option>
    3.     <option value="B">Banana</option>
    4.     <option value="C">Cranberry</option>
    5.   </select>

    如果是不受限组件，则使用 defaultValue。

    注意：

    给 value 属性传递一个数组，可以选中多个选项：<select multiple={true} value={['B', 'C']}>。