[Содержание] [Предыдущая] [Следующая] [Индекс]

Link

Фрагмент текста, изображения или области изображения, идентифицированный как гипертекстовая ссылка. Когда пользователь щелкает текст ссылки, изображение или область, ссылка гипертекста загружается в целевое окно. Объект Area того же типа, что и объект Link.

Объект client-side
Реализовано в Navigator 2.0
Navigator 3.0: добавлен обработчик события onMouseOut; добавлен объект Area; массив links содержит области, созданные <AREA HREF="...">
Navigator 4.0: добавлен метод handleEvent

Создание

Используя HTML тэги A или AREA или вызывая метод String.link. Двигатель времени выполнения JavaScript создает объект Link, соответствующий каждому тэгу A и AREA в Вашем документе, которые имеют аттрибут HREF. Помещает эти объекты как массив в свойство document.links. Вы обращаетесь к объекту Link индексируя этот массив.

Определение ссылки методом String.link:

theString.link(hrefAttribute)
где:

theString
Объект String.
hrefAttribute
Любая строка, определяющая аттрибут HREF тэга A; это должен быть допустимый URL (относительный или абсолютный).

Чтобы определить ссылку тэгами A или MAP, используйте стандартный синтаксис HTML с добавлением обработчиков событий JavaScript. Если Вы собираетесь использовать onMouseOut или onMouseOver обработчики событий, Вы должны обеспечить значение для аттрибута HREF.

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

Объекты Area имеют следующие обработчики событий:

Объекты Link имеют следующие обработчики событий:

Описание

Каждый объект Link является объектом location и имеет те же самые свойства как объект location.

Если объект Link является также объектом Anchor, объект имеет записи в обоих массивах anchors и links.

Когда пользователь щелкает по объекту Link и переходит на результирующий документ (определенный как HREF="locationOrURL"), свойство referrer результирующего документа содержит URL исходного документа. Свойство referrer оценивается от результирующего документа.

Вы можете использовать объект Link, чтобы выполнить функцию JavaScript вместо ссылки, определяя URL протокол javascript: для аттрибута HREF объекта Link. Вы могли бы сделать это, если ссылка окружает объект Image и Вы хотите выполнить код JavaScript, когда изображение нажато. Или Вы могли бы использовать ссылку вместо кнопки, чтобы выполнить код JavaScript.

Например, когда пользователь щелкает по следующий ссылке, выполняются функции slower и faster:

<A HREF="javascript:slower()">Медленнее</A>
<A HREF="javascript:faster()">Быстрее</A>
Вы можете использовать объект Link, чтобы ничего не делать вместо вызова ссылки, определяя URL протокол javascript:void(0) для аттрибута HREF объекта Link. Вы могли бы делать это, если ссылка окружает объект Image и Вы хотите использовать обработчики событий ссылки с изображением. Когда пользователь щелкает следующую ссылку или изображение, ничего не происходит:

<A HREF="javascript:void(0)">Нажмите здесь, чтобы ничего не делать</A>
<A HREF="javascript:void(0)">
   <IMG SRC="images\globe.gif" ALIGN="top" HEIGHT="50" WIDTH="50">
</A>

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

hash
Определяет имя якоря в URL.
host
Определяет хост и доменное имя, или IP адрес сетевого хоста.
hostname
Определяет host:port часть URL.
href
Определяет весь URL.
pathname
Определяет URL-path часть URL.
port
Определяет коммуникационный порт, который сервер использует.
protocol
Определяет начало URL, включая двоеточие.
search
Определяет строку запроса.
target
Отражает аттрибут TARGET.
text
Строка, отражающая содержание соответствующего тэга A.

Резюме Методов

handleEvent
Вызывает обработчик для указанного события.

Примеры

Пример 1. Следующий пример создает гипертекстовую ссылку на якорь с именем javascript_intro:

<A HREF="#javascript_intro">Введение в JavaScript</A>
Пример 2. Следующий пример создает гипертекстовую ссылку на якорь с именем numbers в файле doc3.html в окне window2. Если window2 не существует, оно будет создано.

