本教程中,我们将使用排队过程添加jQuery脚本文件,并将jQuery添加到您的WordPress页脚和标题中。
如果您在线搜索如何将jQuery脚本添加到WordPress,您将获得大量的结果。但是,如果你不是程序员或者不熟悉WordPress,你可能会发现在线资源有点难以理解。这是我们进来的地方。在今天的文章中,我们将展示如何将jQuery脚本添加到WordPress。但是,在开始之前,我们来看看jQuery和WordPress。
jQuery的流行是惊人的。那么为何不?它为开发人员开发Web应用程序提供了额外的优势。它也是最受欢迎的JavaScript库之一。这是一个较小的图书馆,也减少了加载时间。总之,为了加速WordPress,你需要使用jQuery。
使用jQuery可以快速完成诸如DOM操作,AJAX调用,动画和其他任务。简而言之,它有助于网站的发展。它是轻量级的,提供了更全面的插件,也适用于WordPress。
最初,WordPress不支持jQuery。然而,jQuery的普及和开发者的需求使得WordPress最终在他们的平台中包含了jQuery。它首次在WordPress 3.8.1中引入。之后,它几乎用于所有主题和插件。
如果您不确定如何开始使用jQuery,或者不知道如何将jQuery脚本添加到WordPress,我们将帮助您做到这一点。所以,没有任何进一步的延迟,让我们开始吧。
注意:我们建议不要在实时网站上尝试此操作。在上线之前试用你的本地WordPress安装。您也可以在尝试更改您网站上的任何代码之前创建备份!
如何添加jQuery脚本到WordPress
在WordPress中使用jQuery之前,我们需要了解兼容模式。由于WordPress是一个内容管理系统,它必须考虑整个系统内不同插件和主题之间的兼容性。为了确保jQuery按照预期工作并且不干扰其他插件,我们使用兼容模式。换句话说,它是确保它不与其他图书馆冲突的一种方法。
为了使兼容性有效,您不能$ 在代码中使用 符号。相反,你需要使用 jQuery。我们来看看下面的例子。
jQuery(document).ready(function($) {
$('#nav a').last().addClass('last');
})
下面给出了在没有兼容模式的情况下编写相同的代码。
$(document).ready(function($) {
$('#nav a').last().addClass('last');
})
基本上,该$ 标志的任何实例都 应该替换 jQuery 为使代码能够与Wordpress一起使用。
这是一个众所周知的事实,使用jQuery 每一次,而不是 $ 一个开发人员可能是一个令人沮丧的经历。此外,它使代码不必要的长。不过,$如果我们做一些调整,我们可以使用这个 标志。
在我们分享这个调整之前,让我们回顾一下jQuery sytax是如何工作的。如下所示。
$(selector).action()
现在,我们了解基本语法,让我们看看映射jQuery到 的代码 $。
(function($) {
$('.hideable').on('click', function() {
$(this).hide();
})
})( jQuery );
您需要将代码包装在匿名函数中。它只能在页脚中使用。
您需要将整个代码封装在文档就绪函数中,如下所示,以使jQuery在标头中工作。
jQuery(document).ready(function( $ ) {
$('.hideable').on('click', function() {
$(this).hide();
})
});
但是,我们不建议在标题中使用jQuery插件,因为这可能会降低您的网站速度。
由于每次都无法将jQuery推送到页脚和头文件,因此应该创建脚本文件并将它们集成到一起。为此,您首先需要创建一个JavaScript文件。该文件需要放入您打算使用的主题文件夹中。您还可以将文件保存在“.js”文件夹中,以保持干净和易于访问。
对于本教程,让我们命名文件“script_new.js”。它需要放置在主题文件夹的子文件夹中。那么,路径将如何看待?它将是theme / js / script_new.js。
该脚本可以是任何操作简单的HTML元素,以在屏幕上打印出“Hello,World”。这一切都取决于你想要做什么。
在我们继续前进之前,我们建议您 创建一个儿童主题。儿童主题将确保您的主要主题文件保持安全。但是,在创建它之前,请检查父主题是否已包含jQuery函数。
一旦完成,我们需要找到functions.php文件。这是所有魔法都会发生的文件。如果您无法找到任何名为“functions.php”的文件,请随时创建一个。
现在,将script_new.js文件加载到每个页面的标题; 您还需要在您的functions.php文件中添加以下代码。
<?php
function add_custom_script() {
wp_register_script('custom_script', home_url() . '/wp-content/themes/theme/js/script_new.js', array( 'jquery' ), ‘1.0.0’, true);
wp_enqueue_script('custom_script');
}
add_action( 'wp_enqueue_scripts', 'add_custom_script' );
?>
上面的代码拉你的脚本文件并将其排入WordPress。这个过程被称为排队。
尽管我们建议手动集成jQuery,但您也可以使用插件来实现。我们建议的插件是Posts帖子中的jQuery。该插件是轻量级和直接的。您将可以毫无困难地使用它。使用此插件,您可以将自定义jQuery和JavaScript代码添加到您网站的任何页面,帖子或自定义帖子类型中。
您只需将自定义代码添加到插件代码编辑器即可。免费版本只支持jQuery和JavaScript,但你也可以试用PRO版本,它有更多的功能,包括CSS。
我们希望你喜欢这个教程。在本教程中,我们使用排队过程添加了jQuery脚本文件。我们还讨论了如何在WordPress主题的页眉和页脚中添加jQuery代码。此外,我们还介绍了使用称为“帖子页面中的jQuery”的简单插件添加jQuery代码。
不多说,还是先看看效果图吧:
国际化效果图
如图所示,通过改变地址栏 local 的值即可切换语言,下面我贴一下具体的代码:
<div> <span class="ch-i18n" data-i18nkey="today">今天</span> </div> <div> <input type="text" class="ch-i18n" data-i18nkey="emailLabel" placeholder="请输入邮箱"> </div> <div> <input type="submit" class="ch-i18n" data-i18nkey="submit" value="提交"> </div> <div> <label> <input type="radio"><span class="ch-i18n" data-i18nkey="man">男</span> </label> <label> <input type="radio"><span class="ch-i18n" data-i18nkey="woman">女</span> </label> </div> <div> <label> <input type="checkbox"><span class="ch-i18n" data-i18nkey="apple">苹果</span> </label> <label> <input type="checkbox"><span class="ch-i18n" data-i18nkey="banana">香蕉</span> </label> </div> <div id="insert"></div> <input type="button" id="btn1" class="ch-i18n" data-i18nkey="button" value="插入HTML"> <div id="placeholder"></div> <input type="button" id="btn2" value="替换文本中的占位符"> <script src="./js/jquery-1.8.1.js"></script> <script src="./js/i18n.js"></script> <script> $(function () { var chI18n = CHI18n("login"); // 动态插入数据 $("#btn1").click(function () { $("#warning").show(); $("#insert").html('<span>'+chI18n.get("insert")+'</span>'); }); $("#btn2").click(function () { $("#placeholder").html(chI18n.get("msg" , {name:'king',age:24,sex:'男'})); }); }) </script>
如代码所示,需要国际化的标签,需要注意下面这几点:
{ "login":{ "today":"今天", "submit":"提交", "emailLabel":"请输入邮箱", "apple":"苹果", "banana":"香蕉", "woman":"女", "man":"男", "button":"按钮", "insert":"动态插入信息", "msg":"我叫{{name}},今年{{age}}岁,性别{{sex}}" } }
这是我们一个简单的国际化语言文件的格式(英文的跟这个一样,我就不贴出来了),我们通过 data-i18nkey 属性绑定这些 key ,然后 i18n.js 就能自动去解析,并显示每个标签所需要显示的文本。
(function () { var i18n = null ; var SELECTOR = ".ch-i18n"; var ATTR = "data-i18nkey"; var LANGUAGE_ARRAY = ['zh-cn','en-us']; var lang = LANGUAGE_ARRAY[0]; var LOCAL = "local"; var CHI18n = { get : function (key , obj) { var text = i18n[key] ; if(obj) { for(k in obj) { text = text.replace(new RegExp("\\{\\{" + k + "\\}\\}", "g"), obj[k]); } } return text ; } } // 我这里根据页面为单位,通过页面的唯一标识,去获取相应的国际化翻译 function CHI18nFactory (pageName) { if(!pageName || pageName == "") throw new Error("参数不能为空"); loadLanguage(pageName); return CHI18n ; } /** * 加载语言文件 */ function loadLanguage (pageName) { var search = window.location.search.replace("?",""); var param = search.split("&"); var index = param.findIndex(function (item) { return item.indexOf(LOCAL) != -1 ; }); if(index != -1) { var value = param[index].replace(LOCAL+"=",""); if(LANGUAGE_ARRAY.indexOf(value) != -1) { lang = value ; } } // 加载国际化文本 $.ajax({ url:'./i18n/'+lang+'.json', async:false, dataType:'json', success:function (data) { i18n = data[pageName] ; setLanguage(); } }); } /** * 替换带有 .ch-i18n[data-i18nkey] 类名和属性的标签内容 */ function setLanguage () { $(SELECTOR+'['+ATTR+']').each(function () { var value = $(this).attr(ATTR); if(value && value != "") { if(this.tagName.toLowerCase() === 'input') { if( $(this).attr("placeholder")) { $(this).attr("placeholder",i18n[value]); } else if($(this).attr("value")){ $(this).attr("value",i18n[value]); } } else { $(this).html(i18n[value]); } } }); } window.CHI18n = CHI18nFactory ; })();
对于i18n.js的实现其实很简单,就是通过 jquery 加载所有 class="ch-i18n" 的元素,然后获取该元素的 data-i18nkey 属性值,然后通过浏览器地址栏参数 local 的值去加载对应的国际化文件,通过 data-i18nkey 的值去获取对应的文本显示即可。
当然有时候国际化文本中的数据可能是动态的,存在占位符的情况,比如:
{
msg:"我叫{{name}},今年{{age}}岁,性别{{sex}}"
}
这里的name,age,sex 占位符的值需要我们在设置的时候手动传值进去,因此可以给 get 方法传递一个参数即可,如下:
chI18n.get("msg" , {name:'king',age:24,sex:'男'})
如上只是一种简单的国际化方案,如果你有其他更好的方式,欢迎留言交流。
最近写博客真的是太痛苦了,倒不是写博客本身,而是写完之后往多个平台发布的过程,一不注意就是十多分钟往上的时间消耗。
为了解决这个问题,之前立项的“解决自媒体一键多平台发布”项目必须得立刻着手完善了,争取早日让自己从发布这件事情上解脱出来专心写文章。
【hxsfx的JavaScript库】这个系列基本上是为“一键多平台发布”项目打基础用的。之所以把各个功能模块拆分出来,是为了尽量让小伙伴能够复制即用(在兼容性方面,因为个人能力的原因,几乎只会兼容Chrome浏览器)。
AJAX 是异步的 JavaScript 和 XML(Asynchronous JavaScript And XML),开发hxsfx.ajax库的主要目的就是希望通过异步加载HTML,从而尽量避免直接在js中写HTML来刷新页面内容。
hxsfx.ajax这个库与jquery的ajax功能基本一致,不过短时间内应该是写不到人家那么完善的。哈哈~
各位小伙伴别问,为什么不用jquery的ajax而要自己再写一个呢?
问就是,博主喜欢造轮子。开玩笑了~
其实原因是为了减少三方库的依赖,达到对项目的全面掌控。
项目地址:https://github.com/hxsfx/hxsfx_web_tools
要自己开发一个ajax库,需要借助Web API接口中的XMLHttpRequest(XHR)对象。
XMLHttpRequest(XHR)对象用于与服务器交互。通过 XMLHttpRequest 可以在不刷新页面的情况下请求特定 URL,获取数据。这允许网页在不影响用户操作的情况下,更新页面的局部内容。
//hxsfx.js
(function () {
window.hxsfx = {};
})();
//ajax.js
(function () {
window.hxsfx.ajax = {
};
})();
//ajax.js
(function () {
window.hxsfx.ajax = {
loadHTML: function (ele, url) {
}
};
})();
//ajax.js
(function () {
window.hxsfx.ajax = {
loadHTML: function (ele, url) {
const httpRequest = new XMLHttpRequest();
httpRequest.open('GET', url, true);
httpRequest.onreadystatechange = function () {
//为了让代码更健壮,使用try...catch来捕获返回状态判断和处理HTML代码的异常
try {
if (httpRequest.readyState === XMLHttpRequest.DONE) {
if (httpRequest.status === 200) {
//在这处理返回的HTML
}
}
else {
console.log("【ajax.get(" + url + ")请求出错】");
}
}
}
catch (ex) {
console.log("【ajax.get(" + url + ")异常】" + ex.message);
}
};
httpRequest.send();
}
};
})();
//ajax.js
//时间戳用来解决加载页面缓存的问题
var urlTimeStamp = "timeStamp=" + new Date().getTime();
url += ((url.indexOf('?') >= 0) ? "&" : "?") + urlTimeStamp;
//ajax.js
ele.innerHTML = httpRequest.responseText;
var scriptElements = ele.getElementsByTagName("script");
for (var i = 0; i < scriptElements.length; i++) {
var scriptElement = document.createElement("script");
scriptElement.setAttribute("type", "text/javascript");
var src = scriptElements[i].getAttribute("src");
if (src) {
//因为加载的src路径是之前相对加载HTML页面的,需要修改为当前页面的引用路径
src = url.substring(0, url.lastIndexOf('/') + 1) + src;
src += ((src.indexOf('?') >= 0) ? "&" : "?") + urlTimeStamp;
scriptElement.setAttribute("src", src);
}
var scriptContent = scriptElements[i].innerHTML;
if (scriptContent) {
scriptElement.innerHTML = scriptContent;
}
//用生成的script元素去替换html中的script标签,以此来激活script代码
ele.replaceChild(scriptElement, scriptElements[i]);
}
//ajax.js
(function () {
window.hxsfx.ajax = {
loadHTML: function (ele, url) {
//时间戳用来解决加载页面缓存的问题
var urlTimeStamp = "timeStamp=" + new Date().getTime();
url += ((url.indexOf('?') >= 0) ? "&" : "?") + urlTimeStamp;
const httpRequest = new XMLHttpRequest();
httpRequest.open('GET', url, true);
httpRequest.onreadystatechange = function () {
//为了让代码更健壮,使用try...catch来捕获返回状态判断和处理HTML代码的异常
try {
if (httpRequest.readyState === XMLHttpRequest.DONE) {
if (httpRequest.status === 200) {
ele.innerHTML = httpRequest.responseText;
var scriptElements = ele.getElementsByTagName("script");
for (var i = 0; i < scriptElements.length; i++) {
var scriptElement = document.createElement("script");
scriptElement.setAttribute("type", "text/javascript");
var src = scriptElements[i].getAttribute("src");
if (src) {
//因为加载的src路径是之前相对加载HTML页面的,需要修改为当前页
src = url.substring(0, url.lastIndexOf('/') + 1) + src;
src += ((src.indexOf('?') >= 0) ? "&" : "?") + urlTimeStamp;
scriptElement.setAttribute("src", src);
}
var scriptContent = scriptElements[i].innerHTML;
if (scriptContent) {
scriptElement.innerHTML = scriptContent;
}
//用生成的script元素去替换html中的script标签,以此来激活script代
ele.replaceChild(scriptElement, scriptElements[i]);
}
}
}
else {
console.log("【ajax.get(" + url + ")请求出错】");
}
}
}
catch (ex) {
console.log("【ajax.get(" + url + ")异常】" + ex.message);
}
};
httpRequest.send();
}
};
})();
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>js库测试</title>
<script src="Scripts/hxsfx/hxsfx.js"></script>
<script src="Scripts/hxsfx/ajax.js"></script>
<script>
window.onload = function () {
//调用ajax中的loadHTML方法
window.hxsfx.ajax.loadHTML(document.getElementById("ContentContainer"), "Views/test/testPage.html");
};
</script>
</head>
<body>
<div id="ContentContainer"></div>
</body>
</html>
<style>
div#TestPageContainer {
height: 300px;
width: 300px;
background-color: #F0F0F0;
}
</style>
<script src="../../Scripts/hxsfx/test/test.js"></script>
<script>
function updateBackgroundColor() {
try {
var backgroundColor = '#' + (Math.floor(Math.random() * 0xffffff).toString(16).padStart(6, '0'));
document.getElementById("TestPageContainer").style.backgroundColor = backgroundColor;
}
catch (ex) {
console.log(ex.message);
}
}
</script>
<div id="TestPageContainer">
<button onclick="updateBackgroundColor()">更改背景色</button>
<button onclick="modifyPFontColor()">更改下面一句话的字体颜色</button>
<p id="P">这儿是一句话。</p>
</div>
以上内容只是hxsfx.ajax库的开始,后续的内容更新小伙伴可以通过访问Github项目地址进行获取。
*请认真填写需求信息,我们会在24小时内与您取得联系。