На главную страницу
Форум txt.version   




Статья :: Link
Оглавление | Назад | Вперёд | Индекс

Link

Участок текста, изображение или область изображения, идентифицируемая как гипертекстовая ссылка. Если пользователь щёлкает текст, изображение или область, объект/документ загружается в окно назначения. Area-объекты являются типом объекта Link.

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

Реализован в

JavaScript 1.0

JavaScript 1.1: добавлен обработчик onMouseOut; добавлены объекты Area; links-массивы содержат области, созданные тэгом <AREA HREF="...">

JavaScript 1.2: добавлены свойства x и y; добавлен метод handleEvent.

Создание

HTML-тэгами A или AREA или вызовом метода String.link. Машина выполнения JavaScript создаёт объекты Link для всех тэгов A и AREA в Вашем документе, предоставляющих атрибут HREF. Она помещает эти объекты в массив свойства document.links. Вы получаете доступ к объекту Link по индексу в этом массиве.

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

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

theString.link(hrefAttribute)

где:

theString

String-объект.

hrefAttribute

Любая строка, специфицирующая атрибут HREF тэга A; она должна быть правильным URL (относительным или абсолютным).

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

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

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

Описание

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

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

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

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

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

<A HREF="javascript:slower()">Slower</A>
<A HREF="javascript:faster()">Faster</A>

Вы можете использовать объект Link, чтобы не выполнять никаких действий, специфицировав URL-протокол javascript:void(0) в атрибуте HREF гиперссылки. Вам это может понадобиться, если ссылка окружает объект Image и Вы хотите использовать обработчики события ссылки для изображения. Если пользователь щёлкает по следующим ссылкам, ничего не происходит:

<A HREF="javascript:void(0)">Click here to do nothing</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-пути из URL.

port

Специфицирует порт, используемый сервером.

protocol

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

search

Специфицирует строку запроса.

target

Отражает атрибут TARGET.

text

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

x

Позиция левого края ссылки по горизонтали в пикселах относительно левого края документа.

y

Позиция верхнего края ссылки по вертикали в пикселах относительно верхнего края документа.

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

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

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

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

Примеры

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

<A HREF="#javascript_intro">Introduction to JavaScript</A>

Пример 2. Здесь создаётся гиперссылка на якорь numbers в файле doc3.html в окне window2. Если window2 не существует, оно создаётся.

<LI><A HREF=doc3.html#numbers TARGET="window2">Numbers</A>

Пример 3. Здесь пользователь переходит на x вхождений назад в списке history:

<A HREF="javascript:history.go(-1 * x)">Click here</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>Choose a destination from the following list, then click "Click me" below.</B>
<BR><INPUT TYPE="radio" NAME="destination" VALUE="netscape"
   onClick="destHREF='http://home.netscape.com/'"> Netscape home page
<BR><INPUT TYPE="radio" NAME="destination" VALUE="sun"
   onClick="destHREF='http://www.sun.com/'"> Sun home page
<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='Click this if you dare!'; return true"
   onClick="this.href=destHREF">
   <B>Click me</B></A>
</FORM>

Пример 5: Массив links. В этом примере функция 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 Home Page</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="Display links"
   onClick="linkGetter()">

Пример 6: Обращение к Area-объекту через массив links. Здесь код обращается к свойству href первого Area-объекта, показанного в Примере 1.

document.links[0].href

Пример 7: Area-объект с обработчиками onMouseOver и onMouseOut. Здесь выводится изображение globe.gif. Это изображение использует карту изображений/image map, которая определяет области верхней и нижней половин рисунка. Обработчики 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='You are on top of the world';return true"
      onMouseOut="self.status='You have left the top of the world';return true">
   <AREA NAME="bottomWorld" COORDS="0,25,50,50" HREF="javascript:void(0)"
      onMouseOver="self.status='You are on the bottom of the world';return true"
      onMouseOut="self.status='You have left the bottom of the world';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>
Click the color you want for this document's background color
<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

handleEvent


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

Метод из

Link

Реализован в

JavaScript 1.2

Синтаксис

handleEvent(event)

Параметр

event

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

Описание

Об обработке событий см. книгу Клиентский JavaScript. Руководство.

hash


