Оглавление | Назад | Вперёд | Индекс

document

Содержит информацию о текущем документе и предоставляет методы для отображения HTML-вывода пользователю.

Клиентский объект

Реализован в

JavaScript 1.0

JavaScript 1.1: добавлен синтаксис onBlur и onFocus; добавлены свойства applets, domain, embeds, forms, formName , images и plugins.

JavaScript 1.2: добавлены свойства classes, ids, layers и tags; добавлены методы captureEvents, contextual, getSelection, handleEvent, releaseEvents и routeEvent.

Создание

HTML-тэгом BODY. Машина выполнения JavaScript создаёт объект document для каждой HTML-страницы. Каждый объект window имеет свойство document, значением которого является объект document.

Для определения объекта document используйте стандартный синтаксис HTML для тэга BODY с дополнением обработчиками событий JavaScript.

Обработчики событий

Обработчики событий  onBlur, onFocus, onLoad и onUnload специфицируются в тэге BODY, но реально являются обработчиками событий объекта window. Вот обработчики событий объекта document:

Описание

Документ HTML состоит из тэгов HEAD и BODY. Тэг HEAD содержит информацию о заголовке и базе документа (абсолютном базовом URL, используемом для разрешения относительных URL-гиперссылок данного документа). Тэг BODY содержит тело документа, которое определяется текущим URL. Всё тело документа (все остальные элементы HTML данного документа) находится внутри тэгов BODY.

Вы можете загружать новый документ, устанавливая свойство window.location.

Вы можете очистить панель документа (и удалить текст, элементы формы и т.д., и они не будут больше отображаться) с помощью таких операторов:

document.close();
document.open();
document.write();

Можно опустить вызов document.open, если Вы пишете текст или HTML, поскольку write выполняет неявное открытие MIME-типа, если поток документа закрывается.

Вы можете обращаться к якорям/anchors, формам/forms и ссылкам/ links документа, используя массивы anchors, forms и links. Эти массивы содержат вхождения для каждого якоря, формы или ссылки документа и являются свойствами объекта document.

Не используйте location как свойство объекта document; используйте вместо него свойство document.URL. Свойство document.location, которое является синонимом свойства document.URL, не рекомендуется применять.

Свойства. Резюме.

Свойство Описание
alinkColor

Строка, специфицирующая атрибут ALINK.

anchors

Массив, содержащий вхождение каждого якоря документа.

applets

Массив, содержащий вхождение каждого аплета документа.

bgColor

Строка, специфицирующая атрибут BGCOLOR.

classes

Создаёт объект Style, который может специфицировать стили тэгов HTML с атрибутом CLASS.

cookie

Специфицирует куку.

domain

Специфицирует имя домена сервера, обслужившего документ.

embeds

Массив, содержащий вхождение каждого plug-in документа.

fgColor

Строка, специфицирующая атрибут TEXT.

formName

Отдельное свойство для каждой именованной формы документа.

forms

Массив, содержащий вхождение каждой формы документа.

height

Высота документа в пикселах.

ids

Создаёт объект Style, который может специфицировать стиль отдельных тэгов HTML.

images

Массив, содержащий вхождение каждого изображения документа.

lastModified

Строка, специфицирующая дату последнего изменения документа.

layers

Массив, содержащий вхождение каждого слоя документа.

linkColor

Строка, специфицирующая атрибут LINK.

links

Массив, содержащий вхождение каждой гиперссылки документа.

plugins

Массив, содержащий вхождение каждого plug-in документа.

referrer

Строка, специфицирующая URL вызывающего документа.

tags

Создаёт объект Style, который может специфицировать стили тэгов HTML.

title

Строка, специфицирующая содержимое тэга TITLE.

URL

Строка, специфицирующая полный URL документа.

vlinkColor

Строка, специфицирующая атрибут VLINK.

width

Ширина документа в пикселах.

Методы. Резюме.

Метод Описание
captureEvents

Устанавливает захват документом всех событий специфицированного типа.

close

Закрывает поток вывода и форсирует отображение данных.

contextual

Использует контекстуальный отбор по критериям специфицирования объекта Style, который может устанавливать стиль отдельных тэгов HTML.

getSelection

Возвращает строку, содержащую текущий выбранный текст.

handleEvent

Вызывает обработчик специфицированного события.

open

Открывает поток сбора вывода методов write или writeln.

releaseEvents

Устанавливает освобождение объектами window или document захваченных событий специфицированного типа.

routeEvent

Передаёт захваченное событие по иерархии нормальных событий.

write

Записывает одно или более выражений HTML в документ в специфицированном окне.

writeln

Записывает одно или более выражений HTML и символ новой строки в документ в специфицированном окне.

Помимо этого, данный объект наследует методы watch и unwatch объекта Object.

Примеры

Следующий пример создаёт два фрэйма, каждый с одним документом. Документ первого фрэйма содержит ссылки на якоря в документе второго фрэйма. Каждый документ определяет свой цвет.

