超级浣熊的最近黑科技！？太有用了

87 阅读 0 评论 58 点赞

我是靠谱客的博主单纯芝麻，这篇文章主要介绍超级浣熊的最近黑科技！？太有用了，现在分享给大家，希望可以做个参考。

前言 / Introduction

有社区的伙伴想开发 Cocos Creator 插件，但需要学习HTML、CSS以及各种Web前端库，对游戏开发程序员真的是太难了......

社区大佬『超级浣熊』早就看穿了这一点，一直在潜心研究如何以Cocos Creator的开发方式，去开发 Cocos Creator 插件，并一直在不断实践与迭代。

近期『超级浣熊』最近研究的黑科技 SSRExtensionKit 再次刷新了我的 Cocos Creator 开发的认知：Creator + WebElement 混合开发，并以 Cocos Creator 组件化的方式使用。

首先，SSRExtensionKit 对一些基础 DOM 元素进行了封装

然后，又对基础的 css 进行了封装

同时，又对基础的 property 尝试了封装。

现在我们想一下，对于这些 DOM 元素，就使用上来说，可以大致分为两类:

独立使用的元素: button, a, link, 等等
组合使用的元素: table + tr + th, select + option, ul + ol + li 等等

这一节，我们来探索下，这些组合式的 DOM 元素在Cocos Creator 中的封装和使用，包含：

下拉框 / Dropdown
按钮 / Button
列表 / List
表格 / Table

下拉框 / Dropdown

首先我们来尝试一下，实现一个 下拉框 的效果，下面是用HTML元素实现的标准例子:

可以看到，下拉框的实现是通过 <select> + <option> 组合使用实现的。

基于我们目前为止封装的模块，这里我们有几种实现方式:

Node 添加一个 SSRSelect 组件 和多个 SSROption组件
Node 添加一个 SSRSelect ，Node 添加多个子节点，每个子节点有一个 SSROption 组件

这里选择的是第二种方式，因为这种 parent-child 的实现方式，更符合 CocosCreator 风格。

我们参照前面几节的例子，新建两个新的元素类:

复制代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
// ssr/dom/element/select.ts
export class SSRElementSelect extends SSRElementCore {
    protected _createDOM () {
        this.dom = document.createElement('select');
    }
}
// ssr/dom/element/option.ts
export class SSRElementOption extends SSRElementCore {
    protected _createDOM () {
        this.dom = document.createElement('option');
    }
    protected _addDOM () {
        let elementCore = this.node.parent.getComponent(SSRElementCore);
        if (elementCore && elementCore.dom instanceof HTMLSelectElement) {
            elementCore.dom.appendChild(this.dom);
        }
        else {
            game.container.appendChild(this.dom);
        }
    }
}

可以看到 <select> 和 <option> 在代码上的差异。

其实实现方式还是很直观的:

对于父级元素的 <select>和之前一样创建，没什么区别。

对于子级元素的 option 在创建的时候，如果 parent 具有了 select 组件，那么就添加到其节点下。

我们来使用看看。

首先是一个节点加上 select 组件。

接着为其加三个带有 option 组件的子节点:

每个子节点都有一个 innerText 的属性组件，用来为选项加上文本内容。

编辑器中预览，可以看到小小的三角形下拉框按钮，说明元素其实已经创建好了:

接着是网页中的测试:

点击下拉框后，可以看到各个选项内容:

最后是在插件系统中的测试:

不错，看起来一切正常。

更好的事件监听 / Better Event Listener

因为下拉框总是要配合事件来使用的。

这一次，我们正好也借助这个机会，来封装并完善下事件监听的机制。

和上几节一样，暂时想要监听 下拉框选取选项事件，我们要这么写:

复制代码

1
2
3
this.elementSelect.dom.on('change', () => {
    console.log((<HTMLSelectElement>this.elementSelect.dom).selectedIndex);
});

先看下效果:

可以看到，这么写，是完全没有问题的。

接着我们来想一下，是不是有办法可以让我们的 SSRElement 直接进行事件监听，而不需要再过渡到 DOM 对象呢。