Строка, начинающаяся со знака хэша (#), которая специфицирует имя якоря в URL.

Свойство из

Link

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

JavaScript 1.0

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

JavaScript 1.1. Это свойство разрушено/запорчено по умолчанию. О разрушении данных см. книгу Клиентский 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 в любой момент, хотя безопаснее делать это до изменения расположения. Если хэш, который Вы специфицируете, не может быть найден в текущем месте, Вы получите ошибку.

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

См. в документе RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о хэше.

См. также

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

host


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

Свойство из

Link

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

JavaScript 1.0

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

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

Описание

Свойство host специфицирует часть URL. Свойство host является подстрокой свойства hostname. Свойство hostname образуется путём конкатенации свойств host и port, разделённых двоеточием. Если свойство port имеет значение null, свойство host имеет то же значение, что и свойство hostname.

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

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

См. также

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

hostname


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

Свойство из

Link

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

JavaScript 1.0

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

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

Описание

Свойство hostname специфицирует часть URL. Свойство hostname образуется путём конкатенации свойств host и port, разделённых двоеточием. Если свойство port имеет значение 80 (это значение по умолчанию), свойство host имеет то же значение, что и свойство hostname.

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

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

См. также

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

href


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

Свойство из

Link

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

JavaScript 1.0

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

JavaScript 1.1. Это свойство разрушено/запорчено по умолчанию. О разрушении данных см. книгу Клиентский 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-пути в URL.

Свойство из

Link

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

JavaScript 1.0

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

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

Описание

Свойство pathname специфицирует часть URL. Оно даёт детальную информацию о том, как может быть достигнут специфицированный ресурс.

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

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

См. также

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

port


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

Свойство из

Link

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

JavaScript 1.0

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

JavaScript 1.1. Это свойство разрушено/запорчено по умолчанию. О разрушении данных см. книгу Клиентский 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) полную информацию о port.

См. также

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

protocol


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

Свойство из

Link

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

JavaScript 1.0

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

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

Описание

Свойство protocol специфицирует часть URL. Оно указывает метод доступа к URL. Например, значение "http:" специфицирует HyperText Transfer Protocol, а значение "javascript:" специфицирует код JavaScript.

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

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

См. также

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

search


Строка, начинающаяся со знака вопроса (?), которая специфицирует запрос информации через URL.

Свойство из

Link

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

JavaScript 1.0

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

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

Описание

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

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

?x=7&y=5

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

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

См. также

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

target


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

Свойство из

Link

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

JavaScript 1.0

Описание

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

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

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

Пример

Здесь специфицируется, что ответы на форму musicInfo отображаются в окне msgWindow:

document.musicInfo.target="msgWindow"

См. также

Form

text


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

Свойство из

Link

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

JavaScript 1.2

x


Позиция левого края ссылки по горизонтали в пикселах относительно левого края документа.

Свойство из

Link

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

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

JavaScript 1.2

См. также

Link.y

y


Позиция верхнего края ссылки по вертикали в пикселах относительно верхнего края документа.

Свойство из

Link

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

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

JavaScript 1.2

См. также

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

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

Link

страницы в данном разделе 
 ancor  applet
 area.htm  array
 Индекс  Boolean
 button  Checkbox
 Классы, Конструкторы и Методы Java  Значения Цветов
 Оглавление  Куки Netscape
 date.htm  document
 event  FileUpload
 form.htm  Frame
 Function  Обработчики Событий
 Hidden  History
 Image  Оглавление
 java.htm  JavaArray
 JavaClass  JavaObject
 JavaPackage  Приложение A. Зарезервированные Слова
 Layer  JSException
 JSObject  Plugin
 link.htm  Location
 math.htm  MimeType
 navigator  netscape
 Number  Object
 Объекты, Методы и Свойства  Операции
 Option  Packages
 Приложения  Справочник по Классам LiveConnect
 Элементы Языка  Объекты. Справочник.
 Password  Plugin
 Об Этой Книге  Radio
 RegExp  Reset
 screen  Select
 Операторы  String
 Style  Submit
 sun.htm  text.htm
 Textarea  toc.htm
 Свойства и Функции Верхнего Уровня  Новые Возможности в Этой Версии
 window   


Разделы
Околокомпьютерная литература (375)
Программирование (102)
Программы (75)
ОС и Сети (49)
Интернет (29)
Аппаратное обеспечение (16)
Базы данных (6)

Содержание сайта (выборка)
Apache
Протоколы TCP/IP (принципы, протоколы и архитектура)

PHP, PELR, JSP
PHP
JavaServer Pages (JSP)

Базы данных
Основы mysql
СУБД INFORMIX
СУБД POSTGRES
Основы проектирования реляционных баз данных

HTML, javascript
Спецификация HTML 4.01
Каскадные Таблицы Стилей, Уровень 2
Клиентский JavaScript. Справочник.
JavaScript руководство пользователя
Серверный JavaScript 1.4. Руководство по Использованию.

Паскаль, C, C++, C#
GCC (примеры)
FAQ Валентинa Озеровa DELPHI
C





 
©  programming-lang.com  справочник программиста