doc0.html, который определяет фрэймы, содержит следующий код:

<HTML>
<HEAD>
<TITLE>Document object example</TITLE>
</HEAD>
<FRAMESET COLS="30%,70%">
<FRAME SRC="doc1.html" NAME="frame1">
<FRAME SRC="doc2.html" NAME="frame2">
</FRAMESET>
</HTML>

doc1.html, который определяет содержимое первого фрэйма, содержит следующий код:

<HTML>
<SCRIPT>
</SCRIPT>
<BODY
   BGCOLOR="antiquewhite"
   TEXT="darkviolet"
   LINK="fuchsia"
   ALINK="forestgreen"
   VLINK="navy">
<P><B>Some links</B>
<LI><A HREF="doc2.html#numbers" TARGET="frame2">Numbers</A>
<LI><A HREF="doc2.html#colors" TARGET="frame2">Colors</A>
<LI><A HREF="doc2.html#musicTypes" TARGET="frame2">Music types</A>
<LI><A HREF="doc2.html#countries" TARGET="frame2">Countries</A>
</BODY>
</HTML>

doc2.html, который определяет содержимое второго фрэйма, содержит следующий код:

<HTML>
<SCRIPT>
</SCRIPT>
<BODY
   BGCOLOR="oldlace" onLoad="alert('Hello, World.')"
   TEXT="navy">
<P><A NAME="numbers"><B>Some numbers</B></A>
<UL><LI>one
<LI>two
<LI>three
<LI>four</UL>
<P><A NAME="colors"><B>Some colors</B></A>
<UL><LI>red
<LI>orange
<LI>yellow
<LI>green</UL>
<P><A NAME="musicTypes"><B>Some music types</B></A>
<UL><LI>R&B
<LI>Jazz
<LI>Soul
<LI>Reggae</UL>
<P><A NAME="countries"><B>Some countries</B></A>
<UL><LI>Afghanistan
<LI>Brazil
<LI>Canada
<LI>Finland</UL>
</BODY>
</HTML>

См. также

Frame, window

alinkColor


Строка, специфицирующая цвет активной гиперссылки (после нажатия кнопки мыши, но до её отпускания).

Свойство из

document

Реализовано в

JavaScript 1.0

Описание

Свойство alinkColor выражается как 16-ричный триплет RGB или как строковой литерал (см. книгу Клиентский JavaScript. Руководство.). Это свойство является отражением в JavaScript атрибута ALINK тэга BODY.

Если Вы выводите цвет как 16-ричный триплет RGB, Вы обязаны использовать формат rrggbb. Например, 16-ричное значение RGB цвета salmon будет red=FA, green=80 и blue=72, так что RGB-триплет для salmon будет "FA8072".

Примеры

В этом примере устанавливается цвет активной гиперссылки с использованием строкового литерала:

document.alinkColor="aqua"

Здесь устанавливается цвет активной ссылки aqua с использованием 16-ричного триплета:

document.alinkColor="00FFFF"

См. также

document.bgColor, document.fgColor, document.linkColor, document.vlinkColor

anchors


Массив объектов, соответствующих именованным якорям в порядке размещения в исходном коде.

Свойство из

document

Только для чтения

Реализовано в

JavaScript 1.0

Описание

