如何引用符合AMD规范的JS?
如何引用不符合AMD规范的JS?
如何引用外部的JS?
针对JS引用,平台自带了一个专门的演示案例importJs,目录结构如下:
引用JS
如何引用符合AMD规范的JS文件?
方式一:通过require(‘xx’)引用12
AMD1.js是UI2下符合AMD规范的一个文件,代码如下:
AMD1.js文件内容:
1
2
3
4
5
6
7
define(function(require){
return {
fnOfAMD1: function(){
alert(“hello AMD1”)
}
}
})
importJs.js中引用AMD1.js的代码如下:
1
2
3
4
5
6
7
8
define(function(require){
var =require(“jquery”)varjustep=require(“UI/system/lib/justep”)
//加载UI2下, 符合AMD规范的文件
var amd1 = require("./AMD1")
...1234
)}
说明:在importJs中,通过var amd1 = require(“./AMD1”)引用了当前目录下的AMD1.js文件,之后,可以通过amd1调用AMD1.js文件返回的方法或变量,例如:amd1.fnOfAMD1() //调用AMD1.js定义的方法
方式二:通过require([‘x1’, ‘x2’], function(p1, p2){})引用12
AMD2.js是UI2下一个符合AMD规范的js文件,内容如下:
1
2
3
4
5
6
7
define(function(require){
return {
fnOfAMD2: function(){
alert(“hello AMD2”)
}
}
})
importJs.js中引用AMD2.js的代码如下:
1
2
3
4
5
6
7
Model.prototype.importInnerBtnClick = function(event){
//加载UI2下, 符合AMD规范的文件
var path = “./AMD2”
require([path], function(m){
m.fnOfAMD2()
})
}
说明:在importJS.js中,通过require([xxx], function(x){})方式,引用了AMD2.js文件,在回调函数中,参数m是AMD2.js文件返回的对象,在回调函数中,可以通过m调用AMD2.js中返回的对象上的方法和变量,例如:m.fnOfAMD2()
如何引用不符合AMD规范的JS文件?
对于不符合AMD规范的JS文件,引用方式与符合AMD规范的JS文件类似,唯一的区别是不符合模块化的JS没有返回值,具体引用方式如下:
方式一:通过require(‘xx’)引用12
noneAMD1.js是UI2下一个不符合AMD规范的JS文件,内容如下:
1
2
3
function fnOfNoneAMD1(){
alert(“hello noneAMD1”)
}
importJs.js中引用noneAMD1.js的代码如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
define(function(require){
var =require(“jquery”)varjustep=require(“UI/system/lib/justep”)
//加载UI2下, 符合AMD规范的文件
var amd1 = require("./AMD1")
//加载外网, 符合AMD规范的文件
var outterAMD1 = require("080/x5/UI2/demo/misc/importJs/outterAMD1.js")
//加载UI2下, 不符合AMD规范的文件
require("./noneAMD1")
...12345678910
})
说明:如上12行代码所示,通过require(“./noneAMD1”)引用了不符合AMD规范的noneAMD1.js文件,在importJs.js的后续代码中,可以直接访问noneAMD1.js中定义的全局函数或变量,例如:fnOfNoneAMD1()
方式二:通过require([‘x1’, ‘x2’], function(){})引用12
noneAMD2.js是UI2下一个不符合AMD规范的JS文件,内容如下:
1
2
3
function fnOfNoneAMD2(){
alert(“hello noneAMD2”)
}
importJs.js中引用noneAMD2.js的代码如下:
1
2
3
4
5
6
7
Model.prototype.importInnerNoneAMDBtnClick = function(event){
//加载UI2下, 不符合AMD规范的文件
var path = “./noneAMD2”
require([path], function(){
fnOfNoneAMD2()
})
}
说明:在require([xx], function(){})的回调函数中,可以直接使用被引用的noneAMD2.js中定义的全局函数和变量,例如:fnOfNoneAMD2()
如何引用外部的JS文件?
对于外部的JS文件,引用方式和UI2下的JS文件类似(无论是符合AMD规范还是不符合AMD规范),唯一的区别是给定的JS文件路径必须是”http://”开头的绝对路径,且必须是完整的路径(如果有扩展名,必须带扩展名,如”.js”)。
例如:
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
define(function(require){
…
//加载外网, 符合AMD规范的文件
var outterAMD1 = require(“h04/outterAMD1.js“)
…
//加载外网, 不符合AMD规范的文件
require(“h/wp-content/uploads/2015/04/outterNoneAMD1.js“)
…
Model.prototype.importOutterBtnClick = function(event){
//加载外网, 符合AMD规范的文件
var path = “wex5.com/wp-content/uploads/2015/04/outterAMD2.js“
require([path], function(m){
m.fnOfOutterAMD2()
})
}
…
Model.prototype.importOutterNoneAMDBtnClick = function(event){
//加载外网, 不符合AMD规范的文件
var path = “om/wp-content/uploads/2015/04/outterNoneAMD2.js“
require([path], function(){
fnOfOutterNoneAMD2()
})
}
…
})
总结
在WeX5中,引用JS(无论是符合AMD规范,还是不符合AMD规范)主要有两种方式:require(‘path’)和require([xx, xx], function(p1,p2){}),这两种方式对比如下:
引用JS方式 被引用JS的加载顺序 限制
require(‘xx’) 预先加载被引用的JS,再加载当前JSrequire参数必须是字符串常量;
require([xx, xx],function(p1,p2){}) 先加载当前JS,执行到require语句时,才加载被引用的JS; require参数支持变量或表达式;
对于这两种require方式,path必须符合以下规则:
如果引用UI2下的文件,支持两种路径:以”./”或”../”开头的相对路径(相对于当前js所在的文件);以”UI/”开头的路径(UI表示UI2);路径不需要带文件扩展名”.js”;
如果引用外部文件,路径必须是以”http://”开头的完整路径(如果有扩展名”.js”,必须带上扩展名);
WeX5是单页模式,通过require引用的JS文件,每个不同的JS文件只加载一次,如果使用不符合AMD规范的JS文件,需要注意全局JS变量只有一份(多个页共享相同的全局变量)。
注意事项
通过require加载js文件时,如果被加载的js文件中有document.write时,会报错,例如,执行以下代码时:
1
require([“haidu.com/api?type=quick&ak=您的密钥&v=1.4”],function(){})
会出现以下错误:
Failed to execute ‘write’ on ‘Document’: xxx It isn’t possible to write into a document from an asynchronously-loaded external script unless it is explicitly opened.
原因是”aidu.com/api?type=quick&ak=您的密钥&v=1.4″返回的代码类似:
1
2
3
4
5
(function(){
window.BMap_loadScriptTime = (new Date).getTime()
document.write(‘')
‘)
})()
解决方法可参考异步加载百度地图,例如:
1
2
3
4
5
6
7
8
9
10
11
Model.prototype.baiduBtnClick = function(event){
if (!window._baiduInitialize){
window._baiduInitialize = function(){
var mp = new BMap.Map(“map”)
mp.centerAndZoom(new BMap.Point(121.491, 31.233), 11)
}
require(["hi.map.baidu.com/api?v=1.4&ak=您的密钥&callback=_baiduInitialize"], function(){})
}123
}
找到文件管理就可以直接打开了。 可以在手机上下载一个应用宝软件,可以使用软件对手机管理。 或者下载个这样的软件。 可以打开应用宝,从软件上方搜索栏输入软件名称。 就能搜索到很多这个类型的软件。 选择需要的软件安装到手机上就可以。