<LI><A HREF=doc3.html#numbers TARGET="window2">Числа</A>
Пример 3. Следующий пример перемещает пользователя назад на x записей в списке истории:

<A HREF="javascript:history.go(-1 * x)">Нажмите здесь</A>
Пример 4. Следующий пример создает гипертекстовую ссылку на URL. Пользователь может использовать набор "радио" кнопок, чтобы выбрать между тремя URL. Обработчик события onClick ссылки устанавливает URL (свойство href ссылки) основываясь на выбранной "радио" кнопке. Ссылка также имеет обработчик события onMouseOver, который изменяет свойство status окна. Пример показывает, что Вы должны возвратить true, чтобы установить свойство window.status в обработчике события onMouseOver.

<SCRIPT>
var destHREF="http://home.netscape.com/"
</SCRIPT>
<FORM NAME="form1">
<B>Выберите адресата из следующего списка, затем нажмите "Нажмите меня" ниже.</B>
<BR><INPUT TYPE="radio" NAME="destination" VALUE="netscape"
   onClick="destHREF='http://home.netscape.com/'"> Домашняя страница Netscape
<BR><INPUT TYPE="radio" NAME="destination" VALUE="sun"
   onClick="destHREF='http://www.sun.com/'"> Домашняя страница Sun
<BR><INPUT TYPE="radio" NAME="destination" VALUE="rfc1867"
   onClick="destHREF='http://www.ics.uci.edu/pub/ietf/html/rfc1867.txt'"> RFC 1867
<P><A HREF=""
   onMouseOver="window.status='Нажмите ее, если посмеете!'; return true"
   onClick="this.href=destHREF">
   <B>Нажмите меня</B></A>
</FORM>
Пример 5: массив ссылок. В следующем примере функция linkGetter использует массив links, чтобы отобразить значение каждой ссылки в текущем документе. Пример также определяет несколько ссылок и кнопку для выполнения linkGetter.

function linkGetter() {
   msgWindow=window.open("","msg","width=400,height=400")
   msgWindow.document.write("links.length is " +
      document.links.length + "<BR>")
   for (var i = 0; i < document.links.length; i++) {
      msgWindow.document.write(document.links[i] + "<BR>")
   }
}
<A HREF="http://home.netscape.com">Домашняя Страница Netscape</A>
<A HREF="http://www.catalog.com/fwcfc/">China Adoptions</A>
<A HREF="http://www.supernet.net/~dugbrown/">Bad Dog Chronicles</A>
<A HREF="http://www.best.com/~doghouse/homecnt.shtml">Lab Rescue</A>
<P>
<INPUT TYPE="button" VALUE="Отобразить ссылки"
   onClick="linkGetter()">
Пример 6: Обращение к объекту Area с помощью массива ссылок. Следующий код ссылается к свойству href первого объекта Area , показанного в Примере 1.

document.links[0].href
Пример 7: Объект Area с обработчиками событий onMouseOver и onMouseOut. Следующий пример показывает изображение globe.gif. Изображение использует графическую карту, которая определяет области для верхней половины и нижней половины изображения. Обработчики событий onMouseOver и onMouseOut отображают различные сообщения в строке состояния в зависимости от того, проходит мышь над или оставляет верхную половину или нижнюю половину изображения. Аттрибут HREF требуется при использовании onMouseOver и onMouseOut обработчиков событий, но в этом примере, изображение не нуждается в гипертекстовой ссылке, так что аттрибут HREF выполняет javascript:void(0), который ничего не делает.

<MAP NAME="worldMap">
   <AREA NAME="topWorld" COORDS="0,0,50,25" HREF="javascript:void(0)"
      onMouseOver="self.status='Вы находитесь в верней части мира';return true"
      onMouseOut="self.status='Вы оставили верхнюю часть мира';return true">
   <AREA NAME="bottomWorld" COORDS="0,25,50,50" HREF="javascript:void(0)"
      onMouseOver="self.status='Вы находитесь в нижней части мира';return true"
      onMouseOut="self.status='Вы оставили нижнюю часть мира';return true">