Вы можете обращаться к объектам Anchor в Вашем коде, используя массив anchors. Этот массив содержит вхождение для каждого тэга A, имеющегp" class="propindex" height="40"><border-width> | inherit medium нет N/A [7.29.7 "border-right"] [ <border-width> || <border-style> || <color> ] | inherit см. конкретные свойстванет N/A [7.7.28 "border-right-color"] <color> | inherit значение свойства 'color' нет N/A [7.7.29 "border-right-style"] <border-style> | inherit нет нет N/A [7.7.30 "border-right-width"] <border-width> | inherit medium нет N/A [7.26.5 "border-separation"] <length-bp-ip-direction> | inherit .block-progression-direction="0pt" .inline-progression-direction="0pt" да N/A [7.29.9 "border-spacing"] <length> <length>? | inherit 0pt да N/A [7.7.13 "border-start-color"] <color> | inherit значение свойства 'color' нет N/A [7.26.6 "border-start-precedence"] force | <integer> | inherit fo:table: 5, fo:table-cell: 4, fo:table-row: 3, fo:table-body: 2, fo:table-header: 1, fo:table-footer: 0 нет N/A [7.7.14 "border-start-style"] <border-style> | inherit нет нет N/A [7.7.15 "border-start-width"] <border-width> | <length-conditional> | inherit medium нет N/A [7.29.8 "border-style"] <border-style>{1,4} | inherit см. конкретные свойства нет N/A [7.29.10 "border-top"] [ <border-width> || <border-style> || <color> ] | inherit см. конкретные свойстванет N/A [7.7.19 "border-top-color"] <color> | inherit значение свойства 'color' нет N/A [7.7.20 "border-top-style"] <border-style> | inherit нет нет N/A [7.7.21 "border-top-width"] <border-width> | inherit medium нет N/A [7.29.11 "border-width"] <border-width>{1,4} | inherit см. конкретные свойства нет N/A [7.5.4 "bottom"] <length> | <percentage> | auto | inherit auto нет относительно высоты содержащего блока [7.19.1 "break-after"] auto | column | page | even-page | odd-page | inherit auto нет N/A [7.19.2 "break-before"] auto | column | page | even-page | odd-page | inherit auto нет N/A [7.26.7 "caption-side"] before | after | start | end | top | bottom | left | right | inherit before да N/A [7.22.3 "case-name"] <name> нет, значение необходимо нет, значение необходимо N/A [7.22.4 "case-title"] <string> нет, значение необходимо нет, значение необходимо N/A [7.16.1 "character"] <character> N/A, значение необходимо нет, значение необходимо N/A [7.18.1 "clear"] start | end | left | right | both | none | inherit none нет N/A [7.20.1 "clip"] <shape> | auto | inherit auto нет N/A [7.17.1 "color"] <color> | inherit зависит от пользовательского агента (ПА)да N/A [7.17.2 "color-profile-name"] <name> | inherit N/A, значение необходимо нет N/A [7.25.2 "column-count"] <number> | inherit 1 нет N/A [7.25.3 "column-gap"] <length> | <percentage> | inherit 12.0pt нет относительно ширины области, разделённой на столбцы [7.26.8 "column-number"] <number> см. текст нет N/A [7.26.9 "column-width"] <length> | <percentage> см. текст нет относительно ширины таблицы [7.14.2 "content-height"] auto | scale-to-fit | <length> | <percentage> | inherit auto нет собственная высота [7.28.1 "content-type"] <string> | auto auto нет N/A [7.14.3 "content-width"] auto | scale-to-fit | <length> | <percentage> | inherit auto нет собственная ширина [7.9.1 "country"] none | <country> | inherit none да N/A [7.29.12 "cue"] <cue-before> || <cue-after> | inherit не определено для свойств shorthand нет N/A [7.6.2 "cue-after"] <uri-specification> | none | inherit none нет N/A [7.6.3 "cue-before"] <uri-specification> | none | inherit none нет N/A [7.22.5 "destination-placement-offset"] <length> 0pt нет N/A [7.27.1 "direction"] ltr | rtl | inherit ltr да N/A [7.13.4 "display-align"] auto | before | center | after | inheritauto да N/A [7.13.5 "dominant-baseline"] auto | use-script | no-change | reset-size | ideographic | alphabetic | hanging | mathematical | central | middle | text-after-edge | text-before-edge | inheritauto нет N/A [7.6.4 "elevation"] <angle> | below | level | above | higher | lower | inheritlevel да N/A [7.26.10 "empty-cells"] show | hide | inherit show да N/A [7.10.8 "end-indent"] <length> | <percentage> | inherit 0pt да относительно inline-progression-dimension (размера инлайн-прогрессии) содержащей reference-area (области ссылки) [7.26.11 "ends-row"] true | false false нет N/A [7.25.4 "extent"] <length> | <percentage> | inherit 0.0pt нет относительно соответствующей высоты или ширины области reference-area [7.22.6 "external-destination"] <uri-specification> пустая строка нет N/A [7.18.2 "float"] before | start | end | left | right | none | inherit none нет N/A [7.25.5 "flow-name"] <name> пустое имя нет, значение необходимо N/A [7.29.13 "font"] [ [ <font-style> || <font-variant> || <font-weight> ]? <font-size> [ / <line-height>]? <font-family> ] | caption | icon | menu | message-box | small-caption | status-bar | inheritсм. конкретные свойствада N/A [7.8.2 "font-family"] [[ <family-name> | <generic-family> ],]* [<family-name> | <generic-family>] | inherit зависит от пользовательского агента (ПА)да N/A [7.8.3 "font-selection-strategy"] auto | character-by-character | inherit auto да N/A [7.8.4 "font-size"] <absolute-size> | <relative-size> | <length> | <percentage> | inherit medium да, вычисленное значение наследуетсяотносительно размера шрифта элемента-предка [7.8.6 "font-size-adjust"] <number> | none | inherit none да N/A [7.8.5 "font-stretch"] normal | wider | narrower | ultra-condensed | extra-condensed | condensed | semi-condensed | semi-expanded | expanded | extra-expanded | ultra-expanded | inherit normal да N/A [7.8.7 "font-style"] normal | italic | oblique | backslant | inherit normal да N/A [7.8.8 "font-variant"] normal | small-caps | inherit normal да N/A [7.8.9 "font-weight"] normal | bold | bolder | lighter | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | inherit normal да N/A [7.25.6 "force-page-count"] auto | even | odd | end-on-even | end-on-odd | no-force | inheritauto нет N/A [7.24.1 "format"] <string> 1 нет N/A [7.27.2 "glyph-orientation-horizontal"] <angle> | inherit 0deg да N/A [7.27.3 "glyph-orientation-vertical"] auto | <angle> | inherit auto да N/A [7.24.2 "grouping-separator"] <character> нет separator нет N/A [7.24.3 "grouping-size"] <number> нет grouping нет N/A [7.14.4 "height"] <length> | <percentage> | auto | inherit auto нет см. текст [7.9.4 "hyphenate"] false | true | inherit false да N/A [7.9.5 "hyphenation-character"] <character> | inherit Символ дефиса Unicode U+2010 да N/A [7.15.1 "hyphenation-keep"] auto | column | page | inherit auto да N/A [7.15.2 "hyphenation-ladder-count"] no-limit | <number> | inherit no-limit да N/A [7.9.6 "hyphenation-push-character-count"] <number> | inherit 2 да N/A [7.9.7 "hyphenation-remain-character-count"] <number> | inherit 2 да N/A [7.28.2 "id"] <id> см. текст нет, см. текст N/A [7.22.7 "indicate-destination"] true | false false нет N/A [7.25.7 "initial-page-number"] auto | auto-odd | auto-even | <number> | inherit auto нет N/A [7.14.5 "inline-progression-dimension"] auto | <length> | <percentage> | <length-range> | inheritauto нет см. текст [7.22.8 "internal-destination"] empty string | <idref> empty string/пустая строка нет N/A [7.18.3 "intrusion-displace"] auto | none | line | indent | block | inherit auto да N/A [7.19.3 "keep-together"] <keep> | inherit .within-line=auto, .within-column=auto, .within-page=auto да N/A [7.19.4 "keep-with-next"] <keep> | inherit .within-line=auto, .within-column=auto, .within-page=auto нет N/A [7.19.5 "keep-with-previous"] <keep> | inherit .within-line=auto, .within-column=auto, .within-page=auto нет N/A [7.9.2 "language"] none | <language> | inherit none да N/A [7.15.3 "last-line-end-indent"] <length> | <percentage> | inherit 0pt да относительно inline-progression-dimension ближайшего родительского block-area, который не является line-area [7.21.1 "leader-alignment"] none | reference-area | page | inherit none да N/A [7.21.4 "leader-length"] <length-range> | <percentage> | inherit leader-length.minimum=0pt, .optimum=12.0pt, .maximum=100% да относительно ширины content-rectangle родительской области [7.21.2 "leader-pattern"] space | rule | dots | use-content | inherit space да N/A [7.21.3 "leader-pattern-width"] use-font-metrics | <length> | <percentage> | inherit use-font-metrics да относительно ширины содержащего блока [7.5.5 "left"] <length> | <percentage> | auto | inherit auto нет относительно высоты содержащего блока [7.16.2 "letter-spacing"] normal | <length> | <space> | inherit normal да N/A [7.24.4 "letter-value"] auto | alphabetic | traditional auto нет N/A [7.15.7 "linefeed-treatment"] ignore | preserve | treat-as-space | treat-as-zero-width-space | inherit treat-as-space да N/A [7.15.4 "line-height"] normal | <length> | <number> | <percentage> | <space> | inheritnormal да относительно размера шрифта самого элемента [7.15.5 "line-height-shift-adjustment"] consider-shifts | disregard-shifts | inherit consider-shifts да N/A [7.15.6 "line-stacking-strategy"] line-height | font-height | max-height | inherit max-height да N/A [7.29.14 "margin"] <margin-width>{1,4} | inherit не определено для сокращённых свойств нет относительно ширины содержащего блока [7.10.2 "margin-bottom"] <margin-width> | inherit 0 нет относительно ширины содержащего блока [7.10.3 "margin-left"] <margin-width> | inherit 0pt нет относительно ширины содержащего блока [7.10.4 "margin-right"] <margin-width> | inherit 0pt нет относительно ширины содержащего блока [7.10.1 "margin-top"] <margin-width> | inherit 0 нет относительно ширины содержащего блока [7.23.1 "marker-class-name"] <name> пустое имя нет, значение необходимо N/A [7.25.8 "master-name"] <name> пустое имя нет, значение необходимо N/A [7.25.9 "master-reference"] <name> пустое имя нет, значение необходимо N/A [7.14.6 "max-height"] <length> | <percentage> | none | inherit 0pt нет относительно высоты содержащего блока [7.25.10 "maximum-repeats"] <number> | no-limit | inherit no-limit нет N/A [7.14.7 "max-width"] <length> | <percentage> | none | inherit none нет относительно ширины содержащего блока [7.25.11 "media-usage"] auto | paginate | bounded-in-one-dimension | unbounded auto нет N/A [7.14.8 "min-height"] <length> | <percentage> | inherit 0pt нет относительно высоты содержащего блока [7.14.9 "min-width"] <length> | <percentage> | inherit зависит от ПА нет относительно ширины содержащего блока [7.26.12 "number-columns-repeated"] <number> 1 нет N/A [7.26.13 "number-columns-spanned"] <number> 1 нет N/A [7.26.14 "number-rows-spanned"] <number> 1 нет N/A [7.25.12 "odd-or-even"] odd | even | any | inherit any нет N/A [7.19.6 "orphans"] <integer> | inherit 2 да N/A [7.20.2 "overflow"] visible | hidden | scroll | error-if-overflow | auto | inherit auto нет N/A [7.29.15 "padding"] <padding-width>{1,4} | inherit не определено для сокращённых свойств нет относительно ширины содержащего блока [7.7.32 "padding-after"] <padding-width> | <length-conditional> | inherit 0pt нет относительно ширины содержащего блока [7.7.31 "padding-before"] <padding-width> | <length-conditional> | inherit 0pt нет относительно ширины содержащего блока [7.7.36 "padding-bottom"] <padding-width> | inherit 0pt нет относительно ширины содержащего блока [7.7.34 "padding-end"] <padding-width> | <length-conditional> | inherit 0pt нет относительно ширины содержащего блока [7.7.37 "padding-left"] <padding-width> | inherit 0pt нет относительно ширины содержащего блока [7.7.38 "padding-right"] <padding-width> | inherit 0pt нет относительно ширины содержащего блока [7.7.33 "padding-start"] <padding-width> | <length-conditional> | inherit 0pt нет относительно ширины содержащего блока [7.7.35 "padding-top"] <padding-width> | inherit 0pt нет относительно ширины содержащего блока [7.29.16 "page-break-after"] auto | always | avoid | left | right | inherit auto нет N/A [7.29.17 "page-break-before"] auto | always | avoid | left | right | inherit auto нет N/A [7.29.18 "page-break-inside"] avoid | auto | inherit auto да N/A [7.25.13 "page-height"] auto | indefinite | <length> | inherit auto нет N/A [7.25.14 "page-position"] first | last | rest | any | inherit any нет N/A [7.25.15 "page-width"] auto | indefinite | <length> | inherit auto нет N/A [7.29.19 "pause"] [<time> | <percentage>]{1,2} | inherit зависит от ПА нет см. описания 'pause-before' и 'pause-after' [7.6.5 "pause-after"] <time> | <percentage> | inherit зависит от ПА нет см. текст [7.6.6 "pause-before"] <time> | <percentage> | inherit зависит от ПА нет см. текст [7.6.7 "pitch"] <frequency> | x-low | low | medium | high | x-high | inheritmedium да N/A [7.6.8 "pitch-range"] <number> | inherit 50 да N/A [7.6.9 "play-during"] <uri-specification> mix? repeat? | auto | none | inherit auto нет N/A [7.29.20 "position"] static | relative | absolute | fixed | inherit static нет N/A [7.25.16 "precedence"] true | false | inherit false нет N/A [7.28.4 "provisional-distance-between-starts"] <length> | <percentage> | inherit 24.0pt да относительно inline-progression-dimension ближайшего родительского block-area, который не является line-area [7.28.3 "provisional-label-separation"] <length> | <percentage> | inherit 6.0pt да относительно inline-progression-dimension ближайшего родительского block-area, который не является line-area [7.20.3 "reference-orientation"] 0 | 90 | 180 | 270 | -90 | -180 | -270 | inherit 0 да (см. текст) N/A [7.28.5 "ref-id"] <idref> | inherit нет, необходtguide13/index.htm">Клиентский JavaScript. Руководство). Это свойство является отражением в JavaScript атрибута LINK тэга BODY. Значение по умолчанию этого свойства устанавливается пользователем в диалоговом окне установок браузера. Вы не можете установить это свойство после того как исходный код HTML отображён.

