TEXTAREA | NN 2 IE 3 DOM 1 | ||||||
TEXTAREA отражает элемент HTML TEXTAREA и используется как элемент формы. Обратите внимание, что свойство innerHTML не доступно в версии Macintosh Internet Explorer 4. Общие свойства, методы и обработчики событий перечислены в разделе "Все злементы HTML" | |||||||
Эквивалент HTML
<TEXTAREA> | |||||||
Объектно-ориентированная модель
|
Свойства:
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. | |||
|
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. | |||
|
rows | NN n/a IE 4 DOM 1 | ||
Чтение/Изменение | |||
Высота элемента TEXTAREA, основанная на числе строк текста, которые могут быть отображены без прокрутки. Размер шрифта может быть под влиянием таблиц стилей, и фактическая высота измененяется соответственно. | |||
Пример:
document.forms[0].comments.rows = 6 | |||
Возвращаемое значение: Целое число. | |||
|
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. | |||
|
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. | |||
|
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. | |||
|
Методы:
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. | |||
Параметры
|
select() | NN 2 IE 3 DOM n/a |
Выбирает весь текст, отображенный в элементе формы. | |
Возвращаемое значение None. | |
Параметры None. |
Определённые обработчики событий:
HIVE: All information for read only. Please respect copyright! |