[pdoTools] 2.2.1 Улучшения ajax пагинации

Представляю вам новую версию pdoTools с небольшими улучшениями работы pdoPage в режиме ajax.

Первое изменение заключается в том, что все запросы теперь отправляются на отдельный файл-коннектор, который лежит в /assets/components/pdotools/. Во-первых, это ускоряет работу, потому что мы запускаем MODX в API_MODE и не выполняем все сниппеты на текущей странице, перед pdoPage.

А во-вторых, теперь режим ajax у pdoPage можно использовать при включенном Fenom в теле страницы. Кому интересно, вот подробности.

Второе изменение косметическое. Был добавлен параметр &ajaxHistory, который позволяет отключить сохранение номера страницы в url.

Зачем это нужно? Очень просто — для режимов scroll и button. Очень многие пользователи просили сделать так, чтобы можно было просто загружать результаты и сбрасывать всё при перезагрузке страницы.

По умолчанию &ajaxHistory пуст и ориентируется на параметр &ajaxMode: для default он включен, а для прокрутки и кнопки — отключен. Но вы можете и сами указать ему 0 или 1 при любом режиме работы.

Если &ajaxHistory отключен, то страницы в url не сохраняются, а значит и блок с постраничной навигацией не нужен — так что, он скрывается автоматически. Обратите внимание, что он по-прежнему необходим для правильной работы, но на странице его не видно.

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

Совсем мелкое изменение — добавление блоку-обёртке (по умолчанию это у нас #pdopage) класса loading при загрузке, чтобы вывести какой-нибудь индикатор. Например, вот так:

<div id="pdopage">
	<div class="rows">
		[[!pdoPage?
			&parents=`0`
			&ajaxMode=`scroll`
		]]
	</div>
	<div class="spinner"></div>
	[[!+page.nav]]
</div>

<style>
#pdopage .spinner {
	display: none;
	width: 32px;
	height: 32px;
	background: url('/inc/img/loading.gif') no-repeat;
	background-size: 32px;
}
#pdopage.loading .spinner {
	display: block;
	margin: 20px auto 10px auto;
}
</style>

Это можно было и раньше сделать через pdoPage.callbacks, но я решил что лишний класс не помешает.

Оценить pdoPage в &ajaxMode=`scroll` можно прямо здесь, в разделе последних комментариев. Если вдруг что-то не работает — почистите кэш своего браузера.

Версия 2.2.2

Добавил еще один параметр в pdoPage для указания схемы генерации ссылки на страницу &pageLinkScheme. Теперь легко можно делать человекопонятную навигацию, если захочется.

Документация здесь.

&ajax=`1`

$.get('?page=3', function(response) {
 своя логика без переделывания стандартного скрипта
}

site.ru/news?page=1

site.ru/news