TEXTAREA NN 2   IE 3   DOM 1

TEXTAREA отражает элемент HTML TEXTAREA и используется как элемент формы. Обратите внимание, что свойство innerHTML не доступно в версии Macintosh Internet Explorer 4.

Общие свойства, методы и обработчики событий перечислены в разделе "Все злементы HTML"

 
Эквивалент HTML

<TEXTAREA>

 
Объектно-ориентированная модель
NN [window.]document.formName.elementName
[window.]document.forms[i].elements[i]
NN 6/IE5+ [window.]document.getElementById("elementID")
IE [window.]document.formName.elementName
[window.]document.forms[i].elements[i]
[window.]document.all.elementID

Свойства:


accessKey NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

Отдельная клавиша клавиатуры, которая передаёт фокус элементу. Браузер и операционная система определяют, должен ли пользователь нажать клавишу-модификатор (например, Ctrl, Alt, или Команду) вместе с клавишей доступа, чтобы передать фокус элементу. В IE 4/Windows требуется клавиша Alt , и она не чувствительна к регистру. Не работает в IE 4/Mac.

 
Пример:

document.entryForm.myTextArea.accessKey = "n"

 
Возвращаемое значение:
Отдельный алфавитно-цифровой или пунктуационный символ клавиатуры.
 
Значение по умолчанию: Ничего.

clientHeight, clientWidth NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

Согласно документации Microsoft, эти свойства отражают высоту и ширину элемента (в пикселах).

 
Пример:

var midHeight = document.forms[0].myTextArea.clientHeight/2

 
Возвращаемое значение:
Целое число в пикселах.
 
Значение по умолчанию: Ничего.

clientLeft, clientTop NN n/a  IE 4   DOM n/a
 Только чтение
 

Согласно документации Microsoft, эти свойства отражают расстояние между "настоящими" левой и верхней гранями документа. Чтобы получить или установить расстояние в пикселах, используйте pixelLeft и pixelTop свойства.

 
Возвращаемое значение:
Строковое значение для длины в различных единицах или процентах.
 
Значение по умолчанию: Ничего.

cols NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

Ширина доступного для редактирования пространства элемента TEXTAREA. Значение представляет число символов, которые могут быть отображены в пределах ширины. Когда размер шрифта под влиянием таблиц стилей, ширина изменяется соответственно.

 
Пример:

document.forms[0].comments.cols = 60

 
Возвращаемое значение:
Положительное целое число.
 
Значение по умолчанию: В зависимости от браузера и операционной системы.

dataFld NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

Используется с IE 4 для закрепления данных to associate a remote data source column name to a TEXTAREA object's value property. Атрибут dataSrc уже должен быть установлен для элемента. Одновременная установка свойств и dataFld, и dataSrc для пустых строк нарушает закрепление между источником данных и элементом

 
Пример:

document.myForm.myTextArea.dataFld = "linkURL"

 
Возвращаемое значение:
Чувствительный к регистру идентификатор столбца источника данных
 
Значение по умолчанию: Ничего.

dataSrc NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

Используется с IE 4 для закрепления данных, чтобы связать имя удаленного источника данных ODBC (типа Oracle или SQL Server database) с элементом. Содержание из источника данных определено через атрибут dataFld. Одновременная установка свойств и dataFld, и dataSrc для пустых строк нарушает закрепление между источником данных и элементом.

 
Пример:

document.myForm.myTextArea.dataSrc = "#DBSRC3"

 
Возвращаемое значение:
Чувствительный к регистру идентификатор источника данных.
 
Значение по умолчанию: Ничего.

defaultValue NN 2   IE 3   DOM 1
 Только чтение
 

Заданный по умолчанию текст для элемента TEXTAREA, установленный атрибутом VALUE.

 
Пример:

var txtAObj = document.forms[0].myTextArea if (txtAObj.value != txtAObj.defaultValue ) { ... }

 
Возвращаемое значение:
Любое строковое значение.
 
Значение по умолчанию: Ничего.