При выражении цвета как 16-ричного RGB-триплета Вы обязаны использовать формат rrggbb. Например, 16-ричные значения RGB для цвета salmon будут red=FA, green=80 и blue=72, поэтому RGB-триплет для salmon будет "FA8072".

Пример

Здесь цвет гиперссылок документа устанавливается в aqua с использованием строкового литерала:

document.linkColor="aqua"

А здесь - с использованием 16-ричного триплета:

document.linkColor="00FFFF"

См. также

document.alinkColor, document.bgColor, document.fgColor, document.vlinkColor

links


Массив объектов, соответствующий объектам Area и Link в порядке вхождения в исходном коде.

Свойство из

document

Только для чтения

Реализовано в

JavaScript 1.0

Безопасность

JavaScript 1.1. Это свойство по умолчанию разрушено. О разрушении данных см. книгу Клиентский JavaScript. Руководство.

Описание

Вы можете обращаться к объектам Area и Link в Вашем коде через использование массива links. Этот массив содержит вхождение для каждого объекта Area (тэг <AREA HREF="...">) и Link (<A HREF="...">) документа в порядке появления в исходном коде. Он также содержит ссылки, созданные методом link. Например, если в документе есть три ссылки, можно обратиться к ним так:

document.links[0]
document.links[1]
document.links[2]