答案当然是可以的，而且很简单:

复制代码

1
2
3
4
5
6
7
// SSRElementCore
public on(type: string, callback: Function): void {
    HTMLElement.prototype.addEventListener.call(this.dom, ...arguments);
}
public off(type: string, callback: Function): void {
    HTMLElement.prototype.removeEventListener.call(this.dom, ...arguments);
}

这样一来，我们就可以直接像 CocosCreator 中的普通 Node 对象一样，进行事件的监听了:

复制代码

1
2
3
this.elementSelect.on('change', (event) => {
    console.log((<HTMLSelectElement>this.elementSelect.dom).selectedIndex);
});

我们接着来看，这里的回调函数中的 event 主要有两个问题:

获取到的对象和 SSRElementCore 没有关系
用户需要自己查文档，找合适的事件名称，比如这里的 change 事件

那么我们是否可以把这种监听回调方式，也改成 CocosCreator 风格 呢，这样一来:

回调内容是 CocosCreator 风格的，自定义的内容，自然也就可以是 SSRElementCore 对象
SSRElementCore 负责监听所有可能事件，提供枚举接口，用户直接挑选使用即可，这也是封装的意义所在

首先我们来看下自定义事件的实现:

复制代码

1
2
3
4
5
6
7
8
9
import { Event } from 'cc';
import { SSRElementCore } from './core';
export class SSRElementEvent extends Event {
    constructor(name: any, element?: SSRElementCore, bubbles?: boolean) {
        super(name, bubbles);
        this.element = element;
    }
    public element: SSRElementCore = null;
}

接着，我们在 select 类中，注册好需要的事件:

复制代码

1
2
3
4
5
export class SSRElementSelect extends SSRElementCore {
    protected _initEventListener() {
        this.dom.on('change', this._onDOMEventChange.bind(this));
    }
}

在事件处理中，我们使用 CocosCreator 风格来发送事件，同时附加上我们想要传递的对象：

复制代码

1
2
3
4
5
6
7
8
9
10
export class SSRElementSelect extends SSRElementCore {
    private _selectedIndex: number = -1;
    // ......
    private _onDOMEventChange(event: Event) {
        this.selectedIndex = (<HTMLSelectElement>event.target).selectedIndex;
        this.node.dispatchEvent(
            new SSRElementEvent(SSRElementEventConst.OPTION_CHANGE, this)
        );
    }
}

这样修改后，我们的事件的监听就变成了:

复制代码

1
2
3
4
5
6
// test.ts
this.elementSelect.node.on(
    SSRElementEventConst.OPTION_CHANGE, 
    (event: SSRElementEvent) => {
        console.log((<SSRElementSelect>event.element).selectedIndex);
});

测试一下:

没有任何问题。

那就趁热打铁，我们试试为 button 也用这个套路，实现一下点击事件看看:

复制代码

1
2
3
4
5
6
7
8
9
10
export class SSRElementButton extends SSRElementCore {
    protected _initEventListener() {
        this.dom.on('click', this._onDOMEventClick.bind(this));
    }
    private _onDOMEventClick(event: Event) {
        this.node.dispatchEvent(
            new SSRElementEvent(SSRElementEventConst.BUTTON_CLICK, this)
        );
    }
}

这次测试的时候，我们加点难度:

在点击按钮的时候，为下拉框，动态的增加一个 option

这一切，我们完全使用 CocosCreator 风格 的代码来实现:

复制代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// Test.ts
this.elementButton.node.on(
    SSRElementEventConst.BUTTON_CLICK, (event: SSRElementEvent) => {
        // 创建 Node
        let optionNode = new Node();
        // 加入 Select 所属节点
        optionNode.parent = this.elementSelect.node;
        // SSRElementOption 组件
        let elementOption = optionNode.addComponent(SSRElementOption);
        // SSRPropertyInnerText 组件
        let propertyInnerText = optionNode.addComponent(SSRPropertyInnerText);
        propertyInnerText.innerText = "option4";
    }
);

最后来测试一下效果看看: