PageView 组件参考

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

    页面视图的脚本接口请参考 PageView API

    PageViewIndicator 是可选的,该组件是用来显示页面的个数和标记当前显示在哪一页。

    建立关联可以通过在 层级管理器 里面拖拽一个带有 PageViewIndicator 组件的节点到 PageView 的相应字段完成。

    pageview-event

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

    PageView 组件必须有指定的 content 节点才能起作用,content 中的每个子节点为一个单独页面,且每个页面的大小为 PageView 节点的大小,如果节点大小大于内容大小的话,可能会导致出现滚动不完整的现象。在 PageView 组件下有一个 view 节点对象,该对象结合 ScrollThreshold 决定了当前滑动的距离是否达到可以翻页的条件,操作效果分为以下两种:

    • 快速滑动:快速的向一个方向进行拖动,自动滑倒下一页,每次滑动最多只能一页。

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

    通过 pageView.node.on('page-turning', ...) 的方式来添加

    1. // 假设我们在一个组件的 onLoad 方法里面添加事件处理回调,在 callback 函数中进行事件处理:
    2. const { ccclass, property } = _decorator;
    3. @ccclass("example")
    4. export class example extends Component {
    5. this.pageView.node.on('page-turning', this.callback, this);
    6. callback(pageView: PageView) {
    7. // 回调的参数是 pageView 组件
    8. // 另外,注意这种方式注册的事件,也无法传递 customEventData
    9. }