Для получения общего количества ссылок в документе, используйте свойство length: document.links.length.

open


Открывает поток для сбора вывода методов write или writeln.

Метод из

document

Реализован в

JavaScript 1.0

JavaScript 1.1: добавлен параметр "replace"; document.open() или document.open("text/html") очищает текущий документ, если его загрузка закончена.

Синтаксис

open([mimeType, [replace]])

Параметры

mimeType

Строка, специфицирующая тип документа, в который Вы записываете. Если Вы не специфицировали mimeType, по умолчанию он будет text/html.

replace

Строка "replace". Если Вы предоставили этот параметр, mimeType обязан быть "text/html". Вызывает использование новым документом вхождения из history, использованного предыдущим документом.

Описание

Значения для mimeType:

Метод open открывает поток для сбора вывода методов write или writeln. Если mimeType это text или image, поток открывается для вывода; иначе поток открывается для plug-in'а. Если документ существует в целевом окне, метод open очищает его.

Поток закрывается путём использования метода document.close. Метод close вызывает отображение текста или изображений, которые были посланы для вывода. После использования document.close вызовите document.open ещё раз, если Вам нужно начать другой поток вывода.

В JavaScript 1.1 или позднее document.open или document.open("text/html") очищает текущий документ, если он закончил загрузку. Поэтому этот тип вызова open записывает по умолчанию тэг <BASE HREF=>, так что Вы можете генерировать относительные URL на основе базы документа, генерирующего скрипт.