disabled NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

Является ли элемент доступным для взаимодействия с пользователем. Когда установлено true, элемент не может получать фокус или изменяться пользователем. Это никак не связано с формой.

 
Пример:

document.forms[0].myTextArea.disabled = true

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: false

form NN 2   IE 3   DOM n/a
 Только чтение
 

Возвращает ссылку на элемент FORM, который содержит текущий элемент. Эту ссылку наиболее часто используют как параметр для обработчика события, используя её значение, чтобы обратиться к текущему элементу формы.

 
Пример:

<TEXTAREA NAME="comment" onChange="doValidate(this.form)">

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: Ничего.

name NN 2   IE 3   DOM 1
 Чтение/Изменение
 

Идентификатор, связанный с элементом формы. Значение этого свойства представляется как половина пары "имя/значение", когда форма отправляется на сервер. Имена скрыты от пользователя, так как метки элемента назначены через другие средства в зависимости от типа элемента. Имена элементов формы могут также использоваться ссылками сценария на эти объекты. Обработка переводов каретки внутри элемента управляется установкой свойства wrap.

 
Пример:

document.orderForm.myTextArea.name = "Win32"

 
Возвращаемое значение:
Чувствительный к регистру идентификатор, который подчиняется правилам именования: не может содержать никаких пробелов, не может начинаться с цифры и не должен содержать пунктуационных символов кроме символа подчеркивания.
 
Значение по умолчанию: Ничего.

readOnly NN n/a  IE 4   DOM n/a
 Только чтение
 

Может ли элемент формы быть отредактирован пользователем на странице. Элемент формы, чьё свойство readOnly true, все еще может изменяться сценариями, даже при том, что пользователь не может изменять содержание.

 
Пример:

document.forms[0].myTextArea.readOnly = "true"

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: false

rows NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

Высота элемента TEXTAREA, основанная на числе строк текста, которые могут быть отображены без прокрутки. Размер шрифта может быть под влиянием таблиц стилей, и фактическая высота измененяется соответственно.

 
Пример:

document.forms[0].comments.rows = 6

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: 2 (IE 4/Windows); 4 (IE 4/Macintosh).

scrollHeight, scrollWidth NN n/a  IE 4   DOM n/a
 Только чтение
 

Описание этих двух свойств неоднозначно. Оно основано на документации Microsoft. Неоднозначны и способы реализации в версиях Windows и Macintosh Internet Explorer 4. Мое предположение, что эти свойства предназначены для того, чтобы измерить высоту и ширину элемента "полоса прокрутки" (в пикселах), даже когда часть страницы не видна и может быть не замечена. Версия Macintosh интерпретирует свойство, подразумевая содержание страницы, которое Вы можете видеть в любой момент. Важный пункт - то, что для ключевых элементов, типа BODY, свойства означают различные вещи и могут разрушать межплатформенную совместимость.

 
Пример:

var midPoint = document.all.myTextArea.scrollHeight/2

 
Возвращаемое значение:
Целое положительное число или 0.
 
Значение по умолчанию: Ничего.

scrollLeft, scrollTop NN n/a  IE 4   DOM n/a
 Чтение/Изменение
 

Расстояние в пикселах между левым или верхним краем элемента и фактическим содержанем элемента. Установка этих свойств позволяет Вам использовать сценарий, чтобы корректировать прокрутку содержания в пределах прокручиваемого контейнера, типа текста в TEXTAREA элементе или полного документа в окне броузера или фрейме. Когда содержание не пролистано, оба значения нулевые. Установка scrollTop свойства как 15 прокручивает документ вверх в окне на 15 пикселов ; свойство scrollLeft равно 0, если явно не изменено. Изменение значений свойства похоже на прокручивание содержимого пользователем.

 
Пример:

document.all.myTextArea.scrollTop = 40

 
Возвращаемое значение:
Целое положительное число или 0.
 
Значение по умолчанию: 0

tabIndex NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

