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




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

History

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

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

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

JavaScript 1.0

JavaScript 1.1: добавлены свойства current, next и previous.

Создание

Объекты History являются предопределёнными объектами JavaScript, доступ к которым Вы можете получить через свойство history объекта window.

Описание

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

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

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

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

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

Специфицирует URL текущего вхождения в history.

length

Отражает количество вхождений в списке history.

next

Специфицирует URL следующего вхождения в history.

previous

Специфицирует URL предыдущего вхождения в history.

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

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

Загружает предыдущий URL из списка history.

forward

Загружает следующий URL из списка history.

go

Загружает URL из списка history.

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

Примеры

Пример 1. Здесь выполняется переход к URL , который был посещён пользователем в текущем окне на три шага назад.

history.go(-3)

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

window2.history.back()

Пример 3. В этом примере второй фрэйм в наборе фрэйма переходит назад на один элемент:

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. Здесь отображается весь список history:

document.writeln("<B>history is</B> " + history)

Этот код отобразит примерно такое:

history is
Welcome to Netscape http://home.netscape.com/
Sun Microsystems http://www.sun.com/
Royal Airways http://www.supernet.net/~dugbrown/

См. также

Location, Location.replace

back


Загружает предыдущий URL из списка history.

Метод из

History

Реализован в

JavaScript 1.0

Синтаксис

back()

Параметры

Отсутствуют.

Описание

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

Пример

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

<P><INPUT TYPE="button" VALUE="< Go Back"
   onClick="history.back()">
<P><INPUT TYPE="button" VALUE="> Go Back"
   onClick="myWindow.back()">

См. также

History.forward, History.go

current


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

Свойство из

History

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

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

JavaScript 1.1

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

Получение значения этого свойства требует привилегии UniversalBrowserRead. Оно не имеет значения, если у Вас нет этой привилегии. О безопасности см. книгу Клиентский JavaScript. Руководство.

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

Пример

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

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

См. также

History.next, History.previous

forward


Загружает следующий URL из списка history.

Метод из

History

Реализован в

JavaScript 1.0

Синтаксис

forward()

Параметры

Отсутствуют.

Описание

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

Пример

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

<P><INPUT TYPE="button" VALUE="< Forward"
   onClick="history.forward()">
<P><INPUT TYPE="button" VALUE="> Forward"
   onClick="myWindow.forward()">

См. также

History.back, History.go

go


Загружает URL из списка history.

Метод из

History

Реализован в

JavaScript 1.0

Синтаксис

go(delta)
go(location)

Параметры

delta

Целое число - относительная позиция в списке history.

location

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

Описание

Метод go переходит к точке списка history, определённой специфицированным параметром.

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

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

Метод go создаёт новое вхождение в списке history. Для загрузки URL без создания вхождения в списке history используйте Location.replace.

Примеры

Эта кнопка делает переход к ближайшему вхождению из history, которое содержит строку "home.netscape.com":

<P><INPUT TYPE="button" VALUE="Go"
   onClick="history.go('home.netscape.com')">

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

<P><INPUT TYPE="button" VALUE="Go"
   onClick="history.go(-3)">

См. также

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

length


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

Свойство из

History

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

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

JavaScript 1.0

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

Получение значения этого свойства требует привилегии UniversalBrowserRead. О безопасности см. книгу Клиентский JavaScript. Руководство.

next


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

Свойство из

History

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

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

JavaScript 1.1

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

Получение значения этого свойства требует привилегии UniversalBrowserRead. Оно не имеет значения, если у Вас нет этой привилегии. О безопасности см. книгу Клиентский JavaScript. Руководство.

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

Описание

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

Примеры

Здесь определяется, содержит ли history.next строку "NETSCAPE.COM". Если да - вызывается функция myFunction.

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

См. также

History.current, History.previous

previous


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

Свойство из

History

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

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

JavaScript 1.1

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

Получение значения этого свойства требует привилегии UniversalBrowserRead. Оно не имеет значения, если у Вас нет этой привилегии. О безопасности см. книгу Клиентский JavaScript. Руководство.

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

Описание

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

Пример

Здесь определяется, содержит ли history.previous строку "NETSCAPE.COM". Если да - вызывается функция myFunction.

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

См. также

History.current, History.next
Оглавление | Назад | Вперёд | Индекс

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

History

страницы в данном разделе 
 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  справочник программиста