pixi.js 自定义光标样式
pixi 介绍
Pixi是一个超快的2D渲染引擎,通过Javascript和Html技术创建动画或管理交互式图像,从而制作游戏或应用。
项目地址:https://github.com/pixijs/pixi.js
API 地址:https://pixijs.download/dev/docs/index.html
中文教程地址:https://github.com/Zainking/learningPixi
游戏中都会做一些跟整个游戏画面风格相符的定制光标,比如英雄联盟中的棱形光标。在光标移动到敌对单位(交互对象)上时,会变成一把小🗡,释放技能时又变成了另外的形状。ps:为了找素材我特意打了一局游戏(手动狗头).
首先,我们需要创建一个可交互的区域。
const star = new PIXI.Graphics();
star.beginFill(0xfff8dc);
star.drawStar(200, 200, 5, 50);
star.endFill();
star.interactive = true;//启用交互响应
star.buttonMode = true;//设置交互时光标样式为 pointer 等同于 star.cursor = 'pointer'
app.stage.addChild(star);
在之前的文章中,我们提到过,可交互的关键就在于需要设置DisplayObject
的交互属性interactive
。只有当interactive=true
时,触摸、点击、鼠标等事件才能被该对象捕获到。(对于交互对象,原本的交互范围只是元素本身的位置范围,但是还可以通过设置hitArea
来定义更大的交互范围。)
cursor : This defines what cursor mode is used when the mouse cursor is hovered over the displayObject.
buttonMode: Setting this changes the 'cursor' property to
'pointer'
.
CSS cursor 样式
在我们看到的html中,所有的pixi绘制都是基于一个canvas实现的。也就是说,光标的变化其实都是相当于修改了canvas的cursor
样式。
cursor: [ [ <uri> [<x> <y>]?,]* [ auto | default | none | context-menu | help | pointer |
progress | wait |cell | crosshair | text | vertical-text | alias | copy | move |
no-drop | not-allowed | e-resize | n-resize | ne-resize | nw-resize | s-resize |
se-resize | sw-resize | w-resize | ew-resize | ns-resize | nesw-resize | nwse-resize |
col-resize | row-resize | all-scroll | zoom-in | zoom-out | grab | grabbing ] ];
1、cursor属性适用于所有元素;
2、cursor属性仅对具有指针设备(如鼠标)的设备有效;它对触控设备没有任何影响。
3、并非所有浏览器都支持cursor属性的所有属性值,且所有属性值在所有浏览器和操作系统中显示的效果不一定相同。
通过给不同的五角星设置不同的cursor属性,就可以实现这样的效果。
![cursor](https://img2020.cnblogs.com/blog/1676882/202101/1676882-20210111003730394-559727337.gif)
注意:buttonMode
和cursor
的值会互相覆盖,以最后设置的为准。
全局自定义cursor样式
千呼万唤始出来直接上代码:
const defaultIcon = "url('imgs/bunny.png'),auto";
const hoverIcon = "url('imgs/bunny_saturated.png'),auto";
app.renderer.plugins.interaction.cursorStyles.default = defaultIcon;
app.renderer.plugins.interaction.cursorStyles.pointer = hoverIcon;
cursorStyles
(传送门)是一个Object<string, Object>
类型的键值对,string字符串是用于设置cursor
的值,object为对应cursor
的具体样式内容。
这个解释起来比较拗口,看个样例就明白了。
const hoverIcon = "url('imgs/bunny_saturated.png'),auto";
//定义一个名为mycursor的光标样式并绑定具体css
app.renderer.plugins.interaction.cursorStyles.mycursor = hoverIcon;
//添加一个新的交互对象并将其cursor设置为mycursor
const star = new PIXI.Graphics();
star.interactive = true;
star.cursor = 'mycursor';
...
总结
本文介绍了pixi中设置DisplayObject
触发交互的方式、buttonMode
和cursor
之间的关系以及CSS cursor
,通过对全局cursorStyles
的设置实现了全局的自定义光标。