:~$ newsletter --subscribe
cat ~/artykuly/frontend/automatyczne-odswiezanie-strony-co-x-sekund.md

Automatyczne odświeżanie strony co x sekund

Aby narzucić automatyczne odświeżanie strony co x sekund należy użyć poniższego kodu:

HTML

html
<meta http-equiv="refresh" content="x">

PHP

php
header('refresh: x;');

JavaScript

javascript
<script type="text/javascript">
window.setInterval(function () {
    location.reload();
}, x);
</script>

W miejscu x należy podać czas (w sekundach, dla języka JavaScript milisekundy – 1 minuta = 60 000 milisekund), po jakim strona ma zostać odświeżona.

Odświeżanie z licznikiem i zatrzymaniem

Podstawowy setInterval z przykładu wyżej działa, ale w praktyce przydaje się nieco więcej kontroli. Poniższy wariant pokazuje odliczanie do odświeżenia i pozwala je zatrzymać przyciskiem, co ratuje użytkownika, który właśnie coś czyta:

html
<p>Odświeżenie za <span id="licznik">30</span> s
   <button id="stop">zatrzymaj</button></p>

<script>
let sekundy = 30;
const timer = setInterval(() => {
    sekundy--;
    document.getElementById("licznik").textContent = sekundy;
    if (sekundy <= 0) location.reload();
}, 1000);

document.getElementById("stop").addEventListener("click", () => {
    clearInterval(timer);   // koniec odliczania
});
</script>

Odświeżanie fragmentu strony zamiast całości

Pełne przeładowanie strony co kilka sekund bywa uciążliwe: mignięcie, utrata pozycji przewijania, ponowne pobranie wszystkich zasobów. Współcześnie częściej odświeża się sam fragment danych, pobierając go w tle przez fetch:

javascript
setInterval(async () => {
    const odpowiedz = await fetch("/api/status");
    const dane = await odpowiedz.text();
    document.getElementById("status").innerHTML = dane;
}, 10000);   // co 10 sekund

Strona pozostaje na miejscu, a zmienia się tylko zawartość elementu #status. Tak działają na przykład tablice odjazdów czy panele z notowaniami.

Ręczne odświeżanie: skróty i twarde przeładowanie

Skoro już jesteśmy przy odświeżaniu, przypomnijmy skróty klawiszowe, o które często pytacie:

  • F5 lub Ctrl + R – zwykłe odświeżenie strony (na Macu Cmd + R),
  • Ctrl + F5 lub Ctrl + Shift + R – tak zwane twarde odświeżenie, które pomija pamięć podręczną przeglądarki i pobiera wszystko od nowa (na Macu Cmd + Shift + R). To pierwszy krok, gdy strona „nie widzi” wprowadzonych zmian.

Którą metodę wybrać?

  • Meta refresh (HTML) – najprostszy, działa bez JavaScriptu. Dobry do stron-przekierowań i prostych tablic informacyjnych. Wadą jest brak kontroli: użytkownik nie może odliczania zatrzymać.
  • header() w PHP – to samo co meta refresh, tylko ustawiane po stronie serwera, zanim strona dotrze do przeglądarki.
  • JavaScript z location.reload() – pełna kontrola (licznik, warunki, zatrzymanie), ale wciąż przeładowuje całą stronę.
  • fetch fragmentu – najlepsze wrażenia dla użytkownika, gdy zmienia się tylko część danych. Wymaga punktu na serwerze, który te dane zwraca.

Jedna uwaga na koniec: automatyczne odświeżanie całej strony utrudnia korzystanie z niej osobom używającym czytników ekranu i potrafi zaskoczyć każdego, kto właśnie wypełnia formularz. Jeżeli tylko możemy, wybierajmy odświeżanie fragmentu albo dawajmy użytkownikowi przycisk do zatrzymania.

udostępnij: ·
Łukasz Dudziński
Łukasz Dudziński · założyciel i autor
Pasjonat informatyki, a zwłaszcza programowania. Zwariowany maniak na tle nowych technologii oraz komputerów. W wolnych chwilach bloger... więcej-o-mnie →
ls ~/artykuly/powiazane --limit 3
komentarze --count 4
rss dla komentarzy →
Franky2013-05-19 ·

Jak już tworzyć artykuł nt. automatycznego odświeżania to warto napisać jak zrobić to w JavaScript oraz PHP a nie sam nagłówek w HTML.

lukasz.dudzinski2013-05-19 ·

Jutro postaram się zaktualizować ten wpis o JavaScript i PHP

Michalu Robakoo Freeman2019-05-30 ·

a jak kto wkleić w html? bede wdzięczny za materiał.

lukas1242019-05-31 ·

Cześć! W sekcji po prostu wstawiasz . Więcej na temat struktury strony w HTML przeczytasz w artykule: http://strefakodera.pl/tworzenie-stron-www/html-5/podstawowy-szkielet-strony-internetowej-oparty-o-html-5

dodaj-komentarz

Komentarze są moderowane. Podane dane przetwarzamy wyłącznie w celu publikacji komentarza (polityka prywatności).