google.feeds.FeedControl 类的实例旨在下载和显示多个供稿。该类与 AJAX 搜索 API 的搜索控件层 GSearchControl 非常类似。
构造函数
构造函数 说明
FeedControl() 创建一个新的 FeedControl 实例。创建该控件后,将为您要下载和显示的每个供稿调用一次 addFeed() 方法,然后调用 draw() 方法开始下载序列并在网页上绘制结果。
方法
方法 返回类型 说明
addFeed(url, label) 无 由 url 指定的供稿将被添加到该控件,并与标题为 label 的区域相关联。注意:只有调用 draw() 方法才会实际载入该供稿。feedcontrol.html 示例演示了此方法的使用。
draw(element, opt_options?) 无 将载入先前添加到该控件的所有供稿,并且在载入这些供稿时会将其添加到该网页。element 参数提供了包含结果条目的 DOM 节点。
可选的 opt_options 参数提供的选项可以控制该控件显示结果的方式。此参数是一个匿名对象,目前支持名为 drawMode 的单个属性,该属性的值可以为 google.feeds.FeedControl.DRAW_MODE_TABBED 或 google.feeds.FeedControl.DRAW_MODE_LINEAR。例如,以下代码段演示了如何请求该供稿控件使用标签式样式绘制供稿。tabbed.html 示例演示了该操作。
feedControl.draw(
document.getElementById("feedControl"),
{
drawMode : google.feeds.FeedControl.DRAW_MODE_TABBED
});
默认的 drawMode 为线性模式,例如 。google.feeds.FeedControl.DRAW_MODE_LINEAR
setNumEntries(num) 无 将为添加到此控件的每个供稿载入的供稿条目数设置为 num。默认情况下,FeedControl 类从每个供稿中载入 4 个条目。
setLinkTarget(linkTarget) 无 该控件为其显示的每个条目生成默认的 HTML。该 HTML 由超链接条目标题、作者和发布日期以及该条目的内容片断组成。此方法使调用程序可以指定超链接标题的目标。有效的值包括:
google.feeds.LINK_TARGET_BLANK - 将在新窗口中打开的链接
google.feeds.LINK_TARGET_SELF - 将在当前窗口中打开的链接
google.feeds.LINK_TARGET_TOP - 将在顶部框架中打开的链接
google.feeds.LINK_TARGET_PARENT - 将在顶部框架中打开或替换当前框架的链接。
其他任何值 - 结果锚元素中 target 的值将被设置为 linkTarget
该控件的此设置的默认值为 google.feeds.LINK_TARGET_SELF。