Typecho开启全站Pjax

⚠️ 本文最后更新于2024年07月09日，已经过了135天没有更新，若内容或图片失效，请留言反馈

官方介绍：pushState + ajax = pjax 带来最直观的效果是整个网站变成单页应用。这样的效果将会极大的提升用户体验，并且可以减少https的请求的次数和内容。使用github上面的一个开源项目defunkt/jquery-pjax 可以很轻松的帮助我们实现pjax。

注意：需要具备基础的html & javascript 知识。如果你连div和script标签仍然不认识，请忽略该篇文章。

一、实现
js文件引入
1.引入jquery.min.js

<script src="//cdn.bootcss.com/jquery/2.1.4/jquery.min.js"></script>

放在footer.php里就好。或者放在header.php都行！(不使用cdn提供的地址也可以，可以使用自己空间上传的js地址,下同)

2.引入jquery.pjax.js：

    <script src="//cdn.bootcss.com/jquery.pjax/1.9.6/jquery.pjax.min.js"></script>

同样的，放在header.php或者footer.php都行。但一定要放在jquery.min.js的后面
（或者自己下载这个项目里的js，这个defunkt/jquery-pjax项目里面下载里面的jquery.pjax.js）

如何使用
在footer.php里面加上这段代码就初步成功。【继续往下看！尤其是container的介绍】

    <script>$(document).pjax(selector, [container], options)</script>

selector 给哪些selector绑定pjax事件，一般的为："a", 如果要去掉一些外连的URL，这里的selector可以为: "a[href^='http://www.sej.cn']"
[container] 内容变换容器，是指哪个容器里的内容发生的变换，如： '#pjax-content'。就是页面中只刷新的这个部分。
options 官方文档提供了更多的选项，以便更好地自定义选项。具体查考官方文档。以下列出我使用的一些选项。
container 替换的容器的css选择器。填你的替换容器ID即可。
timeout 超时就会被迫页面就会完全刷新，单位毫秒。
fragment 这个作为整个pjax框架，必须写上。

所以，代码可以这样写

    <script>
        $(document).pjax('a[href^="<?php Helper::options()->siteUrl()?>"]:not(a[target="_blank"], a[no-pjax])', {
        container: '#pjax-container',
        fragment: '#pjax-container',
        timeout: 8000})
    </script>

一定要放在jquery.min.js 和 jquery.pjax.min.js 的后面

解释一下上面代码：<?php Helper::options()->siteUrl()?>是typecho的自带函数，调用本站的首页地址！也就是只对本站的，并且没有_blank属性的，标签里不含no-pjax的链接实行pjax！局部刷新的区域是#pjax-container的部分！

其中#pjax-container是你的局部刷新部分，你可能没有这个div，你自己在添加一个

包裹住你想局部刷新的部分就行了！

二、加载动画
pjax项目还提供了一些pjax事件。以便在pjax执行前后加载一些东西。
加载动画只需要使用这两个事件pjax:send和pjax:complete
如我之前写的：

<script>
    (document).on('pjax:send',
    function() {
    $('#loader-wrapper').addClass("in");})
    $(document).on('pjax:complete',
    function() {
    $('#loader-wrapper').removeClass("in");}）
</script>

解释一下上面代码：就是在pjax执行开始的时候，给#loader-wrapper加上in的样式名称。在pjax结束的时候给给#loader-wrapper去掉in的样式名称，这样就有了加载出现动画，加载后动画消失的效果。

我目前主题"Leaf"使用的加载动画来自这儿：nprogress:
nprogress使用起来更简单。在pjax:send的事件里面添加：NProgress.start(); .在pjax:complete的事件里面添加：NProgress.done();
更多使用方法点开链接，看一下github的说明就行！

三、一些问题的解决
pjax采用的是异步请求资源，也就是每次请求数据不是重新获取整个页面的数据而是只会获取#pjax-container容器里面的数据。所以如果一个函数在容器外面（如多说加载函数），在A页面没有，B又需要的话，那么从A页面进入B页面，这个函数就不会执行。必须回调这个函数。

注：不同主题对于#pjax-container选取不一样以及结构可能不同解决方法会有不同（一般是差不多的）

在pjax:complete事件里面加上这段代码

    if ($('.ds-thread').length > 0) { if (typeof DUOSHUO !== 'undefined') DUOSHUO.EmbedThread('.ds-thread'); else $.getScript("https://www.sej.cn/embedhw4.min.js"); }
    })

其他的js失效问题
在pjax:complete事件重载相关函数即可。

<script>
$(document).on('pjax:complete',function() {
    GenerateContentList();
    setupContents();
    rebindEvents();
    if ($('.ds-thread').length > 0) { if (typeof DUOSHUO !== 'undefined') DUOSHUO.EmbedThread('.ds-thread'); else $.getScript("https://www.sej.cn/embedhw4.min.js"); }})
</script>

所以，最后我的pjax代码就是酱紫的！

<script>
//pjax 刷新
$(document).pjax('a[href^="<?php Helper::options()->siteUrl()?>"]:not(a[target="_blank"], a[no-pjax])', {
    container: '#pjax-container',
    fragment: '#pjax-container',
    timeout: 8000
}).on('pjax:send',
function() {
    NProgress.start();//加载动画效果开始
}).on('pjax:complete',
function() {
NProgress.done();//加载动画效果结束
imageeffct();//灯箱函数重载
 setupContents();//某个函数重载
lue();//lue函数重载
reHighlightCodeBlock();//代码高亮函数重载
if ($('.ds-thread').length > 0) { if (typeof DUOSHUO !== 'undefined') DUOSHUO.EmbedThread('.ds-thread'); else $.getScript("https://www.sej.cn/embedhw4.min.js"); }
});//多说模块重载
</script>

至此！享受你的pjax无刷新技术吧！

By 懒人 On 2023年6月19日