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

History

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

Объект client-side
Реализовано в Navigator 2.0
Navigator 3.0: добавлены свойства current, next и previous;

Создание

Объекты History предопределенные объекты JavaScript, к которым Вы обращаетесь через свойство history объекта Window.

Описание

Чтобы изменить текущий URL окна без генерирования записи хронологии, Вы можете использовать метод Location.replace. Он заменяет текущую страницу на новую без генерирования записи хронологии. Смотрите Location.replace.

Вы можете ссылаться к записям хронологии используя массив Window.history. Этот массив содержит запись для каждого входа хронологии в исходном порядке. Каждая запись массива это строка, содержащая URL. Например, если список хронологии содержит три именованных записи, эти записи отражены как history[0], history[1] и history[2].

Если Вы обращаетесь к массиву history без определения элемента массива, браузер возвращает строку HTML, которая показывают таблицу URL, каждый из которых является ссылкой.

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

current
 Определяет URL текущей записи хронологии. 
length
 Отражает число записей в списке хронологии. 
next
 Определяет URL следующей записи хронологии. 
previous
 Определяет URL предыдущей записи хронологии.

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

back
 Загружает предыдущий URL в списке хронологии. 
forward
 Загружает следующий URL в списке хронологии. 
go
 Загружает URL из списка хронологии.

Примеры

Пример 1. Следующий пример загружает URL, который пользователь посетил три щелчка назад в текущем окне.

history.go(-3)
Пример 2. Вы можете использовать объект history со специфическим окном или кадром. Следующий пример заставляет window2 возвратиться на один элемент хронологии в окне (или сессии):

window2.history.back()
Пример 3. Следующий пример заставляет второй кадр в frameset возвратиться на один элемент:

parent.frames[1].history.back()
Пример 4. Следующий пример заставляет кадр, названный frame1, возвратиться на один элемент:

parent.frame1.history.back()
Пример 5. Следующий пример заставляет кадр, названный frame2 в window2, возвратиться на один элемент:

window2.frame2.history.back()
Пример 6. Следующий код определяет, содержит ли первая запись массива history строку "NETSCAPE". Если это так, вызывается функция myFunction.

if (history[0].indexOf("NETSCAPE") != -1) {
   myFunction(history[0])
}
Пример 7. Следующий пример показывает весь список хронологии:

document.writeln("<B>хронология </B> " + history)
Этот код показывает вывод, подобный следующему:

хронология 
Welcome to Netscape http://home.netscape.com/
Sun Microsystems http://www.sun.com/
Royal Airways http://www.supernet.net/~dugbrown/

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

 Location, Location.replace

Свойства

current

 Строка, определяющая полный URL текущей записи хронологии.

Свойство объекта History
Только для чтения
Реализовано в Navigator 3.0

Защита

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

Navigator 4.0: Получение значения этого свойства требует привилегию UniversalBrowserRead. Оно не имеет никакого значения, если Вы не имеете этой привилегии. Для информации о защите в Navigator 4.0, смотрите Главу 7, "Защита JavaScript," в Руководстве по JavaScript.

Примеры

Следующий пример определяет, содержит ли history.current строку "netscape.com". Если это так, вызывается функция myFunction.

if (history.current.indexOf("netscape.com") != -1) {
   myFunction(history.current)
}

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

 History.next, History.previous

length

Число элементов в массиве history.

Свойство объекта History
Только для чтения
Реализовано в Navigator 2.0

Защита

Navigator 4.0: Получение значения этого свойства требует привилегию UniversalBrowserRead. Для информации о защите в Navigator 4.0, смотрите Главу 7, "Защита JavaScript," в Руководстве по JavaScript.

next

Строка, определяющая полный URL следующей записи хронологии.

Свойство объекта History
Только для чтения
Реализовано в Navigator 3.0

Защита

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

Navigator 4.0: Получение значения этого свойства требует привилегию UniversalBrowserRead. Оно не имеет никакого значения, если Вы не имеете этой привилегии. Для информации о защите в Navigator 4.0, смотрите Главу 7, "Защита JavaScript," в Руководстве по JavaScript.

Описание

Свойство next отражает URL, который использовался бы, если бы пользователь выбрал "Вперед" из меню "Перейти".

Примеры

Следующий пример определяет, содержит ли history.next строку "NETSCAPE.COM". Если это так, вызывается функция myFunction.

if (history.next.indexOf("NETSCAPE.COM") != -1) {
   myFunction(history.next)
}

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

 History.current, History.previous

previous

Строка, определяющая полный URL предыдущей записи хронологии.

Свойство объекта History
Только для чтения
Реализовано в Navigator 3.0

Защита

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

Navigator 4.0: Получение значения этого свойства требует привилегию UniversalBrowserRead. Оно не имеет никакого значения, если Вы не имеете этой привилегии. Для информации о защите в Navigator 4.0, смотрите Главу 7, "Защита JavaScript," в Руководстве по JavaScript.

Описание

Свойство previous отражает URL, который использовался бы, если бы пользователь выбрал "Назад" из меню "Перейти".

Примеры

Следующий пример определяет, содержит ли history.previous строку "NETSCAPE.COM". Если это так, вызывается функция myFunction.

if (history.previous.indexOf("NETSCAPE.COM") != -1) {
   myFunction(history.previous)
}

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

 History.current, History.next

Методы

back

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

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

Синтаксис

back()

Параметры

 Нет.

Описание

Этот метод выполняет то же действие, как и пользователь, выбирающий кнопку "Назад" в браузере. Метод back тоже самое, что и history.go(-1).

Примеры

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

<P><INPUT TYPE="button" VALUE="< Перейти Назад"
   onClick="history.back()">
<P><INPUT TYPE="button" VALUE="> Перейти Назад"
   onClick="myWindow.back()">

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

 History.forward, History.go

forward

Загружает следующий URL в списке хронологии.

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

Синтаксис

forward()

Параметры

 Нет.

Описание

Этот метод выполняет то же действие, как и пользователь, выбирающий кнопку "Вперед" в браузере. Метод forward тоже самое, что и history.go(1).

Примеры

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

<P><INPUT TYPE="button" VALUE="< Вперед"
   onClick="history.forward()">
<P><INPUT TYPE="button" VALUE="> Вперед"
   onClick="myWindow.forward()">

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

 History.back, History.go

go

Загружает URL из списка хронологии.

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

Синтаксис

go(delta)
go(location)

Параметры

 

delta
 Целое число, представляющее относительную позицию в списке хронологии. 
location
 Строка, представляющая все или часть URL в списке хронологии.

Описание

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

Если параметр delta равен 0, браузер перезагружает текущую страницу. Если он целое число больше чем 0, метод go загружает URL, который находится впереди в списке хронологии на это число записей; иначе, он загружает URL, который находится ззади в списке хронологии на это число записей.

Параметр location это строка. Используйте location, чтобы загрузить самую похожую запись хронологии, чей URL содержит location как подстроку. При соответствии URL параметру location регистр не учитывается. Каждый раздел URL содержит различную информацию. Смотрите Location для описания компонентов URL.

Метод go создает новую запись в списке хронологии. Чтобы загрузить URL без создания записи в списке хронологии, используйте Location.replace.

Примеры

Следующая кнопка переходит к самой похожей записи хронологии, которая содержит строку "home.netscape.com":

<P><INPUT TYPE="button" VALUE="Перейти"
   onClick="history.go('home.netscape.com')">
Следующая кнопка переходит к URL, который на три входа назад в списке хронологии:

<P><INPUT TYPE="button" VALUE="Перейти"
   onClick="history.go(-3)">

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

 History.back, History.forward, Location.reload, Location.replace

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

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

Права © 1997 Netscape Communications Corporation


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