CanvasRenderingContext2D
.isPointInPath()
是 Canvas 2D API 用于判断在当前路径中是否包含检测点的方法。
语法
boolean ctx.isPointInPath(x, y); boolean ctx.isPointInPath(x, y, fillRule); boolean ctx.isPointInPath(path, x, y); boolean ctx.isPointInPath(path, x, y, fillRule);
参数
- x
- 检测点的X坐标
- y
- 检测点的Y坐标
fillRule
- 用来决定点在路径内还是在路径外的算法。
允许的值: path
Path2D
应用的路径。
返回值
Boolean
- 一个Boolean值,当检测点包含在当前或指定的路径内,返回 true;否则返回 false。
示例
使用 isPointInPath
方法
这是一段简单的代码片段,使用 isPointinPath
方法检查某点是否在当前的路径内。
HTML
<canvas id="canvas"></canvas>
JavaScript
var canvas = document.getElementById("canvas"); var ctx = canvas.getContext("2d"); ctx.rect(10, 10, 100, 100); ctx.stroke(); console.log(ctx.isPointInPath(10, 10)); // true
修改下面的代码, 在线查看 canvas的变化并在你的 控制台 中观察日志信息:
规范描述
Specification | Status | Comment |
---|---|---|
WHATWG HTML Living Standard CanvasRenderingContext2D.isPointInPath |
Living Standard |
浏览器兼容性
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Path parameter | (Yes) | 31 (31) | 未实现 | (Yes) | 未实现 |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Path parameter | ? | ? | 31.0 (31) | ? | ? | ? |
Compatibility 注解
- 在 Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4)之前,这个方法是错误的,在和路径进行比较前,该方法不会根据当前的变形矩阵增加指定点的坐标。现在,该方法可以正确执行,甚至上下文进行旋转、缩放或其他方式的变形。
参见
- 接口定义,
CanvasRenderingContext2D
.