介绍

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

需要具备基础的html & javascript 知识。如果你连divscript标签仍然不认识,请忽略该篇文章。

一、实现

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的后面
(或者自己下载这个项目里的jshttps://github.com/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.ihewro.com']"
  • [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.jsjquery.pjax.min.js 的后面

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

其中#pjax-container是你的局部刷新部分,你可能没有这个div,你自己在添加一个<div id="pjax-container"></div>包裹住你想局部刷新的部分就行了!

二、加载动画

pjax项目还提供了一些pjax事件。以便在pjax执行前后加载一些东西。

加载动画只需要使用这两个事件pjax:sendpjax: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:http://ricostacruz.com/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.ihewro.com/duoshuo/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.ihewro.com/duoshuo/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.ihewro.com/duoshuo/embedhw4.min.js"); }
});//多说模块重载

</script>

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

最后修改:2022 年 10 月 16 日
喜欢我的文章吗?
别忘了点赞或赞赏,让我知道创作的路上有你陪伴。