Номер, который указывает последовательность этого элемента в пределах порядка размещения всех форматируемых элементов в документе. Порядок форматирования строго подчиняется набору правил. Элементы, которые имеют отличные от нуля значения свойства tabIndex, находятся первые в строке, когда пользователь начинает форматирование страницы. Отсчёт начинается с элемента с самым низким значением tabIndex и заканчивается самым высоким значением, независимо от физического местоположения объекта на странице или в документе. Если два элемента имеют одни и те же значения tabIndex, элемент, который загружается в документ раньше , получает фокус первым. Затем идут все элементы что, или не поддерживающие свойство tabIndex , или имеющие нулевое значение. Эти элементы получают фокус в том порядке, в котором они загружаются в документ. Значение -1 ,в целом, удаляет элемент из порядка форматирования.

Обратите внимание, что интерфейс Macintosh не обеспечивает предоставление фокуса элементам, отличным от text и password поля INPUT.

 
Пример:

document.forms[0].myTextArea.tabIndex = 6

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего.

type NN 3   IE 4   DOM 1
 Только чтение
 

Возвращает тип элемента формы. Значение возвращается в символах нижнего регистра. Может быть необходимо циклически перебрать все элементы формы в поиске определенных типов, чтобы сделать некоторую обработку (например, освобождение всех элементов управления формы "text" при оставлении других элементов нетронутыми).

 
Пример:

if (document.forms[0].elements[3].type == "textarea") { ... }

 
Возвращаемое значение:
Любая из следующих констант (как строка): button | checkbox | file | hidden | image | password | radio | reset | select-multiple | select-one | submit | text | textarea.
 
Значение по умолчанию: textarea

value NN 2   IE 3   DOM 1
 Чтение/Изменение
 

Текущее значение, связанное с элементом формы, который представлен парой "имя/значение" для элемента. Все значения - строки.

 
Пример:

var comment = document.forms[0].myTextArea.value

 
Возвращаемое значение: Строка.
 
Значение по умолчанию: Ничего.

wrap NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

Должен ли браузер переносить по словам текст в элементе TEXTAREA и должны ли быть включены в текст, представленный серверу, символы возврата каретки. Значение physical означает переходы на новую строку и конвертирует символы возврата каретки в символы CR-LF в значении, отправляемом на сервер. Значение virtual означает переходы на новую строку, но не включает символы CR-LF в текст, представляемый с формой. Значение off не переводит на новую строку.

 
Пример:

document.forms[0].comments.wrap = "wrap"

 
Возвращаемое значение:
Одно из постоянных значений (как строка): physical | off | virtual.
 
Значение по умолчанию: off

Методы:


blur( ) NN 2   IE 3   DOM n/a

Удаляет фокус из текущего элемента и обрабатывает событие onBlur (в IE). Никакой другой элемент в результате не получает фокус (обязательно).

 
Возвращаемое значение
None.
 
Параметры
None.

createTextRange( ) NN n/a  IE 4   DOM n/a

Создает объект TextRange из содержания объекта TEXTAREA. См. для подробностей объект TextRange.

 
Возвращаемое значение
Объект TextRange

focus( ) NN 2   IE 3   DOM n/a

Дает фокус текущему элементу и обрабатывает событие onFocus (в IE). Если другой элемент имел фокус в то время, он получает событие onBlur.

 
Возвращаемое значение
None.
 
Параметры
None.

handleEvent( ) NN 4   IE n/a  DOM n/a

handleEvent(event)

Инструктирует объект обрабатывать событие, чья спецификация представлена как параметр для метода. Объект должен иметь обработчик события для типа события, чтобы обработать его.

 
Возвращаемое значение
None.
 
Параметры
event Объекты событий Navigator 4

select() NN 2   IE 3   DOM n/a

Выбирает весь текст, отображенный в элементе формы.

 
Возвращаемое значение
None.
 
Параметры
None.

Определённые обработчики событий:



HIVE: All information for read only. Please respect copyright!
Hosted by hive КГБ: Киевская городская библиотека