Ключевое слово "replace" вызывает повторное использование новым документом вхождения в history, использованного предыдущим документом. Если Вы специфицируете "replace" при открытии документа, размер истории/history не увеличивается, даже если Вы записали в окно и закрыли его.

"replace" обычно используется в окне, в котором находится пустой документ или документ с URL "about:blank". После специфицирования "replace" метод write обычно генерирует HTML для окна, замещая вхождение в history для пустого URL. Будьте внимательны при использовании генерируемого HTML в окне с пустым/blank URL. Если Вы не специфицируете "replace", генерируемый HTML имеет своё собственное вхождение в history, и пользователь может, нажав кнопку Back, вернуться в пустой фрэйм.

После выполнения document.open("text/html","replace")  history.current для целевого окна будет URL документа, который выполнил document.open.

Примеры

Пример 1. Здесь функция вызывает document.open для открытия потока перед использованием метода write:

function windowWriter1() {
   var myString = "Hello, world!"
   msgWindow.document.open()
   msgWindow.document.write("<P>" + myString)
   msgWindow.document.close()
}

Пример 2. Эта функция вызывает document.open с ключевым словом "replace" для открытия потока перед использованием методов write. Код HTML в методах write записывается в msgWindow, замещая текущее вхождение в history. Размер истории/history окна msgWindow не увеличивается.

function windowWriter2() {
   var myString = "Hello, world!"
   msgWindow.document.open("text/html","replace")
   msgWindow.document.write("<P>" + myString)
   msgWindow.document.write("<P>history.length is " +
      msgWindow.history.length)
   msgWindow.document.close()
}

Следующий код создаёт окно msgWindow и вызывает функцию:

msgWindow=window.open('','',
   'toolbar=yes,scrollbars=yes,width=400,height=300')
windowWriter2()

Пример 3. Здесь функция probePlugIn определяет, имеется ли у пользователя установленный Shockwave plug-in:

function probePlugIn(mimeType) {
   var havePlugIn = false
   var tiny = window.open("", "teensy", "width=1,height=1")
   if (tiny != null) {
      if (tiny.document.open(mimeType) != null)
         havePlugIn = true
      tiny.close()
   }
   return havePlugIn
}
var haveShockwavePlugIn = probePlugIn("application/x-director")

См. также

document.close, document.write, document.writeln, Location.reload, Location.replace

plugins


Массив объектов, соответствующих объектам Plugin в порядке расположения в исходном коде.

Свойство из

document

Только для чтения

Реализовано в

JavaScript 1.1

Вы можете обращаться к объектам Plugin в исходном коде, используя массив plugins. Этот массив содержит вхождение для каждого объекта Plugin документа в порядке расположения в исходном коде. Например, если в документе имеются три plugin'а, Вы можете обратиться к ним так:

document.plugins[0]
document.plugins[1]
document.plugins[2]

referrer


Специфицирует URL вызывающего документа, когда пользователь щёлкает по ссылке.

Свойство из

document

Только для чтения

Реализовано в

JavaScript 1.0

Безопасность

JavaScript 1.1. Это свойство по умолчанию разрушено/запорчено. О разрушении данных см. книгу Клиентский JavaScript. Руководство.

Описание

Когда пользователь переходит к другому документу, щёлкая объект Link в исходном документе, свойство referrer содержит URL исходного документа.

referrer является пустым, если пользователь ввёл URL в окне Location браузера и использовал какой-нибудь иной способ получения текущего URL. referrer является пустым также, если сервер не предоставляет информации о переменной окружения.

Пример

