SHTAPI 使用说明

出自射手网Wiki

SHTAPI 使用说明

跳转到: 导航, 搜索
简介

SHTAPI是面向第三方站点,提供完全嵌入式的射手网搜索功能API接口。
这种嵌入是完全纯粹的嵌入。SHTAPI完全基于Javascript技术,没有任何IFRAME和不可控的信息。任何网站都能够轻松将射手网的搜索功能融入为自身网站的功能的一个模块。
代码完全开放,如果你熟悉Javascript,还可以自己修改和扩展SHTAPI库的功能。
所有显示风格基于CSS,只需修改CSS样式库,就可以随意修改显示的排版、色彩、文字和图标、风格等。
范例
请参看<a href="http://shooter.cn/api/prom.html">范例页面</a> 。
API参考说明

基本库代码和标准样式文件:
<script type="text/javascript" src="http://shooter.cn/api/shteapi.js" charset='utf-8'></script>
<link rel="stylesheet" type="text/css" href="http://shooter.cn/api/standard.css" />

将上面2行代码插入页面的<HEAD>部分,便可在页面中使用SHTAPI。

命令: shteAPI.querySub( qInput, ePos );
qInput - 欲搜索的字符串,或目标对象ID(String),或目标对象(Object)
ePos - 显示搜索结果的定位位置,可以是 event (根据鼠标位置定位)。也可以是目标对象ID(String)或目标对象(Object),即可根据目标DOM页面元素定位。
API高级设定
(待续) 目前可参考 http://shooter.cn/api/shteapi.js 的源代码
修改显示风格
您可以参考 http://shooter.cn/api/standard.css 制作自己的CCS文件来实现自定义显示风格。 (待续)
特别说明
SHTAPI完全使用Javascript进行跨网站间的数据沟通。不使用XML的原因是因为因为安全性的原因,浏览器是禁止跨网站的XML通讯的。而对跨网站调用js则没有限制。不过,实际实现起来还是有不少困难。最后还是不得不借鉴了GoogleAPI的成熟代码。而且还很好地解决了不同字符集之间的问题,也就是说不论是GB2312、BIG5或者UTF-8的页面,都可以直接嵌入同一个代码库,而站长们则不必担心转码问题。过程有着不少痛苦和乐趣,代码部分我并没有加密,供有兴趣的同好随时参考。
赞助商链接:
个人工具