1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
---
title: History API
slug: Web/API/History_API
translation_of: Web/API/History_API
---
<div>{{DefaultAPISidebar("History API")}}</div>
<p>Об'єкт DOM {{DOMxRef("Window")}} надає доступ до сеансу історії браузера через об'єкт {{DOMxRef("Window.history","history")}}. Він має корисні методи та властивості, які дозволяють відкривати попередні і наступні сторінки з історії користувача та впливати на вміст стеку історії.</p>
<h2 id="Концепція_та_використання">Концепція та використання</h2>
<p><span class="VIiyi" lang="uk"><span class="ChMk0b JLqJ4b"><span>Навігація </span></span></span> по історії користувача здійснюється за допомогою методів {{DOMxRef("History.back","back()")}}, {{DOMxRef("History.forward","forward()")}} та {{DOMxRef("History.go","go()")}}.</p>
<h3 id="Навігація_вперед_і_назад"><span class="VIiyi" lang="uk"><span class="ChMk0b JLqJ4b"><span>Навігація вперед і назад</span></span></span></h3>
<p>Щоб відкрити попередню сторінку:</p>
<pre class="brush: js notranslate">window.history.back()
</pre>
<p>Цей метод діє так само, ніби реальний користувач натиснув кнопку <kbd><strong>Назад</strong></kbd> на панелі інструментів свого браузера.</p>
<p>Подібним чином можна відкрити наступну сторінку (кнопка <kbd><strong>Вперед</strong></kbd> на панелі інструментів):</p>
<pre class="brush: js notranslate">window.history.forward()
</pre>
<h3 id="Перехід_до_певної_точки_в_історії"><span class="VIiyi" lang="uk"><span class="ChMk0b JLqJ4b"><span>Перехід до певної точки в історії</span></span></span></h3>
<p>Щоб завантажити певну сторінку з історії сеансу використовується метод {{DOMxRef("History.go","go()")}}, передаючи як аргумент відносне положення до поточної сторінки (позиція поточної сторінки дорівнює <code>0</code>.)</p>
<p>Щоб повернутися на одну сторінку назад (еквівалент виклику {{DOMxRef("History.back","back()")}}):</p>
<pre class="brush: js notranslate">window.history.go(-1)
</pre>
<p><span class="VIiyi" lang="uk"><span class="ChMk0b JLqJ4b"><span>Перехід на сторінку вперед, подібно до виклику </span></span></span>{{DOMxRef("History.forward","forward()")}}:</p>
<pre class="brush: js notranslate">window.history.go(1)
</pre>
<p>Подібним чином можна рухатись на 2 сторінки вперед, передаючи як аргумент <code>2</code> тощо.</p>
<p>Ще одне застосування методу <code>go()</code> – оновлення поточної сторінки, використовуючи для цього аргумент <code>0</code>, або викликаючи метод без аргументу:</p>
<pre class="brush: js notranslate">// Наступний код
// оновить поточну сторінку
window.history.go(0)
window.history.go()
</pre>
<p>Кількість сторінок у стеку історії визначається значенням властивості <code>length</code>:</p>
<pre class="brush: js notranslate">let numberOfEntries = window.history.length
</pre>
<h2 id="Інтерфейси">Інтерфейси</h2>
<dl>
<dt>{{domxref("History")}}</dt>
<dd>Дозволяє управляти історією сеансу браузера (відвіданими сторінками у вкладці або фреймі, куди завантажується поточна сторінка).</dd>
</dl>
<h2 id="Приклади">Приклади</h2>
<p>В наступному прикладі призначається обробка подій через властивість <code>onpopstate</code> щоб проілюструвати деякі методи об’єкта історії для додавання, заміни та переміщення в історії браузера в поточній вкладці.</p>
<pre class="brush:js line-numbers language-js notranslate">window.onpopstate = function(event) {
console.log(`location: ${document.location}, state: ${JSON.stringify(event.state)}`)
}
history.pushState({page: 1}, "title 1", "?page=1")
history.pushState({page: 2}, "title 2", "?page=2")
history.replaceState({page: 3}, "title 3", "?page=3")
history.back() // виведе в консоль "location: http://example.com/example.html?page=1, state: {"page":1}"
history.back() // виведе в консоль "location: http://example.com/example.html, state: null"
history.go(2) // виведе в консоль "location: http://example.com/example.html?page=3, state: {"page":3}"</pre>
<h2 id="Специфікація">Специфікація</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Специфікація</th>
<th scope="col">Статус</th>
<th scope="col">Коментар</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName("HTML WHATWG", "browsers.html#history", "History")}}</td>
<td>{{Spec2("HTML WHATWG")}}</td>
<td>No change from {{SpecName("HTML5 W3C")}}.</td>
</tr>
<tr>
<td>{{SpecName("HTML5 W3C", "browsers.html#history", "History")}}</td>
<td>{{Spec2("HTML5 W3C")}}</td>
<td>Initial definition.</td>
</tr>
</tbody>
</table>
<h2 id="Сумісність">Сумісність</h2>
<p>{{Compat("api.History")}}</p>
<h2 id="Дивіться_також">Дивіться також</h2>
<h3 id="Довідка">Довідка</h3>
<ul>
<li>{{ domxref("window.history") }}</li>
<li>{{ domxref("window.onpopstate") }}</li>
</ul>
<h3 id="Посібник">Посібник</h3>
<ul>
<li><a href="/en-US/docs/Web/API/History_API/Working_with_the_History_API">Working with the History API</a></li>
</ul>
|
