Skip to content
This repository was archived by the owner on Apr 12, 2024. It is now read-only.

Commit 13d189a

Browse files
arturoromeroslcpetebacondarwin
authored andcommitted
docs(guide/Forms): add labels to input elements
Closes #15403
1 parent 30e7186 commit 13d189a

File tree

1 file changed

+32
-23
lines changed

1 file changed

+32
-23
lines changed

docs/content/guide/forms.ngdoc

Lines changed: 32 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -26,10 +26,10 @@ for other directives to augment its behavior.
2626
<file name="index.html">
2727
<div ng-controller="ExampleController">
2828
<form novalidate class="simple-form">
29-
Name: <input type="text" ng-model="user.name" /><br />
30-
E-mail: <input type="email" ng-model="user.email" /><br />
31-
Gender: <input type="radio" ng-model="user.gender" value="male" />male
32-
<input type="radio" ng-model="user.gender" value="female" />female<br />
29+
<label>Name: <input type="text" ng-model="user.name" /></label><br />
30+
<label>E-mail: <input type="email" ng-model="user.email" /></label><br />
31+
Gender: <label><input type="radio" ng-model="user.gender" value="male" />male</label>
32+
<label><input type="radio" ng-model="user.gender" value="female" />female</label><br />
3333
<input type="button" ng-click="reset()" value="Reset" />
3434
<input type="submit" ng-click="update(user)" value="Save" />
3535
</form>
@@ -88,10 +88,10 @@ and failing to satisfy its validity.
8888
<file name="index.html">
8989
<div ng-controller="ExampleController">
9090
<form novalidate class="css-form">
91-
Name: <input type="text" ng-model="user.name" required /><br />
92-
E-mail: <input type="email" ng-model="user.email" required /><br />
93-
Gender: <input type="radio" ng-model="user.gender" value="male" />male
94-
<input type="radio" ng-model="user.gender" value="female" />female<br />
91+
<label>Name: <input type="text" ng-model="user.name" required /></label><br />
92+
<label>E-mail: <input type="email" ng-model="user.email" required /></label><br />
93+
Gender: <label><input type="radio" ng-model="user.gender" value="male" />male</label>
94+
<label><input type="radio" ng-model="user.gender" value="female" />female</label><br />
9595
<input type="button" ng-click="reset()" value="Reset" />
9696
<input type="submit" ng-click="update(user)" value="Save" />
9797
</form>
@@ -154,28 +154,32 @@ didn't interact with a control
154154
<file name="index.html">
155155
<div ng-controller="ExampleController">
156156
<form name="form" class="css-form" novalidate>
157-
Name:
158-
<input type="text" ng-model="user.name" name="uName" required="" />
157+
<label>Name:
158+
<input type="text" ng-model="user.name" name="uName" required="" />
159+
</label>
159160
<br />
160161
<div ng-show="form.$submitted || form.uName.$touched">
161162
<div ng-show="form.uName.$error.required">Tell us your name.</div>
162163
</div>
163164

164-
E-mail:
165-
<input type="email" ng-model="user.email" name="uEmail" required="" />
165+
<label>E-mail:
166+
<input type="email" ng-model="user.email" name="uEmail" required="" />
167+
</label>
166168
<br />
167169
<div ng-show="form.$submitted || form.uEmail.$touched">
168170
<span ng-show="form.uEmail.$error.required">Tell us your email.</span>
169171
<span ng-show="form.uEmail.$error.email">This is not a valid email.</span>
170172
</div>
171173

172174
Gender:
173-
<input type="radio" ng-model="user.gender" value="male" />male
174-
<input type="radio" ng-model="user.gender" value="female" />female
175+
<label><input type="radio" ng-model="user.gender" value="male" />male</label>
176+
<label><input type="radio" ng-model="user.gender" value="female" />female</label>
175177
<br />
178+
<label>
176179
<input type="checkbox" ng-model="user.agree" name="userAgree" required="" />
177180

178181
I agree:
182+
</label>
179183
<input ng-show="user.agree" type="text" ng-model="user.agreeSign" required="" />
180184
<br />
181185
<div ng-show="form.$submitted || form.userAgree.$touched">
@@ -236,10 +240,11 @@ will update the model only when the control loses focus (blur event).
236240
<file name="index.html">
237241
<div ng-controller="ExampleController">
238242
<form>
239-
Name:
240-
<input type="text" ng-model="user.name" ng-model-options="{ updateOn: 'blur' }" /><br />
243+
<label>Name:
244+
<input type="text" ng-model="user.name" ng-model-options="{ updateOn: 'blur' }" /></label><br />
245+
<label>
241246
Other data:
242-
<input type="text" ng-model="user.data" /><br />
247+
<input type="text" ng-model="user.data" /></label><br />
243248
</form>
244249
<pre>username = "{{user.name}}"</pre>
245250
<pre>userdata = "{{user.data}}"</pre>
@@ -282,8 +287,8 @@ after last change.
282287
<file name="index.html">
283288
<div ng-controller="ExampleController">
284289
<form>
285-
Name:
286-
<input type="text" ng-model="user.name" ng-model-options="{ debounce: 250 }" /><br />
290+
<label>Name:
291+
<input type="text" ng-model="user.name" ng-model-options="{ debounce: 250 }" /></label><br />
287292
</form>
288293
<pre>username = "{{user.name}}"</pre>
289294
</div>
@@ -335,17 +340,19 @@ In the following example we create two directives:
335340
<file name="index.html">
336341
<form name="form" class="css-form" novalidate>
337342
<div>
343+
<label>
338344
Size (integer 0 - 10):
339345
<input type="number" ng-model="size" name="size"
340-
min="0" max="10" integer />{{size}}<br />
346+
min="0" max="10" integer />{{size}}</label><br />
341347
<span ng-show="form.size.$error.integer">The value is not a valid integer!</span>
342348
<span ng-show="form.size.$error.min || form.size.$error.max">
343349
The value must be in range 0 to 10!</span>
344350
</div>
345351

346352
<div>
353+
<label>
347354
Username:
348-
<input type="text" ng-model="name" name="name" username />{{name}}<br />
355+
<input type="text" ng-model="name" name="name" username />{{name}}</label><br />
349356
<span ng-show="form.name.$pending.username">Checking if this name is available...</span>
350357
<span ng-show="form.name.$error.username">This username is already taken!</span>
351358
</div>
@@ -425,8 +432,10 @@ Note that you can alternatively use `ng-pattern` to further restrict the validat
425432
<file name="index.html">
426433
<form name="form" class="css-form" novalidate>
427434
<div>
428-
Overwritten Email:
429-
<input type="email" ng-model="myEmail" overwrite-email name="overwrittenEmail" />
435+
<label>
436+
Overwritten Email:
437+
<input type="email" ng-model="myEmail" overwrite-email name="overwrittenEmail" />
438+
</label>
430439
<span ng-show="form.overwrittenEmail.$error.email">This email format is invalid!</span><br>
431440
Model: {{myEmail}}
432441
</div>

0 commit comments

Comments
 (0)