СПРАВОЧНИК

объект window

Объект window находится в вершине иерархии и содержит в себе все другие объекты браузера:

Объект window описывает текущее окно браузера и его содержимое.

Справочные разделы снабжены иллюстрирующими примерами с пометками:

• IE — пример работает в браузере Microsoft Internet Explorer
• NN — пример работает в браузере Netscape Navigator

Если рядом с пометкой стоит цифра, то она обозначает версию браузера, начиная с которой метод или свойство работают корректно. Если цифры нет, описание действует в браузерах начиная с версии 3.

Перейдя на страницу примера, можно посмотреть исходный текст программы, выбрав позицию В виде HTML в меню браузера Вид.

свойства объекта

методы объекта

открыть новое окно и закрыть его

var переменная = open();
var переменная = open(файл);
var переменная = open(файл, имя_окна);
var переменная = open(файл, имя_окна, параметры_окна);

переменная.close();

• переменная — экземпляр создаваемого окна.
• файл — строка, имя файла, который нужно отобразить в созданном окне. Если параметр не задан, создается пустое окно.
• имя_окна — строка, имя окна; используется для обращения к созданному окну (значение свойства name объекта window).
• параметры_окна — строка, свойства окна; когда параметр не задан, используются свойства окна по умолчанию.

параметры окна задаются в строке параметры_окна в виде:

"параметр1=значение1,параметр2=значение2,...,параметрN=значениеN"

Замечание. Не рекомендуется оставлять пробел после разделительной запятой.

Описание параметров:

Поработайте на приведенном ниже испытателе, чтобы лучше понять смысл этих параметров. В качестве файла, задающего содержимое окна, можно указать:

• HTML-файл, например, 0106.htm
• картинку, например, ./pic/explorer.gif
• текстовый файл, например, 0207.txt

var win = open("", "",
     "width      = height     =" +
     "left       = top        =" +
     "scrollbars = resizable  =" +
     "menubar    = location   =" +
     "status     = toolbar    ="+
     "fullscreen =");

Замечание. В испытателе строка параметры_окна представлена в виде “суммы” (конкатенации) строк для удобства размещения испытателя на экране. Так можно делать и в своих программах, чтобы в HTML-файле не было слишком длинных строчек. Там, где требуется разместить строку, всегда можно написать несколько строчек, соединяя их знаком “+”.

Метод close закрывает открытое окно. При этом обращение close() или window.close() закрывает текущее окно. Обращение win.close() или window.win.close() — закрывает окно win, которое было создано из текущего окна при помощи метода open.

диалоговые окна

alert(сообщение);
var переменная = confirm(сообщение);
var переменная = prompt(сообщение);
var переменная = prompt(сообщение, ввод_по_умолчанию);

• сообщение — произвольное строковое выражение.
• ввод_по_умолчанию — произвольное строковое выражение.

Функция alert выводит на экран модальное окно с заданным сообщением. Внутри окна — всего одна кнопка Ok. Пользователь читает сообщение и убирает окно нажатием на кнопку Ok или клавишей Esc на клавиатуре.

alert("\nЯ скачу, но \я скачу иначе,\n"+
      "По пол\ям, по лужам, по росе...\n"+
      "Говор\ят: он иноходью скачет.\n"+
      "Это значит иначе, чем все.\n\n"+
      "В.Высоцкий");

Функция confirm выводит на экран модальное окно с заданным сообщением-вопросом. Внутри окна — две кнопки Ok и Отмена. Функция возвращает:

• true, если нажата кнопка Ok;
• false, если нажата кнопка Отмена или клавиша Ecs.

if(confirm("Вам квасу?")) alert("Квас кончилс\я!");
else                      alert("А кваса все равно нет!");

Функция prompt выводит на экран модальное окно с заданным сообщением и строкой ввода. Внутри окна — кнопки Ok и Отмена. Функция возвращает:

• содержимое строки ввода, если нажата кнопка Ok;
• null, если нажата кнопка Отмена или клавиша Ecs.

var str = prompt("Как теб\я зовут?", "Вен\я");
if(str==null) alert("А \я хотел познакомитьс\я!");
else          alert("Товарищ "+str+
                    "!\nУ теб\я спина бела\я!");

модальные диалоговые окна

var переменная = showModalDialog(файл, аргумент, параметры_окна);

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

параметры окна задаются в строке параметры_окна в виде:

