Прагма директива refresh
Синтаксис
<head>
...
<meta http-equiv="refresh"
content="[значение]">
...
</head>
Описание
Прагма директива refresh
(от англ. "refresh" ‒ «обновить») устанавливает время редиректа и, при необходимости, URL-адрес страницы редиректа. Под временем редиректа подразумевается время по истечении которого произойдёт переадресация страницы. Под URL-адресом страницы редиректа подразумевается адрес страницы на которую произойдёт переадресация текущей страницы.
Примечание
Если страница редиректа не указана, то происходит автоматическое обновление текущей страницы через указанный промежуток времени. Такая особенность важна для ресурсов с быстро изменяющейся информацией (например, новостные ресурсы, ресурсы прогноза погоды, ресурсы курсов валют и прочие).
Поддержка браузерами
Спецификация
Верс. | Раздел | |
---|---|---|
HTML | ||
2.0 | Associated Meta-information: META | Перевод |
3.2 | META | |
4.01 | The META element http-equiv = name [CI]... DTD: Transitional
Strict
Frameset
|
|
5.0 | 4.2.5.3 Pragma directives http-equiv="refresh"... |
|
5.1 | 4.2.5.3. Pragma directives http-equiv="refresh"... |
|
XHTML | ||
1.0 | Extensible HyperText Markup Language DTD: Transitional
Strict
Frameset
|
|
1.1 | Extensible HyperText Markup Language |
Значения атрибута «content»
Атрибут «content
» должен иметь значение, являющееся строкой из регистронезависимых ASCII символов, которая состоит из следующих составляющих:
<число><разделитель><пробелы>url=<кавычка><URL><кавычка>
- <число>
- Указывает количество секунд до редиректа страницы. В качестве значения количества секунд указывается целое положительное число. Отсчёт времени до редиректа начинается с момента полной загрузки страницы.
<meta http-equiv="refresh" content="5">
- <разделитель>
- Отделяет числовое значение от URL-адреса редиректа. В качестве разделителя указывается символ «
;
» ТОЧКА С ЗАПЯТОЙ [U+003B] либо символ «,
» ЗАПЯТАЯ [U+002C].<meta http-equiv="refresh" content="2, URL=example.html"> <meta http-equiv="refresh" content="2; URL=example.html">
- <пробелы>
- ПРОБЕЛЫ [U+0020] отделяют символы друг от друга для лучшего визуального восприятия.
- <кавычка>
- Кавычки, окружающие URL-адрес страницы редиректа, для лучшего визуального восприятия. В качестве кавычки может указываться символ «
'
» АПОСТРОФ [U+0027] или символ «"
» ДВОЙНАЯ КАВЫЧКА [U+0022].Условие использования: кавычки, окружающие URL-адрес страницы, не должны совпадать с кавычками, обозначающими значение «
content
» атрибута.<meta http-equiv="refresh" content="2; URL='example.html'"> <meta http-equiv="refresh" content='2; URL="example.html"'>
- <URL>
- Допустимый URL-адрес страницы редиректа.
<meta http-equiv="refresh" content="2; URL=/index.html">
Примечание: URL-адреса некоторых ресурсов указываются с учётом регистра символов.
Условие использования: при указании URL-адреса, обязательно указывается «
<разделитель>
».
Регистр символов: не учитывается.
Пример использования
<html>
<head>
<meta charset="utf-8">
<title>Прагма директива refresh</title>
<meta http-equiv="refresh" content="5">
<script type="text/javascript" src="bgColor.js"></script>
</head>
<body onload="bgColor()">
<h1>Пример использования прагма директивы "refresh"</h1>
<p>В данном документе приводится пример прагма директивы редиректа.</p>
</body>
</html>