51ditu Javascript API AJAX类参考文档2008-6-10 [更新到1]

本文档是灵图提供的API文档的一部分,该范例文档之中的类和对象在51ditu发布的任何JavaScript API之中都可以直接使用
例如Maps API,Search API,nav API和Mapplets之中
以下的类或方法主要用来提供跨浏览器的事件处理支持,以及开发AJAX应用的一些重要方法
更多详细的使用范例和说明请访问51ditu API开发文档页面
API使用交流清访问51ditu产品论坛

类列表:
LTAjax  LTEvent  LTObjectLoader  LTPoint 

类 LTAjax

51ditu Javascript API之中用来进行Xml,Json等ajax方式访问数据的类,该类的所有方法都是静态方法,因此不需要构造该类的实例而直接使用方法即可,例如LTAjax.loadXml(url,handle);
静态方法:
函数名称最后更新版本返回值类型说明
createHttpRequest() HTTPRequest对象以跨浏览器支持的方式创建HttpRequest对象。
loadXml(url,handle) 加载指定本地路径的XML文件,并在加载完成后回调handle函数,回调函数handle的参数是返回的Xml文档对象,该方法会通过创建XmlHttpRequest来访问XML数据,因此,当访问不在同一个域的资源时,会引起跨域问题,因此,确保仅仅访问本域的资源,当您的功能希望被引用到其他网站(例如通过Mapplet)的时候,不建议使用该方法。
loadRemoteXml(url,handle) 加载指定路径url的XML文件,并在加载完成后回调handle函数,回调函数handle的参数是返回的Xml文档对象,该方法通过JS 代理的方式访问XML文件,因此不会引起跨域,建议在Mapplet等需要跨域访问情况下使用该方法
  • 范例:加载远程的XML文件
  • loadText(url,handle) 加载指定本地路径的文件文件,并在加载完成后回调handle函数,回调函数handle的参数是返回的文本内容字符串,该方法会通过创建XmlHttpRequest来访问XML数据,因此,当访问不在同一个域的资源时,会引起跨域问题,因此,确保仅仅访问本域的资源,当您的功能希望被引用到其他网站(例如通过Mapplet)的时候,不建议使用该方法。
    loadRemoteText(url,handle) 加载指定路径url的XML文件,并在加载完成后回调handle函数,回调函数handle的参数是返回的文本内容字符串,该方法通过JS 代理的方式访问XML文件,因此不会引起跨域,建议在Mapplet等需要跨域访问情况下使用该方法
  • 范例:加载远程的文本文件数据
  • createDocument(xmlStr) Object通过指定Xml字符串创建Xml文档对象XmlDocument
    toXml(json) Object将Json对象转化为对应的Xml文档对象
    toJson(xmldoc) Object将Xml文档对象转化为对应的Json对象
    selectNodes(node,xpath) XML文档节点数组在指定节点的全部下级节点之中检索所有符合xpath条件的节点,类似于IE浏览器之中的selectNodes,这个方法能同时在多种浏览器之中兼容
    selectSingleNode(node,xpath) XML文档节点在指定节点的全部有下级节点之中检索一个xpath条件的节点,类似于IE浏览器之中的selectSingleNode,这个方法能同时在多种浏览器之中兼容
    getNodeValue(node,xpath) XML文档节点获取节点的内容,例如对于<node>TEXT</node>,返回字符串TEXT相当于IE之中的node.text,这个方法能同时在多种浏览器之中兼容
    返回顶部

    类 LTEvent

    51ditu JavaScript API之中用来进行事件处理的类,该类的所有方法都是静态方法,因此不需要构造该类的实例而直接使用方法即可,例如LTEvent.addListener(obj,event,handle);
    静态方法:
    函数名称最后更新版本返回值类型说明
    getCallback(obj,handle) Function返回一个对实例obj的handle方法的调用函数
    cancelBubble(event?) 中止事件处理的执行并返回事件处理结果false
    returnTrue(event?) 中止事件处理的执行并返回事件处理结果true
    bind(obj,event,hObj,hMethod,runOnce?) 2.13Listener将hObj对象的hMethod方法绑定到obj的event事件,返回一个listener对象,对浏览器集成的事件和自定义的事件都能使用
    addListener(obj,event,handle,runOnce?) 2.13Listener将handle函数绑定到obj的event事件,返回一个listener对象,对浏览器集成的事件和自定义的事件都能使用
    removeListener(listener) 删除指定的事件注册,参数必须是通过LTEvent.bind方法或者LTEvent.addListener方法返回的事件监视器
    clearListeners(obj,event?) 删除obj对象的所有event事件注册,如果不指定event或者event为空,则删除obj对象的所有事件
    deposeNode(obj) 删除指定HTML节点及其子节点的所有event事件注册,用来清除节点,防止内存溢出
    trigger(obj,event,args) 触发obj的event事件,args是触发的参数数组
    返回顶部

    类 LTObjectLoader

    加载远程的JS文件内容或Json对象
    构造函数:
    函数名称最后更新版本返回值类型说明
    LTObjectLoader() LTObjectLoader构造一个新的LTObjectLoader对象,每一个LTObjectLoader对象同时只能加载一个远程文件,如果在加载过程没有结束的时候开始加载另一个文件,原先的文件不会继续加载。
    静态方法:
    函数名称最后更新版本返回值类型说明
    getObject() LTObjectLoader返回一个LTObjectLoader对象,该函数会自动返回当前空闲的LTObjectLoader对象,如果不存在,则会自动创建一个返回
    方法:
    函数名称最后更新版本返回值类型说明
    load(src,charset?,decode?,objName?) 加载指定URL的JS文件内容
    事件:
    事件名称最后更新版本参数说明
    loaded (obj) 在JS数据加载完成时触发
    error在JS数据加载出现错误或在该JS文件之中并不包含指定名称的对象时触发
    返回顶部

    类 LTPoint

    代表地理点坐标,该点的位置通过灵图的NTU坐标来描述。
    构造函数:
    函数名称最后更新版本返回值类型说明
    LTPoint(lng,lat) LTPoint以指定的NTU经度和纬度创建一个地理点坐标
    方法:
    函数名称最后更新版本返回值类型说明
    getLongitude() Number获取NTU经度
    getLatitude() Number获取NTU纬度
    返回顶部