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

Anchor (Якорь)

Место в документе, являющееся целью для гиперссылки.

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

Реализован в

JavaScript 1.0

JavaScript 1.2: добавлены свойства name, text, x и y

Создание

Этот объект создаётся в HTML тэгом A или через вызов метода String.anchor. Машина времени выполнения JavaScript создаёт объекты Anchor, соответствующие каждому тэгу A с атрибутом NAME. Эти объекты помещаются в массив-свойство document.anchors. Вы можете получить доступ к объекту Anchor по индексу в этом массиве.

Чтобы определить anchor методом String.anchor:

theString.anchor(nameAttribute)

где:

`theString`	`String`-объект.
`nameAttribute`	Строка.

При определении anchor тэгом A используйте стандартный синтаксис HTML. Если Вы специфицируете атрибут NAME, Вы можете использовать значение этого атрибута при индексировании в массиве anchors.

Описание

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

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

Свойство	Описание
`name`	Имя якоря.
`text`	Текст якоря.
`x`	Позиция левого края якоря по оси х в пикселах относительно левого края документа.
`y`	Позиция верхнего края якоря по оси у в пикселах относительно верхнего края документа.

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

Этот объект наследует методы watch и unwatch из Object.

Примеры

Пример 1. Якорь/anchor.

В этом примере определяется anchor для текста "Welcome to JavaScript":

<A NAME="javascript_intro"><H2>Welcome to JavaScript</H2></A>

Если вышеприведённый anchor находится в файле intro.html, ссылка в другом файле может определять переход на этот anchor таким образом:

<A HREF="intro.html#javascript_intro">Introduction</A>

Пример 2. Массив anchors.

Открываются два окна. Первое окно содержит серию кнопок, которые устанавливают location.hash во втором окне на определённый anchor. Во втором окне определены 4 якоря: "0", "1", "2" и "3." (Имена якорей в документе, следовательно, 0, 1, 2, ... (document.anchors.length-1)). Когда в первом окне нажимается кнопка, обработчик события onClick проверяет существование anchor, перед тем как установить в window2.location.hash имя специфицированного якоря.

link1.html, в котором определены первое окно и кнопки, содержит следующий код:

<HTML>
<HEAD>
<TITLE>Links and Anchors:
Window 1</TITLE>
</HEAD>
<BODY>
<SCRIPT>
window2=open("link2.html","secondLinkWindow",
   "scrollbars=yes,width=250, height=400")

function linkToWindow(num) {
   if (window2.document.anchors.length > num)

      window2.location.hash=num
   else

      alert("Anchor does not exist!")
}
</SCRIPT>

<B>Links and Anchors</B>
<FORM>

<P>Click a button to display that anchor in window #2

<P><INPUT TYPE="button" VALUE="0" NAME="link0_button"

   onClick="linkToWindow(this.value)">

<INPUT TYPE="button" VALUE="1" NAME="link0_button"

   onClick="linkToWindow(this.value)">

<INPUT TYPE="button" VALUE="2" NAME="link0_button"

   onClick="linkToWindow(this.value)">

<INPUT TYPE="button" VALUE="3" NAME="link0_button"

   onClick="linkToWindow(this.value)">

<INPUT TYPE="button" VALUE="4" NAME="link0_button"

   onClick="linkToWindow(this.value)">

</FORM>
</BODY>
</HTML>

link2.html, где находятся якоря, содержит следующий код:

<HTML>
<HEAD>

<TITLE>Links and Anchors: Window 2</TITLE>
</HEAD>
<BODY>

<A NAME="0"><B>Some numbers</B> (Anchor 0)</A>
<UL><LI>one

<LI>two
<LI>three
<LI>four</UL>

<P><A NAME="1"><B>Some colors</B> (Anchor 1)</A>
<UL><LI>red

<LI>orange
<LI>yellow
<LI>green</UL>

<P><A NAME="2"><B>Some music types</B> (Anchor 2)</A>

<UL><LI>R&B
<LI>Jazz
<LI>Soul
<LI>Reggae

<LI>Rock</UL>
<P><A NAME="3"><B>Some countries</B> (Anchor 3)</A>

<UL><LI>Afghanistan
<LI>Brazil
<LI>Canada
<LI>Finland

<LI>India</UL>
</BODY>
</HTML>

См. также

Link

name

Строка - имя якоря.

Свойство из	`Anchor`
Только для чтения
Реализовано в	JavaScript 1.2

Описание

Свойство name содержит значение атрибута NAME.

Пример

Выводится имя первого anchor в документе:

alert("The first anchor is " + document.anchors[0].name)

text

Строка - текст якоря.

Свойство из	`Anchor`
Только для чтения
Реализовано в	JavaScript 1.2

Описание

Свойство text специфицирует строку, которая выводится в тэге A.

Пример

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

alert("The text of the first anchor is " + document.anchors[0].text)

x

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

Свойство из	`Anchor`
Только для чтения
Реализовано в	JavaScript 1.2

См. также

Anchor.y

y

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

Свойство из	`Anchor`
Только для чтения
Реализовано в	JavaScript 1.2

См. также

Anchor.x

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

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