@@ -1960,22 +1960,19 @@ var CONSTANT_VALUE_REGEXP = /^(true|false|\d+)$/;
1960
1960
* @name ngValue
1961
1961
*
1962
1962
* @description
1963
- * Binds the given expression to the value of `<option>` or {@link input[radio] `input[radio]`},
1964
- * so that when the element is selected, the {@link ngModel `ngModel`} of that element is set to
1965
- * the bound value.
1963
+ * Binds the given expression to the value of the element.
1966
1964
*
1967
- * `ngValue` is useful when dynamically generating lists of radio buttons using
1968
- * {@link ngRepeat `ngRepeat`}, as shown below.
1965
+ * It is mainly used on {@link input[radio] `input[radio]`} and option elements,
1966
+ * so that when the element is selected, the {@link ngModel `ngModel`} of that element (or its
1967
+ * {@link select `select`} parent element) is set to the bound value. It is especially useful
1968
+ * for dynamically generated lists using {@link ngRepeat `ngRepeat`}, as shown below.
1969
1969
*
1970
- * Likewise, `ngValue` can be used to set the value of `<option>` elements for
1971
- * the {@link select `select`} element.
1972
- *
1973
- * It can further be used to achieve one-way binding of a given expression to an input element that
1974
- * does not use ngModel.
1970
+ * It can also be used to achieve one-way binding of a given expression to an input element
1971
+ * such as an `input[text]` or a `textarea`, when that element does not use ngModel.
1975
1972
*
1976
1973
* @element input
1977
1974
* @param {string= } ngValue angular expression, whose value will be bound to the `value` attribute
1978
- * and `value` property of the element
1975
+ * and `value` property of the element.
1979
1976
*
1980
1977
* @example
1981
1978
<example name="ngValue-directive" module="valueExample">
0 commit comments