FormControl - общие особенности всех элементов форм

class FormControl
autofocus

Зна­че­ние true, ес­ли эле­мент дол­жен ав­то­ма­ти­че­ски по­лу­чать фо­кус вво­да сра­зу по­сле за­груз­ки до­ку­мен­та. (Эле­мен­ты FieldSet и Output не реа­ли­зу­ют это свой­ст­во.)

disabled

Зна­че­ние true, ес­ли эле­мент фор­мы на­хо­дит­ся в не­ак­тив­ном со­стоя­нии. Не­ак­тив­ные эле­мен­ты не от­кли­ка­ют­ся на ввод поль­зо­ва­те­ля и не под­вер­га­ют­ся про­вер­ке. (Эле­мен­ты Output не реа­ли­зу­ют это свой­ст­во; эле­мен­ты FieldSet ис­поль­зу­ют его для управ­ле­ния ак­тив­но­стью всех эле­мен­тов, со­дер­жа­щих­ся в них.)

form

Ссыл­ка на эле­мент Form, ко­то­рый яв­ля­ет­ся вла­дель­цем дан­но­го эле­мен­та, или null, ес­ли та­ко­вой от­сут­ст­ву­ет. Ес­ли эле­мент фор­мы на­хо­дит­ся внут­ри эле­мен­та <form>, эта фор­ма яв­ля­ет­ся его вла­дель­цем. В про­тив­ном слу­чае, ес­ли эле­мент фор­мы име­ет HTML-ат­ри­бут form, оп­ре­де­ляю­щий зна­че­ние ат­ри­бу­та id эле­мен­та <form>, вла­дель­цем эле­мен­та бу­дет ука­зан­ная фор­ма.

labels

Объ­ект NodeList, по­доб­ный мас­си­ву, со­дер­жа­щий эле­мен­ты Label, свя­зан­ные с эле­мен­та­ми этой фор­мы. (Объ­ек­ты FieldSet не реа­ли­зу­ют это свой­ст­во.)

name

Зна­че­ние HTML-ат­ри­бу­та name для дан­но­го эле­мен­та фор­мы. Име­на эле­мен­тов форм мож­но ис­поль­зо­вать в ка­че­ст­ве имен свойств эле­мен­та Form: зна­че­ния­ми та­ких свойств яв­ля­ют­ся эле­мен­ты форм. Име­на эле­мен­тов форм так­же мож­но ис­поль­зо­вать для иден­ти­фи­ка­ции дан­ных при от­прав­ке фор­мы.

onformchange

Ко­гда в лю­бом эле­мен­те фор­мы воз­бу­ж­да­ет­ся со­бы­тие «change», фор­ма рас­сы­ла­ет не­всплы­ваю­щее со­бы­тие «formchange» всем сво­им эле­мен­там. Эле­мен­ты форм мо­г ут ис­поль­зо­вать это свой­ст­во для оп­ре­де­ле­ния фак­та из­ме­не­ний в со­сед­них эле­мен­тах фор­мы.

onforminput

Ко­гда в лю­бом эле­мен­те фор­мы воз­бу­ж ­да­ет­ся со­бы­тие «input», фор­ма рас­сы­ла­ет не­всплы­ваю­щее со­бы­тие «forminput» всем сво­им эле­мен­там. Эле­мен­ты форм мо­гут ис­поль­зо­вать это свой­ст­во для оп­ре­де­ле­ния фак­та из­ме­не­ний в со­сед­них эле­мен­тах фор­мы.

oninvalid

Ес­ли в хо­де про­вер­ки вы­яс­нит­ся, что эле­мент фор­мы со­дер­жит не­ кор­рект­ные дан­ные, в нем бу­дет воз­бу­ж­де­но со­бы­тие «invalid». Это со­бы­тие не всплы­ва­ет, но ес­ли его от­ме­нить, бро­узер не вы­ве­дет со­об­ще­ние об ошиб­ке для это­го эле­мен­та.

type

Для эле­мен­тов <input> свой­ст­во type име­ет зна­че­ние ат­ри­бу­та type или зна­че­ние «text», ес­ли ат­ри­бут type не ука­зан в те­ге <input>. Для эле­мен­тов <button>, <select> и <text­area> свой­ст­во type име­ет зна­че­ние «button», «select-one» (или «select-mul­tip­le», ес­ли ус­та­нов­лен ат­ри­бут multiple) и «textarea», со­от­вет­ст­вен­но. Для эле­мен­тов <fieldset> свой­ст­во type име­ет зна­че­ние «fieldset», а для эле­мен­тов <output> – зна­че­ние «output».

validationMessage

Ес­ли эле­мент фор­мы со­дер­жит до­пус­ти­мые дан­ные или не под­вер­га­ет­ся про­вер­ке, это свой­ст­во бу­дет со­дер­жать пус­тую стро­ку. Ина­че это свой­ст­во бу­дет со­дер­жать ло­ка­ли­зо­ван­ную стро­ку, опи­сы­ваю­щую при­чи­ну, по ко­то­рой вве­ден­ные дан­ные при­зна­ны не­кор­рект­ны­ми.

validity

Это свой­ст­во ссы­ла­ет­ся на объ­ект FormValidity, ко­то­рый оп­ре­де­ля­ет кор­рект­ность да­ных в этом эле­мен­те фор­мы и опи­сы­ва­ет при­чи­ну, ес­ли дан­ные при­зна­ны не­кор­рект­ны­ми.

value

Ка­ж­дый эле­мент фор­мы име­ет стро­ко­вое свой­ст­во value, ко­то­рое ис­поль­зу­ет­ся при от­прав­ке фор­мы. Для тек­сто­вых эле­мен­тов форм зна­че­ни­ем это­го свой­ст­ва яв­ля­ет­ся текст, вве­ден­ный поль­зо­ва­те­лем. Для кно­пок – зна­че­ние HTML-ат­ри­бу­та value. Для эле­мен­тов Output это свой­ст­во по­доб­но свой­ст­ву textContent, унас­ле­до­ван­но­му от объ­ек­та Node. Эле­мен­ты FieldSet не реа­ли­зу­ют это свой­ст­во.

willValidate

Это свой­ст­во име­ет зна­че­ние true, ес­ли эле­мент фор­мы под­вер­га­ет­ся про­вер­ке, и false – в про­тив­ном слу­чае.

checkValidity()

Воз­вра­ща­ет true, ес­ли эле­мент фор­мы со­дер­жит кор­рект­ные дан­ные (или ес­ли этот эле­мент не под­вер­га­ет­ся про­вер­ке). Ина­че воз­бу­ж­да­ет со­бы­тие «invalid» в дан­ном эле­мен­те и воз­вра­ща­ет false.

setCustomValidity(string error)

Ес­ли в ар­гу­мен­те error пе­ре­дать не­пус­тую стро­ку, этот ме­тод по­ме­тит дан­ный эле­мент фор­мы как со­дер­жа­щий не­до­пус­ти­мые дан­ные и бу­дет ис­поль­зо­вать ар­гу­мент error как ло­ка­ли­зо­ван­ное со­об­ще­ние, что­бы из­вес­тить поль­зо­ва­те­ля о при­чи­нах. Ес­ли пе­ре­дать в ар­гу­мен­те error пус­тую стро­ку, все пре­ды­ду­щие стро­ки error бу­дут уда­ле­ны, а объ­ект бу­дет по­ме­чен как со­дер­жа­щий до­пус­ти­мые дан­ные.