本文演示了如何使用Wijmo的其中两个部件,wijwizard 以及 wijpager。如果你期望看到Wijmo的其他文章,请参阅Wijmo 更优美的jQuery UI部件集:发现 Wijmo。
在这个快速入门,你将学习如何向一个HTML工程添加众多Wijmo部件中的两个, wijwizard 以及 wijpager。你将从添加并且自定义一个wijwizard部件入手,可以了解到一些独特的功能,然后你将学习如何通过连接到wijpager部件对wijwizard添加分页导航支持。
第一步是创建一个HTML页面,并向你的工程添加依赖项的链接。要做到这一点,你所要做的只是为每一个工程添加到内容传送网络(CDN)的链接:
注意:请从CDN添加最新依赖项的引用http://www.wijmo.com/downloads.cdn。
- <!--jQuery 引用-->
- <script src="http://ajax.aspnetcdn.com/ajax/jquery/jquery-1.7.1.min.js" type="text/javascript"></script>
- <script src="http://ajax.aspnetcdn.com/ajax/jquery.ui/1.8.17/jquery-ui.min.js" type="text/javascript"></script>
- <!--Wijmo 部件的JavaScript-->
- <script src="http://cdn.wijmo.com/jquery.wijmo-open.all.2.0.0.min.js" type="text/javascript"></script>
- <script src="http://cdn.wijmo.com/jquery.wijmo-complete.all.2.0.0.min.js" type="text/javascript"></script>
你还需要添加CSS样式表,可以通过将以下CDN链接添加到你的工程完成:
- <!—主题-->
- <link href="http://cdn.wijmo.com/themes/rocket/jquery-wijmo.css" rel="stylesheet" type="text/css" title="rocket-jqueryui" />
- <!--Wijmo 部件的CSS-->
- <link href="http://cdn.wijmo.com/jquery.wijmo-complete.all.2.0.0.min.css" rel="stylesheet" type="text/css" />
你要在这个快速开始中做的第一件事情就是创建一个不包含任何Header,具有三个页的基本wijwizard部件。通过将以下标记放置在HTML页面的主体内开始我们创建wijwizard HTML元素的工作:
- <div id="pages">
- <div>Page 1</div>
- <div>Page 2</div>
- <div>Page 3</div>
- </div>
<div> HTML元素是你将用来创建部件的内容。同时<div>元素的标识符被设置成“pages”,你将在接下来通过jQuery访问这个元素以完成对部件的初始化。
请注意,为了向部件添加页,你所要做的只是将文本放置在一对<div>标签中间。如果你愿意,同样也可以将一对<p>标签嵌套在一对<div>标签中间。
现在我们完成一个可工作的部件唯一需要做的事情就是,初始化这个wijwizard部件。请将以下脚本放置在<head>和</head>标签中间以初始化该部件:
- <script id="scriptInit" type="text/javascript">
- $(document).ready(function () {
- $("#pages").wijwizard();
- });
- </script>
将一个可以工作的wijwizard添加到你的页面上就是这么简单。保存你的工程,并在浏览器中打开。它将看起来像下面这样:
当部件包含多于一个页面的时候,导航按钮将自动的被添加到部件上。你可以更改,甚至删除控件上显示的导航按钮。如果你想删除导航按钮,只需要将’none’作为参数传递给部件的navButton选项,如下面的脚本:
- $("#pages").wijwizard({
- navButtons: 'none'
- });
保存你的工程,并刷新浏览器,wijwizard将不再显示导航按钮,如下图所示:
你还可以向wijwizard添加header。这个过程很简单:你所要做的是创建一个具有三个列表项的列表(有序或者无序),之后为每一个项目添加一个header标签以及一些文字。如下所示:
- <ol>
- <li>
- <h1>Header 1</h1>
- </li>
- <li>
- <h1>Header 2</h1>
- </li>
- <li>
- <h1>Header 3</h1>
- </li>
- </ol>
以上标记应当放置在<div id="pages">和</div>标记之间(不要删除嵌套的DIV标签)。保存该工程,并且刷新浏览器。该工程看起来像是这样:
现在你拥有header了,但是你没有导航,因为你在之前的某步操作中已经把它删除了。你可以通过将wijwizard的navButtons选项设置为“edge”或者“common”将其找回,或者你可以将其和wijpage部件组合以实现分页导航。这里我们会让你这么做,因为你之前没有见过它是如何工作的。
首先,添加一个<div>的HTML元素到工程。你可以将这个<div>元素放置在用于创建wijwizard的<div>元素上面或者下面(你放置它的位置会决定wijpager相对于wijwizard的位置)。但是标记应当如下面所示:
- <div id="pager">
- </div>
现在向 (document).ready 函数添加jQuery。你需要初始化wijpager,设置它的pageCount,pageIndex,以及mode属性,同时添加一个函数处理它的pageIndexChanged事件。要做到这一点,向 (document).ready 函数添加以下脚本:
- $("#pager").wijpager({
- pageCount: $("#pages").wijwizard('count'),
- pageIndex: $("#pages").wijwizard('option', 'activeIndex'),
- mode: "numeric",
- pageIndexChanged: function () {
- var pageIndex = $("#pager").wijpager("option", "pageIndex");
- $("#pages").wijwizard({ activeIndex: pageIndex });
- }
- });
现在请刷新你的浏览器,此时可以观察到wijpager出现在wijwizard附近。结果类似于以下内容:
点击数字按钮之一,你可以发现已经可以使用wijpager部件对wijwizard进行分页浏览了。
漂亮的结果,不是吗?使用Wijmo,你总是可以很容易的自定义你的部件。你通过这个快速入门获得的大多数知识可以应用到其他Wijmo部件,但是这只是所有你能通过Wijmo实现功能的冰山一角。
关于Wijmo部件的更详细的信息,请访问 Wijmo 文档,在那里,你可以找到每一个独立的部件的介绍和API参考。
如果你想快速上手Wijmo,请参考 Wijmo 完整的快速开始。
有关脚本的更多高级示例,请访问演示页面。
Wijmo下载,请进入Studio for ASP.NET Wijmo 2012 v1正式发布(2012.03.22更新)!
本文出自 “葡萄城控件博客” 博客,请务必保留此出处http://powertoolsteam.blog.51cto.com/2369428/838549