</MAP>
<IMG SRC="images\globe.gif" ALIGN="top" HEIGHT="50" WIDTH="50" USEMAP="#worldMap">
Пример 8: Эмулирует событие onClick объекта Area, используя аттрибут HREF. Следующий пример использует аттрибут HREF объекта Area, чтобы выполнить функцию JavaScript. Изображение отображает colors.gif, показывающего два типовых цвета. Верхная половина изображения имеет цвет antiquewhite, а нижняя половина white. Когда пользователь щелкает верхную или нижнюю половину изображения, функция setBGColor изменяет цвет фона документа на цвет, показанный в изображении.

<SCRIPT>
function setBGColor(theColor) {
   document.bgColor=theColor
}
</SCRIPT>
Нажмите цвет, который Вы хотите видеть цветом фона документа
<MAP NAME="colorMap">
   <AREA NAME="topColor" COORDS="0,0,50,25" HREF="javascript:setBGColor('antiquewhite')">
   <AREA NAME="bottomColor" COORDS="0,25,50,50" HREF="javascript:setBGColor('white')">
</MAP>
<IMG SRC="images\colors.gif" ALIGN="top" HEIGHT="50" WIDTH="50" USEMAP="#colorMap">

Смотрите также

Anchor, Image, link

Свойства

hash

Строка, начинающаяся знаком диез (#), который определяет имя якоря в URL.

Свойство объекта Link
Реализовано в Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Свойство hash определяет часть URL. Это свойство применяется только к HTTP URL.

Будьте внимательным используя это свойство. Допустим document.links[0] содержит:

http://royalairways.com/fish.htm#angel
Тогда document.links[0].hash возвратит #angel. Предположим, что Вы имеете этот код:

hash = document.links[0].hash;
document.links[0].hash = hash;
Теперь, document.links[0].hash возвратит ##angel.

Это поведение может измениться в будущем выпуске.

Вы можете устанавливать свойство hash в любое время, хотя более надежно установить свойство href, чтобы изменить расположение. Если hash, который Вы определяете, не найден в текущем расположении, Вы получите ошибку.

При установке свойства hash происходит перемещение к именованному якорю без перезагрузки документа. Это отличается от способа, которым документ загружается, когда устанавливаются другие свойства link.

Смотрите RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) для полной информации о hash.

Смотрите также

Link.host, Link.hostname, Link.href, Link.pathname, Link.port, Link.protocol, Link.search

host

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

Свойство объекта Link
Реализовано в Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Свойство host определяет часть URL. Свойство host это подстрока свойства hostname. Свойство hostname объединяет свойства host и port, разделенных двоеточием. Когда свойство port равно null, свойство host равно свойству hostname.

Вы можете устанавливать свойство host в любое время, хотя более надежно установить свойство href, чтобы изменить расположение. Если host, который Вы определяете, не может быть найден в текущем расположении, Вы получаете ошибку.

Смотрите Раздел 3.1 RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) для полной информации о host-имени и порте.

Смотрите также

Link.hash, Link.hostname, Link.href, Link.pathname, Link.port, Link.protocol, Link.search

hostname

Строка, содержащая полное host-имя сервера, включая имя сервера, поддомен, домен и номер порта.

Свойство объекта Link
Реализовано в Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Свойство hostname определяет часть URL. Свойство hostname объединяет свойства host и port, разделенных двоеточием. Когда свойство port равно 80 (по умолчанию), свойство host равно свойству hostname.

Вы можете устанавливать свойство hostname в любое время, хотя более надежно установить свойство href, чтобы изменить расположение. Если hostname, которое Вы определяете, не может быть найдено в текущем расположении, Вы получаете ошибку.

Смотрите Раздел 3.1 RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) для полной информации о host-имени.

Смотрите также

Link.host, Link.hash, Link.href, Link.pathname, Link.port, Link.protocol, Link.search

href

Строка, определяющая весь URL.

Свойство объекта Link
Реализовано в Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Свойство href определяет весь URL. Другие свойства объекта link это подстроки свойства href.

Вы можете устанавливать href свойство в любое время.

Смотрите RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) для полной информации об URL.

Смотрите также

Link.hash, Link.host, Link.hostname, Link.pathname, Link.port, Link.protocol, Link.search

