HTMLCollection - коллекия, содержащая елементы Elemnet

Доступ к эелементам коллекции может осуществляться как по индексу, так и по идентификатору элемента

class HTMLCollection

HTMLAllCollection

Коллекция всех элементов в дереве

class HTMLAllCollection

Наследник HTMLCollection

HTMLFormControlsCollection

Коллекция элементов форм

class HTMLFormControlsCollection

Наследник HTMLCollection

HTMLOptionsCollection

Коллекция элементов Option

class HTMLOptionsCollection

Наследник HTMLCollection

length

Воз­вра­ща­ет ко­ли­че­ст­во эле­мен­тов в кол­лек­ции. Од­на­ко, в от­ли­чие от свой­ст­ва length обыч­но­го объ­ек­та HTMLCollection, это свой­ст­во дос­туп­но не толь­ко для чте­ния. Ес­ли при­сво­ить ему зна­че­ние мень­ше те­ку­ще­го, кол­лек­ция эле­мен­тов Option бу­дет усе­че­на, а эле­мен­ты Option, ока­зав­шие­ся за пре­де­ла­ми кол­лек­ции, бу­дут уда­ле­ны из эле­мен­та Select. Ес­ли при­сво­ить свой­ст­ву length зна­че­ние боль­ше те­ку­ще­го, бу­дут соз­да­ны и до­бав­ле­ны в эле­мент Select и в кол­лек­цию но­вые пус­тые эле­мен­ты <option/>.

selectedIndex

Ин­декс пер­во­го вы­бран­но­го эле­мен­та Option в кол­лек­ции или –1, ес­ли ни один эле­мент Option не был вы­бран. Это свой­ст­во мож­но ис­поль­зо­вать, что­бы про­грамм­но вы­брать тре­буе­мый эле­мент.

add(Element option[, any before])

Встав­ля­ет эле­мент option (ко­то­рый дол­жен быть эле­мен­том <option> или <optgroup>) в дан­ную кол­лек­цию (и в эле­мент Select), в по­зи­цию, оп­ре­де­ляе­мую ар­гу­мен­том before. Ес­ли ар­гу­мент before име­ет зна­че­ние null, но­вый эле­мент встав­ля­ет­ся в ко­нец кол­лек­ции. Ес­ли ар­гу­мент before име­ет це­ло­чис­лен­ное зна­че­ние, но­вый эле­мент бу­дет встав­лен пе­ред эле­мен­том, ко­то­рый в те­ку­щий мо­мент име­ет этот ин­декс. Ес­ли пе­ре­дать в ар­гу­мен­те before дру­гой эле­мент Element, option бу­дет встав­ лен пе­ред этим эле­мен­том.

item(unsigned long index)

Объ­ект HTMLOptionsCollection на­сле­ду­ет этот ме­тод от HTMLCollection. Он воз­вра­ща­ет эле­мент Element с ин­дек­сом index или null, ес­ли ин­декс вы­хо­дит за гра­ни­цы кол­лек­ции.

Кол­лек­цию мож­но так­же ин­дек­си­ро­вать не­по­сред­ст­вен­но, ис­поль­зуя квад­рат­ные скоб­ки и не вы­зы­вая этот ме­тод яв­но.

namedItem(string name)

Воз­вра­ща­ет все эле­мен­ты Option из кол­лек­ции, имею­щие зна­че­ние name в ат­ри­бу­те id или name. Ес­ли эле­мен­ты с та­ким име­нем от­сут­ст­ву­ют, воз­вра­ща­ет­ся зна­че­ние null. Этот ме­тод мож­но не вы­зы­вать яв­но, а ука­зать имя в квад­рат­ных скоб­ках. Ес­ли за­дан­но­му име­ни со­от­вет­ст­ву­ет толь­ко один эле­мент Option, воз­вра­ща­ет­ся этот эле­мент. Ес­ли за­дан­но­му име­ни со­от­вет­ст­ву­ет бо­лее од­но­го эле­мен­та, воз­вра­ща­ет­ся объ­ект NodeList с эти­ми эле­мен­та­ми. Об­ра­ти­те вни­ма­ние, что объ­ек­ты HTML­OptionsCollection мож­но ин­дек­си­ро­вать не­по­сред­ст­вен­но, ис­поль­зуя зна­че­ние name как имя свой­ст­ва, вме­сто яв­но­го вы­зо­ва это­го ме­то­да.

remove(long index)

Уда­ля­ет из кол­лек­ции эле­мент <option> с ин­дек­сом index. При вы­зо­ве без ар­гу­мен­та или со зна­че­ни­ем ар­гу­мен­та, ко­то­рое вы­хо­дит за гра­ни­цы кол­лек­ции, мо­жет уда­лить пер­вый эле­мент кол­лек­ции.