Здесь функция getReferrer вызывается из документа назначения. Она возвращает URL исходного документа.

function getReferrer() {
   return document.referrer
}

releaseEvents


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

Метод из

document

Реализован в

JavaScript 1.2

ПРИМЕЧАНИЕ: Если целевым оригиналом события является окно, оно получает событие, даже если окно установлено для освобождения этого типа событий.

Синтаксис

releaseEvents(eventType)

Параметры

eventType

Тип захватываемого события.

Описание

releaseEvents работает вместе с captureEvents, routeEvent и handleEvent. О событиях см. дополнительно книгу Клиентский JavaScript. Руководство.

routeEvent


Передаёт захваченное событие по нормальной иерархии событий.

Метод из

document

Реализован в

JavaScript 1.2

Синтаксис

routeEvent(event)

Параметры

event

Имя перенаправляемого события.

Описание

Если субобъект (document или layer) также захватывает событие, событие пересылается этому объекту. Иначе оно высылается оригинальному целевому объекту.

routeEvent работает вместе с captureEvents, releaseEvents и handleEvent. О событиях см. дополнительно книгу Клиентский JavaScript. Руководство.

tags


Создаёт объект Style, который может специфицировать стили HTML-тэгов.

Свойство из

document

Реализовано в

JavaScript 1.2

Синтаксис

document.tags.tagName

Параметры

tagName

Нечувствительное у регистру имя любого тэга HTML, такого как H1 или BLOCKQUOTE.

Описание

Используйте свойство tags для специфицирования стиля HTML-тэгов. Например, Вы можете специфицировать, что цвет любого тэга H1 будет blue и что выравнивание тэгов H1 или H2 будет по центру. См. в объекте Style описание свойств, которые Вы можете специфицировать для тэгов HTML.

Поскольку все элементы HTML наследуют от тэга BODY, Вы можете специфицировать стиль по умолчанию документа, установив стили тэга BODY.

Если Вы используете свойство tags внутри тэга STYLE (а не внутри тэга SCRIPT), Вы можете по выбору опустить document в синтаксисе tags. Свойство tags всегда применяется к текущему объекту document.

Примеры

Пример 1. Цвет всех тэгов H1 устанавливается в blue:

<STYLE TYPE="text/javascript">
   tags.H1.color="blue"
</STYLE>

Обратите внимание, что Вы можете опустить указание объекта document в тэге STYLE. Внутри тэга SCRIPT Вы обязаны специфицировать объект document таким образом:

<SCRIPT LANGUAGE="JavaScript1.2">
   document.tags.H1.color="blue"
</SCRIPT>

Пример 2. Устанавливается универсальное левое поле документа:

document.tags.Body.marginLeft="20pt"

Поскольку все тэги HTML наследуют от BODY, этот пример устанавливает левое поле для всего документа в 20 пунктов.

См. также

document.classes, document.contextual, document.ids, Style

title


Строка, представляющая название документа.

Свойство из

document

Только для чтения

Реализовано в

JavaScript 1.0

Безопасность

JavaScript 1.1. Это свойство по умолчанию разрушено/запорчено. О разрушении данных см. книгу Клиентский JavaScript. Руководство.

Описание

Свойство title является отражением значения, специфицируемого между  начальным и конечным тэгами TITLE. Если документ не имеет названия/title, свойство title будет null.

Пример

Здесь значение свойства title присваивается переменной docTitle:


var newWindow = window.open("http://home.netscape.com")
var docTitle = newWindow.document.title

URL


Строка, специфицирующая полный URL документа.

Свойство из

document

Только для чтения

Реализовано в

JavaScript 1.0

Безопасность

JavaScript 1.1. Это свойство по умолчанию разрушено/запорчено. О разрушении данных см. книгу Клиентский JavaScript. Руководство.

Описание

URL это свойство со строковым значением, содержащее полный URL документа. Оно обычно совпадает с тем, что установлено в свойстве window.location.href при загрузке документа, но перенаправление может изменить location.href.

Пример

Выводится URL текущего документа:

document.write("The current URL is " + document.URL)

См. также

Location.href

vlinkColor


Строка, специфицирующая цвет посещённых гиперссылок.

Свойство из

document

Реализовано в

JavaScript 1.0

Описание

Свойство vlinkColor выражается как 16-ричный RGB-триплет или как строковой литерал (см. книгу Клиентский JavaScript. Руководство). это свойство является отражением в JavaScript атрибута VLINK тэга BODY. Значение по умолчанию этого свойства устанавливается пользователем в диалоге настроек браузера. Вы не можете установить это свойство после того как исходный HTML отображён.

Если цвет выражается как 16-ричный триплет RGB, Вы обязаны использовать формат rrggbb. Например, 16-ричные RGB-значения для цвета salmon будут red=FA, green=80 и blue=72, так что RGB-триплет для salmon будет "FA8072".

Примеры

Здесь цвет посещённых ссылок устанавливается в aqua с использованием строкового литерала:

document.vlinkColor="aqua"