pathname

Строка, определяющая URL-path часть URL.

Свойство объекта Link
Реализовано в Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Свойство pathname определяет часть URL. Имя пути обеспечивает подробности того, как к определенному ресурсу можно обращаться.

Вы можете устанавливать свойство pathname в любое время, хотя более надежно установить свойство href, чтобы изменить расположение. Если pathname, которое Вы определяете, не может быть найдено в текущем расположении, Вы получаете ошибку.

Смотрите Раздел 3.1 RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) для полной информации об имени пути.

Смотрите также

Link.host, Link.hostname, Link.hash, Link.href, Link.port, Link.protocol, Link.search

port

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

Свойство объекта Link
Реализовано в Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Свойство port определяет часть URL. Свойство port подстрока свойства hostname. Свойство hostname объединяет свойства host и port, разделенных двоеточием. Когда свойство port равно 80 (по умолчанию), свойство host равно свойству hostname.

Вы можете устанавливать port в любое время, хотя более надежно установить свойство href, чтобы изменить расположение. Если port, который Вы определяете, не может быть найден в текущем расположении, Вы получите ошибку. Если свойство port не определено, оно по умолчанию равно 80 на сервере.

Смотрите Раздел 3.1 RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) для полной информации о порте.

Смотрите также

Link.host, Link.hostname, Link.hash, Link.href, Link.pathname, Link.protocol, Link.search

protocol

Строка, определяющая начало URL, включая первое двоеточие.

Свойство объекта Link
Реализовано в Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Свойство protocol определяет часть URL. Протокол указывает метод доступа к URL. Например, значение "http:" определяет Протокол Передачи Гипертекста, и значение "javascript:" определяет код JavaScript.

Вы можете устанавливать свойство protocol в любое время, хотя более надежно установить свойство href, чтобы изменить расположение. Если protocol, который Вы определяете, не может быть найден в текущем расположении, Вы получаете ошибку.

Свойство protocol представляет имя схемы URL. Смотрите Раздел 2.1 RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) для полной информации о протоколе.

Смотрите также

Link.host, Link.hostname, Link.hash, Link.href, Link.pathname, Link.port, Link.search

search

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

Свойство объекта Link
Реализовано в Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Свойство search определяет часть URL. Это свойство применяется только к HTTP URL.

Свойство search содержит пары, значение и переменная; каждая пара отделяется символом амперсанда. Например, две пары в строке поиска могли бы походить на следующее:

?x=7&y=5
Вы можете устанавливать свойство search в любое время, хотя более надежно установить свойство href, чтобы изменить расположение. Если search, который Вы определяете, не может быть найден в текущем расположении, Вы получаете ошибку.

Смотрите Раздел 3.3 RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) для полной информации о поиске.

Смотрите также

Link.host, Link.hostname, Link.hash, Link.href, Link.pathname, Link.port, Link.protocol

target

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

Свойство объекта Link
Реализовано в Navigator 2.0

Описание

Свойство target первоначально отражает аттрибут TARGET тэгов A или AREA; однако, установка target переназначает этот атрибут.

Вы можете устанавливать target, используя строку, если строка представляет имя окна. Свойству target не может быть присвоено значение выражения JavaScript или переменной.

Вы можете устанавливать свойство target в любое время.

Примеры

Следующий пример определяет, что ответ на форму musicInfo отображается в окне msgWindow:

document.musicInfo.target="msgWindow"

Смотрите также

Form

text

Строка, содержащая содержание соответствующего тэга A.

Свойство объекта Link
Реализовано в Navigator 4.0

Методы

handleEvent

Вызывает обработчик для указанного события.

Метод объекта Link
Реализовано в Navigator 4.0

Синтаксис

handleEvent(event)

Параметры

event
Имя события, для которого определенный объект имеет обработчик события.

Описание

Для информации об обработке событий, смотрите "Общая Информация о Событиях".


[Содержание] [Предыдущая] [Следующая] [Индекс]

Последняя Модификация: 10/31/97 12:30:56


Права © 1997 Netscape Communications Corporation



Все мессаги сюда:yanich@inbox.ru
Hosted by uCoz