Skip to content

Commit e79a20e

Browse files
jdavisp3petebacondarwin
authored andcommitted
docs(booleanAttrs): improve grammar and clarity
Closes angular#4392
1 parent 27519e9 commit e79a20e

File tree

1 file changed

+20
-20
lines changed

1 file changed

+20
-20
lines changed

src/ng/directive/booleanAttrs.js

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -147,10 +147,10 @@
147147
* </div>
148148
* </pre>
149149
*
150-
* The HTML specs do not require browsers to preserve the values of special attributes
151-
* such as disabled. (The presence of them means true and absence means false)
152-
* This prevents the Angular compiler from correctly retrieving the binding expression.
153-
* To solve this problem, we introduce the `ngDisabled` directive.
150+
* The HTML specification does not require browsers to preserve the values of boolean attributes
151+
* such as disabled. (Their presence means true and their absence means false.)
152+
* This prevents the Angular compiler from retrieving the binding expression.
153+
* The `ngDisabled` directive solves this problem for the `disabled` attribute.
154154
*
155155
* @example
156156
<doc:example>
@@ -179,10 +179,10 @@
179179
* @restrict A
180180
*
181181
* @description
182-
* The HTML specs do not require browsers to preserve the special attributes such as checked.
183-
* (The presence of them means true and absence means false)
184-
* This prevents the angular compiler from correctly retrieving the binding expression.
185-
* To solve this problem, we introduce the `ngChecked` directive.
182+
* The HTML specification does not require browsers to preserve the values of boolean attributes
183+
* such as checked. (Their presence means true and their absence means false.)
184+
* This prevents the Angular compiler from retrieving the binding expression.
185+
* The `ngChecked` directive solves this problem for the `checked` attribute.
186186
* @example
187187
<doc:example>
188188
<doc:source>
@@ -210,10 +210,10 @@
210210
* @restrict A
211211
*
212212
* @description
213-
* The HTML specs do not require browsers to preserve the special attributes such as readonly.
214-
* (The presence of them means true and absence means false)
215-
* This prevents the angular compiler from correctly retrieving the binding expression.
216-
* To solve this problem, we introduce the `ngReadonly` directive.
213+
* The HTML specification does not require browsers to preserve the values of boolean attributes
214+
* such as readonly. (Their presence means true and their absence means false.)
215+
* This prevents the Angular compiler from retrieving the binding expression.
216+
* The `ngReadonly` directive solves this problem for the `readonly` attribute.
217217
* @example
218218
<doc:example>
219219
<doc:source>
@@ -241,10 +241,10 @@
241241
* @restrict A
242242
*
243243
* @description
244-
* The HTML specs do not require browsers to preserve the special attributes such as selected.
245-
* (The presence of them means true and absence means false)
246-
* This prevents the angular compiler from correctly retrieving the binding expression.
247-
* To solve this problem, we introduced the `ngSelected` directive.
244+
* The HTML specification does not require browsers to preserve the values of boolean attributes
245+
* such as selected. (Their presence means true and their absence means false.)
246+
* This prevents the Angular compiler from retrieving the binding expression.
247+
* The `ngSelected` directive solves this problem for the `selected` atttribute.
248248
* @example
249249
<doc:example>
250250
<doc:source>
@@ -274,10 +274,10 @@
274274
* @restrict A
275275
*
276276
* @description
277-
* The HTML specs do not require browsers to preserve the special attributes such as open.
278-
* (The presence of them means true and absence means false)
279-
* This prevents the angular compiler from correctly retrieving the binding expression.
280-
* To solve this problem, we introduce the `ngOpen` directive.
277+
* The HTML specification does not require browsers to preserve the values of boolean attributes
278+
* such as open. (Their presence means true and their absence means false.)
279+
* This prevents the Angular compiler from retrieving the binding expression.
280+
* The `ngOpen` directive solves this problem for the `open` attribute.
281281
*
282282
* @example
283283
<doc:example>

0 commit comments

Comments
 (0)