А здесь - с помощью 16-ричного триплета:

document.vlinkColor="00FFFF"

См. также

document.alinkColor, document.bgColor, document.fgColor, document.linkColor

width


Ширина документа в пикселах.

Свойство из

document

Реализовано в

JavaScript 1.2

См. также

document.height

write


Записывает одно или более выражений HTML в документ специфицированного окна.

Метод из

document

Реализован в

JavaScript 1.0

Синтаксис

document.write(expr1[, ...,exprN])

Параметры

expr1, ... exprN

Любые выражения JavaScript.

Описание

Метод write отображает любое количество выражений в документе окна. Вы можете специфицировать любое выражение JavaScript методом write, включая числовые, строки или логические выражения.

Метод write это такой же метод, что и writeln, за исключением того, что метод write не присоединяет символ новой строки в конец вывода.

Используйте метод write внутри тэгов SCRIPT или в обработчиках событий. Обработчики событий выполняются после закрытия оригинального документа, поэтому метод write неявно открывает новый документ с типом mimeType text/html, если Вы не вызываете явно метод document.open в обработчике события.

Можно использовать метод write для генерации HTML и кода JavaScript. Однако разборщик HTML читает генерируемый код так, как он написан, поэтому Вам может понадобиться использовать escape-кодирование некоторых символов. Например, следующий метод write генерирует комментарий и записывает его в окно window2:

window2=window.open('','window2')
beginComment="\<!--"
endComment="--\>"
window2.document.write(beginComment)
window2.document.write(" Это текст комментария. ")
window2.document.write(endComment)

Печать, сохранение и просмотр сгенерированного HTML. В браузере Navigator 3.0 и позже пользователи могут печатать и сохранять генерируемый HTML, используя команды из меню File.

Если Вы используете Page Source из меню View в Navigator или View Frame Source после щелчка правой кнопкой мыши и открытия дополнительного меню, web-браузер отображает содержимое HTML-файла со сгенерированным HTML.

Если Вам нужно просмотреть исходный код HTML с кодом скриптов, генерирующих HTML (методами document.write и document.writeln), не используйте пункты меню Page Source или View Frame Source. Здесь нужно ввести view-source: протокол.

Например, предположим, что файл file://c|/test.html содержит такой текст:

<HTML>
<BODY>
Hello,
<SCRIPT>document.write(" there.")</SCRIPT>
</BODY>
</HTML>

Если загрузить этот URL в web-браузер, он отобразит:

Hello, there.

Если выбрать View Document Source, браузер отобразит:

<HTML>
<BODY>
Hello,
 there.
</BODY>
</HTML>

Если загрузить view-source:file://c|/test.html, браузер отобразит:

<HTML>
<BODY>
Hello,
<SCRIPT>document.write(" there.")</SCRIPT>
</BODY>
</HTML>

О специфицировании view-source: protocol в объекте location см. объект Location.

Примеры

Здесь метод write принимает несколько аргументов, в том числе строки, числа и переменную:

var mystery = "world"

// Выводится Hello world testing 123
msgWindow.document.write("Hello ", mystery, " testing ", 123)

В следующем примере метод write принимает два аргумента. Первый - это выражение присвоения, а второй - строковой литерал.

//Выводится Hello world...
msgWindow.document.write (mystr = "Hello ", "world...")

В следующем примере метод write принимает единственный аргумент, который является условным выражением. Если значение переменной age будет меньше 18, метод выведет "Minor." Если значение age будет больше или равно 18, метод выведет "Adult."

msgWindow.document.write(status = (age >= 18) ? "Adult" : "Minor")

См. также

document.close, document.open, document.writeln

writeln


Записывает одно или более выражений HTML в документ в специфицированном окне с последующим символом новой строки.

Метод из

document

Реализован в

JavaScript 1.0

Синтаксис

writeln(expr1[, ... exprN])

Параметры

expr1, ... exprN

Любые выражения JavaScript.

Описание

Метод writeln выводит любое количество выражений в документ окна. Вы можете специфицировать любое выражение JavaScript, включая числа, строки или логические выражения.

Метод writeln это тот же метод, что и write, за исключением того, что метод writeln присоединяет символы новой строки в конец вывода. HTML игнорирует символы новой строки, за исключением некоторых тэгов, таких как PRE.

Используйте метод writeln внутри тэгов SCRIPT или в обработчике событий. Обработчики событий выполняются после закрытия оригинального документа, поэтому метод writeln будет неявно открывать новый документ типа mimeType text/html, если Вы не вызываете явно метод document.open в обработчике события.

В Navigator 3.0 и позднее пользователи могут печатать и сохранять сгенерированный HTML, используя команды меню File браузера.

Примеры

Все пример для метода write верны также и для метода writeln.

См. также

document.close, document.open, document.write
Оглавление | Назад | Вперёд | Индекс

Дата последнего обновления: 28 мая 1999 года.
Copyright (c) 1999 Netscape Communications Corporation

Hosted by uCoz