location NN 2   IE 3   DOM 1

Для каждого окна или фрейма свой объект location. Объект запоминает всю информацию о URL документа, в загруженного настоящее время в окно или фрейм. Назначая новый URL свойству href объекта location, Вы инструктируете браузер загружать новую страницу в окно или фрейм. Синтаксис:

location.href = "newPage.html"

Сценарий в одном фрейме может ссылаться на объект location другого фрейма, чтобы загрузить новый документ в тот фрейм:

parent.otherFrameName.location.href = "newPage.html"

Ограничения защиты запрещают сценарию в одном фрейме доступ к объекту location в другом фрейме, если документ во втором фрейме - не в том же домене, что и документ со сценарием. Это предотвращает действия жулика по контролю передвижения в другом фрейме к внешним узлам web. В Navigator 4 Вы можете преодолевать ограничение защиты с помощью подписанных сценариев, но пользователь все Равно должен дать явное разрешение на это.

 
 
Объектно-ориентированная модель
NN [windowRef.]location
IE [windowRef.]location

Свойства:


hash NN 2   IE 3   DOM 1
 Чтение/Изменение
 

Та часть URL после символа #, которая соответствует местоположению якоря в документе. Это свойство содержит данные, только если пользователь явно переместился к якорю, а не доскроллил до него. При установке свойства Не включайте символ #.

 
Пример:

location.hash = "section3"

 
Возвращаемое значение: Строка.
 
Значение по умолчанию: Ничего.

host NN 2   IE 3   DOM 1
 Чтение/Изменение
 

Комбинация имени хоста и порта (если определён) сервера, который хостит текущий документ. Если порт - явная часть URL, имя хоста и порт отделены двоеточием, так же, как они находились бы в URL.

 
Пример:

if (location.host = "www.megacorp.com:80") { ... }

 
Возвращаемое значение:
Строка имени хоста, иногда сопровождаемого двоеточием и номером порта.
 
Значение по умолчанию: В зависимости от сервера.

hostname NN 2   IE 3   DOM 1
 Чтение/Изменение
 

Hostname сервера (то есть, "двухточечный" адрес, состоящий из имени сервера и домена), который обслуживает текущий документ. Свойство hostname не включает номер порта.

 
Пример:

if (location.hostname = "www.megacorp.com") { ... }

 
Возвращаемое значение:
Строка имени хоста (сервер и домен).
 
Значение по умолчанию: В зависимости от сервера.

href NN 2   IE 3   DOM 1
 Чтение/Изменение
 

Полный URL документа, загруженного в окно или фрейм. Назначение URL этому свойству - сценарий передвижения, т.е. загрузки нового документа в окно или фрейм (хотя Internet Explorer также предлагает эквивалент - метод window.navigate() ).

 
Пример:

location.href = "http://www.megacorp.com"

 
Возвращаемое значение:
Строка полного или относительного URL.
 
Значение по умолчанию: Ничего.

pathname NN 2   IE 3   DOM 1
 Чтение/Изменение
 

Pathname - компонент URL. Он состоит информации URL после последнего символа имени домена, включая начальный символ косой черты.

 
Пример:

location.pathname = "/images/logoHiRes.gif"

 
Возвращаемое значение: Строка.
 
Значение по умолчанию: Ничего.

port NN 2   IE 3   DOM 1
 Чтение/Изменение
 

Компонент URL порта, если тот существует. Он состоит из информации URL после двоеточия (после последнего символа имени домена). Двоеточие - не часть значения свойства порта.

 
Пример:

location.port = "80"

 
Возвращаемое значение:
Строка (числовое значение как строка).
 
Значение по умолчанию: Ничего.

protocol NN 2   IE 3   DOM 1
 Чтение/Изменение
 

Компонент URL протокола. Он состоит из информации URL до первого двоеточия, включая него. Типовые значения: " HTTP: ", " file: ", " ftp: ", и " mailto: ".

 
Пример:

if (location.protocol == "file:") { statements for treating document as local file }

 
Возвращаемое значение: Строка.
 
Значение по умолчанию: Ничего.

search NN 2   IE 3   DOM 1
 Чтение/Изменение
 

УРЛ-КОДИРОВАННАЯ часть URL, которая начинается с символа ?. Документ, который обслуживается как результат поиска, также может иметь часть search доступной как часть свойства window.location. Вы можете изменять это свойство сценарием. Изменение посылает URL и критерии поиска на сервер. Вы должны знать формат данных (обычно пара "имя/значение"), ожидаемый сервером, чтобы исполнить это должным образом.

 
Пример:

location.search="?p=Tony+Blair&d=y&g=0&s=a&w=s&m=25"

 
Возвращаемое значение:
Строка, начинающаяся с символа ?.
 
Значение по умолчанию: Ничего.

Методы:


assign( ) NN 2   IE 3   DOM n/a

assign("URL")

Этот метод был предназначен, чтобы быть скрытым от скриптеров, но пока остается доступным. Он выполняет то же самое действие как назначение URL свойству location.href . Метод assign( ) включён в описание для полноценности и не должен использоваться.

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

reload( ) NN 3   IE 4   DOM 1

reload([unconditional])

Выполняет жесткую перезагрузку документа, связанного с объектом location. Этот вид перезагрузки возвращает элементы форм к их значениям по умолчанию (для мягкой перезагрузки используйте history.go(0)). По умолчанию метод reload( ) исполняет действие, полученное условным выражением, которое отыскивает файл в кэше браузера, если файл все еще в там (и кэш включен). Чтобы вызвать перезагрузку от сервера, установите unconditional-GET = true.

 
Возвращаемое значение
None.
 
Параметры
unconditional Дополнительное Булево значение. Если true, браузер выполняет unconditional-GET, чтобы вызвать перезагрузку документа от сервера.

replace( ) NN 3   IE 4   DOM 1

replace("URL")

Загружает новый документ в текущее окно и заменяет хронологию браузера. Таким образом, промежуточная страница, которая необходима, окажется в хронологии (не предотвращает от нажатия на кнопку Back), заменив там предыдущий документ.

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


HIVE: All information for read only. Please respect copyright!
Hosted by hive КГБ: Киевская городская библиотека