"параметр1=значение1;параметр2=значение2;...;параметрN=значениеN"

Замечание. Не рекомендуется оставлять пробел после разделительной точки с запятой.

Описание параметров:

В качестве примера использования метода рассмотрим построение собственной функции, подобной встроенной функции prompt.

Опишем эту функцию так:

/* Параметры функции:
   message      - надпись на панели
   defaultInput - ввод пользователя по умолчанию
   features     - параметры модального окна

   Возвращает:
   - null, если нажата кнопка "Отмена" или клавиша "Esc".
   - строку, которую ввел пользователь, если нажата кнопка "Ok".
   - undefined, если пользователь закрыл окно самостоятельно.
*/

function myprompt(message, defaultInput, features)
{
  var args = new Array(message, defaultInput);
  return window.showModalDialog("myprompt.htm", args, features);
}

Функция myprompt переадресует свои аргументы методу showModalDialog при этом:

• В качестве файла, наполняющего модальное окно, используется файл myprompt.htm, подготовленный специальным образом.
  
  
• В качестве второго аргумента передается массив, состоящий из двух элементов — двух строк: message и defaultInput. Как эти аргументы принимаются в документе myprompt.htm для отображения на экране и как строка ввода возвращает свое значение в качестве результата функции showModalDialog, смотрите в исходном тексте файла myprompt.htm.

Ниже приводится испытатель для функции myprompt.

var ret=myprompt(
  "<IMG src=pic/explorer.gif width=125 height=82 alt =''>
Как звали <EM>кассира</EM>?
",

  "",

  "");
alert(ret);

Замечание. При задании координат и размеров окна используйте следующие обозначения для единиц измерения:

• in — дюймы
• cm — сантиметры
• px — пикселы
• em — кегель текущего шрифта

перемещение фокуса

Метод focus перемещает фокус на окно, по отношению к которому этот метод используется. Когда окно создается, оно автоматически становится активным, получает фокус. Метод blur действует обратным образом: уводит фокус из того окна, по отношению к которому применяется.

Создаем пустое окно, но фокус оставляем в текущем окне:

var newWin;
var okno = "scrollbars=0,fullscreen=0,status=0,toolbar=0,"+
           "top=0,left=0,width=580,height=120,resizable=1";
newWin=window.open("", null, okno);
self.focus();

Переместим фокус в созданное окно:

newWin.focus();

Уберем фокус из созданного окно:

newWin.blur();

Выведем что-нибудь в созданное окно:

newWin.document.open();
newWin.document.write("<BODY background=./pic/paper.gif>"+
                      "<IMG src=./pic/roboland.jpg"+
                      " width=520 height=80 border=0"+
                      " alt=''></BODY>");
newWin.document.close();

newWin.focus();

newWin.close();

скроллирование

scroll(координата_по_горизонтали, координата_по_вертикали);
scrollBy(смещение_по_горизонтали, смещение_по_вертикали);

Координаты и смещения задаются в пикселах.

Создаем окно, содержимое которого задается файлом win04.htm:

var newWin;
var okno = "scrollbars=1,fullscreen=0,status=1,toolbar=1,"+
           "top=0,left=0,width=600,height=300,resizable=1";
newWin=window.open("win04.htm", null, okno);

Устанавливаем вертикальную линейку протяжки так, чтобы документ в окне начинался через определенное число пикселов по вертикали. Метод scroll производит абсолютную установку вне зависимости от первоначального положения документа в окне.

newWin.scroll(0,);
newWin.focus();

Метод scrollBy производит относительное перемещение документа в окне браузера. Попробуйте нажать кнопку Go несколько раз.

newWin.scrollBy(0,);
newWin.focus();

newWin.close();

таймеры

Метод setTimeout создает таймер, который выполняет заданные действия по истечении указанного числа миллисекунд. Метод clearTimeout выключает созданный таймер.

переменная = setTimeout("вызов_функции", число_миллисекунд);
clearTimeout(переменная);

Для выполнения действий, повторяющихся с определенным интервалом времени, используется метод setInterval. Метод clearInterval отключает действие метода setInterval.

переменная = setInterval("вызов_функции", число_миллисекунд);
clearInterval(переменная);

примеры

• Простой испытатель setTimeout и clearTimeout
• Часы-календарь
• Слайд-шоу в отдельном окне
• Слайд-шоу на той же странице