ScrollView 组件参考

ScrollView 是一种带滚动功能的容器,它提供一种方式可以在有限的显示区域内浏览更多的内容。通常 ScrollView 会与 Mask 组件配合使用,同时也可以添加 ScrollBar 组件来显示浏览内容的位置。

scrollview-content

scrollview-inspector

点击 属性检查器 下面的 添加组件 按钮,然后从 UI 组件 中选择 ScrollView,即可添加 ScrollView 组件到节点上。

滚动视图的脚本接口请参考 ScrollView API

ScrollView 属性

属性功能说明
content它是一个节点引用,用来创建 ScrollView 的可滚动内容,通常这可能是一个包含一张巨大图片的节点。
Horizontal布尔值,是否允许横向滚动。
Vertical布尔值,是否允许纵向滚动。
Inertia滚动的时候是否有加速度。
Brake浮点数,滚动之后的减速系数。取值范围是 0-1,如果是 1 则立马停止滚动,如果是 0,则会一直滚动到 content 的边界。
Elastic布尔值,是否回弹。
Bounce Duration浮点数,回弹所需要的时间。取值范围是 0-10。
Horizontal ScrollBar它是一个节点引用,用来创建一个滚动条来显示 content 在水平方向上的位置。
Vertical ScrollBar它是一个节点引用,用来创建一个滚动条来显示 content 在垂直方向上的位置
Scroll Events列表类型,默认为空,用户添加的每一个事件由节点引用,组件名称和一个响应函数组成。详情见下方的 Scrollview 事件。
CancelInnerEvents如果这个属性被设置为 true,那么滚动行为会取消子节点上注册的触摸事件,默认被设置为 true。

ScrollView 事件

scrollview-event

属性功能说明
Target带有脚本组件的节点。
Component脚本组件名称。
Handler指定一个回调函数,当 ScrollView 的事件发生的时候会调用此函数。
CustomEventData用户指定任意的字符串作为事件回调的最后一个参数传入。

Scrollview 的事件回调有两个参数,第一个参数是 ScrollView 本身,第二个参数是 ScrollView 的事件类型。

ScrollBar 设置

ScrollBar 是可选的,你可以选择只设置 Horizontal ScrollBar 或者 Vertical ScrollBar,当然也可以两者都设置。建立关联可以通过在 层级管理器 里面拖拽一个带有 ScrollBar 组件的节点到 ScrollView 的相应字段完成。

详细说明

ScrollView 组件必须有指定的 content 节点才能起作用,通过指定滚动方向和 content 节点在此方向上的长度来计算滚动时的位置信息,Content 节点也可以通过 UIWidget 设置自动 resize。

通常一个 ScrollView 的节点树如下图:

scrollview-hierarchy

这里的 Viewport 用来定义一个可以显示的滚动区域,所以通常 Mask 组件会被添加到 Viewport 上。可以滚动的内容可以直接放到 content 节点或者添加节 content 的子节点上。

通过脚本代码添加回调

方法一

这种方法添加的事件回调和使用编辑器添加的事件回调是一样的,都是通过代码添加。首先需要构造一个 cc.Component.EventHandler 对象,然后设置好对应的 targetcomponenthandlercustomEventData 参数。

  1. // here is your component file, file name = MyComponent.js
  2. cc.Class({
  3. extends: cc.Component,
  4. properties: {},
  5. onLoad: function () {
  6. var scrollViewEventHandler = new cc.Component.EventHandler();
  7. scrollViewEventHandler.target = this.node; // 这个 node 节点是你的事件处理代码组件所属的节点
  8. scrollViewEventHandler.component = "MyComponent";// 这个是代码文件名
  9. scrollViewEventHandler.handler = "callback";
  10. scrollViewEventHandler.customEventData = "foobar";
  11. var scrollview = node.getComponent(cc.ScrollView);
  12. scrollview.scrollEvents.push(scrollViewEventHandler);
  13. },
  14. // 注意参数的顺序和类型是固定的
  15. callback: function (scrollview, eventType, customEventData) {
  16. // 这里 scrollview 是一个 Scrollview 组件对象实例
  17. // 这里的 eventType === cc.ScrollView.EventType enum 里面的值
  18. // 这里的 customEventData 参数就等于你之前设置的 "foobar"
  19. }
  20. });

方法二

通过 scrollview.node.on('scroll-to-top', ...) 的方式来添加

  1. // 假设我们在一个组件的 onLoad 方法里面添加事件处理回调,在 callback 函数中进行事件处理:
  2. cc.Class({
  3. extends: cc.Component,
  4. properties: {
  5. scrollview: cc.ScrollView
  6. },
  7. onLoad: function () {
  8. this.scrollview.node.on('scroll-to-top', this.callback, this);
  9. },
  10. callback: function (scrollView) {
  11. // 回调的参数是 ScrollView 组件
  12. // do whatever you want with scrollview
  13. }
  14. });

同样的,你也可以注册 scrollingtouch-upscroll-began 等事件,这些事件的回调函数的参数与 scroll-to-top 的参数一致。

关于完整的 ScrollView 的事件列表,可以参考 ScrollView 的 API 文档 ScrollView API