×
消息
×
loading..
  1. 关于(About Raphael)
  2. Raphael是什么 ?
  3. Raphael能做什么?
  4. 效果、例子Example、Demo
  5. 动画(Animation)
  6. 动画延迟Animation.delay()
  7. 重复动画Animation.repeat()
  8. 元素(Element
  9. 动画Element.animate()
  10. 动画Element.animateWith()
  11. 属性Element.attr()
  12. 点击事件Element.click()
  13. 克隆Element.clone()
  14. 数据Element.data()
  15. 双击事件Element.dblclick()
  16. 拖动事件Element.drag()
  17. 元素的边界框Element.getBBox()
  18. 路径元素的长度坐标点Element.getPointAtLength()
  19. 路径元素的长度子路径Element.getSubpath()
  20. 路径的长度Element.getTotalLength()
  21. 光晕效果Element.glow()
  22. 隐藏Element.hide()
  23. 鼠标悬浮、移出事件Element.hover()
  24. idElement.id
  25. 从后插入对象Element.insertAfter()
  26. 从前插入对象Element.insertBefore()
  27. 点在元素的形状内Element.isPointInside()
  28. Element.matrix
  29. 鼠标按下Element.mousedown()
  30. 鼠标移动Element.mousemove()
  31. 鼠标移出Element.mouseout()
  32. 鼠标悬浮Element.mouseover()
  33. 鼠标弹上Element.mouseup()
  34. 下一个元素Element.next
  35. DOM对象Element.node
  36. drag.over事件Element.onDragOver()
  37. 画布Element.paper
  38. 暂停Element.pause()
  39. 前面的兄弟元素Element.prev
  40. Raphael对象的内部引用Element.raphael
  41. 销毁元素Element.remove()
  42. 销毁数据Element.removeData()
  43. 恢复Element.resume()
  44. 旋转Element.rotate()
  45. 缩放Element.scale()
  46. 设置动画时间Element.setTime()
  47. 显示Element.show()
  48. 状态Element.status()
  49. 停止Element.stop()
  50. 元素向下移动Element.toBack()
  51. 元素向上移动Element.toFront()
  52. 放弃拖动事件Element.touchcancel()
  53. 拖动结束事件Element.touchend()
  54. 正在拖动事件Element.touchmove()
  55. 开始拖动事件Element.touchstart()
  56. 变换Element.transform()
  57. 平移变换Element.translate()
  58. 移除点击事件Element.unclick()
  59. 移除双击事件Element.undblclick()
  60. 移除拖动事件Element.undrag()
  61. 移除拖动事件Element.unhover()
  62. 移除鼠标按下事件Element.unmousedown()
  63. 移除鼠标移动事件Element.unmousemove()
  64. 移除鼠标移出事件Element.unmouseout()
  65. 移除鼠标悬浮事件Element.unmouseover()
  66. 移除鼠标弹起事件Element.unmouseup()
  67. 移除放弃拖动事件Element.untouchcancel()
  68. 移除拖动结束事件Element.untouchend()
  69. 移除正在拖动事件Element.untouchmove()
  70. 移除拖动开始事件Element.untouchstart()
  71. 矩阵(Matrix)
  72. 增加矩阵Matrix.add()
  73. 矩阵副本Matrix.clone()
  74. 翻转矩阵Matrix.invert()
  75. 旋转矩阵Matrix.rotate()
  76. 缩放矩阵Matrix.scale()
  77. 拆分矩阵Matrix.split()
  78. 获取矩阵字符串Matrix.toTransformString()
  79. 平移矩阵Matrix.translate()
  80. 获取转换后的X坐标Matrix.x()
  81. 获取转换后的Y坐标Matrix.y()
  82. 画布(Paper
  83. 导入JSON格式的元素Paper.add()
  84. 画布上的底层元素Paper.bottom
  85. 自定义属性Paper.ca
  86. 绘制圆Paper.circle()
  87. 清空画布Paper.clear()
  88. 自定义属性Paper.customAttributes
  89. 绘制椭圆Paper.ellipse()
  90. 遍历画布元素Paper.forEach()
  91. 获取元素Paper.getById()
  92. 指定位置的最上层元素Paper.getElementByPoint()
  93. 指定位置的所有元素集合Paper.getElementsByPoint()
  94. 字体Paper.getFont()
  95. 图片Paper.image()
  96. 路径Paper.path()
  97. 创建路径Paper.print()
  98. Raphael对象Paper.raphael
  99. 绘制矩形Paper.rect()
  100. 销毁画布Paper.remove()
  101. 修复FF和IE9的像素渲染BugPaper.renderfix()
  102. 强制safari渲染Paper.safari()
  103. 创建类数组对象Paper.set()
  104. 捕获元素集合Paper.setFinish()
  105. 改变画布尺寸Paper.setSize()
  106. 创建Paper.setPaper.setStart()
  107. 画布视框Paper.setViewBox()
  108. 绘制文本Paper.text()
  109. 画布上的顶端元素Paper.top
  110. 核心(Raphael()
  111. 角度Raphael.angle()
  112. 创建动画Raphael.animation()
  113. 三次贝赛尔曲线的边界框Raphael.bezierBBox()
  114. 解析颜色Raphael.color()
  115. RFC4122 的IDRaphael.createUUID()
  116. 弧度转角度Raphael.deg()
  117. 动画过渡公式Raphael.easing_formulas
  118. 自定义方法Raphael.el
  119. 查找三次贝赛尔曲线上的点Raphael.findDotsAtSegment()
  120. 扩展方法Raphael.fn
  121. 格式化Raphael.format()
  122. 格式化2Raphael.fullfill()
  123. 获取颜色Raphael.getColor()
  124. 复位颜色Raphael.getColor.reset()
  125. 获取点的坐标Raphael.getPointAtLength()
  126. 格式化颜色Raphael.getRGB()
  127. 子路径Raphael.getSubpath()
  128. 路径长度Raphael.getTotalLength()
  129. 转换HSB值Raphael.hsb()
  130. HSB值 转 RGBRaphael.hsb2rgb()
  131. 转换HSL值Raphael.hsl()
  132. HSL值转RGBRaphael.hsl2rgb()
  133. 类型Raphael.is()
  134. 交叉Raphael.isBBoxIntersect()
  135. 内部包含Raphael.isPointInsideBBox()
  136. 路径包括Raphael.isPointInsidePath()
  137. 矩阵变换路径Raphael.mapPath()
  138. 生成矩阵Raphael.matrix()
  139. Raphael对象Raphael.ninja()
  140. 格式化路径Raphael.parsePathString()
  141. 格式化路径2Raphael.parseTransformString()
  142. 转换路径Raphael.path2curve()
  143. 路径边界框Raphael.pathBBox()
  144. 路径的交点Raphael.pathIntersection()
  145. 路径转换Raphael.pathToRelative()
  146. 角度转弧度Raphael.rad()
  147. 注册字体Raphael.registerFont()
  148. RGB值转十六进制颜色Raphael.rgb()
  149. RGB值转HSB对象Raphael.rgb2hsb()
  150. RGB值转HSL对象Raphael.rgb2hsl()
  151. iframe窗口Raphael.setWindow()
  152. 对齐到网格Raphael.snapTo()
  153. 自定义方法Raphael.st
  154. 浏览器是否支持SVGRaphael.svg
  155. 路径应用到变换矩阵Raphael.toMatrix()
  156. 变换路径Raphael.transformPath()
  157. 浏览器渲染方式Raphael.type
  158. 是否支持VMLRaphael.vml
  159. 集合(Set)
  160. 清除数据Set.clear()
  161. 从集合中删除数据Set.exclude()
  162. 遍历Set.forEach()
  163. 删除最后一个元素Set.pop()
  164. 加入元素Set.push()
  165. 删除元素Set.splice()
  166. 绑定事件eve()
  167. 监听eve.listeners()
  168. 获取事件名称eve.nt()
  169. 移除监听eve.off()
  170. 绑定事件eve.on()
  171. 绑定一次性方法eve.once()
  172. 停止监听eve.stop()
  173. 解绑eve.unbind()
  174. 版本号eve.version

Raphaël 中文帮助文档(API)

 关于 Raphael

Raphael是什么?

Raphael Javascript 是一个 Javascript的矢量库。

2010年6月15日,著名的JavaScript库ExtJS与触摸屏代码库项目jQTouch,以及SVGVML处理库Raphael合并,形成新的库Sencha。主要应对HTML5等新趋势,加强丰富图形和触摸屏功能的重要举措。

Raphael Javascript 的创始人 Dmitry Baranovskiy也加入ExtJS。

ExtJS 是一个强大的Javascript 框架,它重组件化,很容易做出强大的、可媲美客户端的界面(这个框架是收费的,所以国内用的人比jQuery少多了)。

jQTouch 是一个 jQuery 的插件,主要用于手机上的 Webkit 浏览器上实现一些包括动画、列表导航、默认应用样式等各种常见UI效果的 JavaScript 库。

 

Raphael Javascript 的作者就是大名鼎鼎的前端大牛 Dmitry Baranovskiy

他出过几wangyuanwai.comcript 题目:《你真的已经搞懂JavaScript了吗?》

 

英文原版官网:http://raphaeljs.com

英文原版文档:http://raphaeljs.com/reference.html

Raphael能做什么?

Raphael Javascript可以处理SVGVML格式的矢量图。
它使用SVG W3C推荐标准和VML作为创建图形的基础,你可以用Javascript 操作Dom 很容易的创建出复杂的柱状图、走势图、曲线图等各种图表,可以画图,可以画出任意复杂度的图像,以及图表或图像裁剪和旋转等复杂操作。

同时它是跨浏览器的,完全支持 Internet Explorer 6.0+。

Raphael Javascript 目前支持的浏览器有:
Firefox 3.0+
Chrome 3.0+
Safari 3.0+
Opera 9.5+
Internet Explorer 6.0+
PS:新版本的遨游、QQ浏览器、TT浏览器(已经被腾讯放弃了)、猎豹浏览器、360浏览器 的内核都是 webkit( Chrome 就是Webkit ),至于别的国产浏览器,都是在Internet Explorer 外面嵌套了一层壳而已

Demos

关于本文翻译

莫等闲白了少年头。
活着,就要改变世界。


 动画 Animation

Animation.delay(delay)

创建现有的动画对象的副本,并且可以指定延迟时间。

参数

delay
number
动画延迟执行的时间,单位:毫秒ms

返回: object 新的动画对象

var anim = Raphael.animation({cx: 10, cy: 20}, 2e3);
    circle1.animate(anim); // 立即执行
    circle2.animate(anim.delay(500)); // 0.5秒之后再执行

Animation.repeat(repeat)

创建现有动画对象的副本,并指定重复频率。

参数

repeat
number
动画迭代次数。如果传入 0,表示动画会一直执行

返回: object 新的动画对象

元素 Element

Element.animate(…)

为指定元素创建动画,并执行。

参数

params
object
元素的最终属性,请参照:Element.attr
ms
number
动画持续时间,单位:毫秒ms
easing
可选
string
缓动类型。接受Raphael.easing_formulas其中之一,或CSS格式:cubic-bezier(XX, XX, XX, XX)
callback
可选
function
回调函数。动画结束时将被调用。

animation
object
动画对象,请参照:Raphael.animation

返回: object 原始元素

Element.animateWith(…)

作用与 Element.animate 类似,但保证动画与另一元素的同步执行。

参数

el
object
要同步的元素
anim
object
要同步的动画
params
可选
object
元素的最终属性,请参照:Element.attr
ms
可选
number
动画持续的时间,单位毫秒ms
easing
可选
string
缓动类型。接受Raphael.easing_formulas或CSS格式: cubic‐bezier(XX, XX, XX, XX)
callback
可选
function
回调函数。动画结束时将被调用。

element
object
要同步的元素
anim
object
要同步的动画
animation
可选
object
动画对象,请参照:Raphael.animation

返回: object 原始元素

Element.attr(…)

设置元素的属性。

参数

attrName
string
属性名称
value
string

params
object
名称/值对

attrName
string
属性的名称

attrNames
array
在这种情况下,方法返回指定属性名的当前值组成的数组

返回: object Element ,如果传入 attrsName value 或者 params。

返回: ... 属性的值,如果只有attrsName被传入。

返回: array 属性值的数组,如果 attrsNames被传入。

返回: object 属性对象,如果没有传入任何参数。

可能的参数

请参阅解释这些参数的SVG规范

  1. arrow-endstring路径的末尾显示箭头。字符串格式是 <type>[-<width>[-<length>]]。可能的类型:classicblockopenovaldiamondnone,宽:widenarrowmidium,长:longshortmidium
  2. clip-rectstring剪贴矩形。逗号或空格分隔的值:x,y,宽度和高度
  3. cursorstring光标的CSS类型
  4. cxnumber圆或椭圆的圆心的x轴坐标
  5. cynumber圆或椭圆的圆心的y轴坐标
  6. fillstring填充。颜色、渐变或图像
  7. fill-opacitynumber填充不透明度
  8. fontstring文本特性
  9. font-familystring字体
  10. font-sizenumber字体大小(像素)
  11. font-weightstring字体粗细
  12. heightnumber高度
  13. hrefstringURL。指定时,元素表现为超链接
  14. opacitynumber透明度
  15. pathstringSVG的路径字符串格式
  16. rnumber圆、椭圆或圆角矩形的半径
  17. rxnumber椭圆的横向半径
  18. rynumber椭圆的垂直半径
  19. srcstring图像的URL,只适用于Element.image元素
  20. strokestring笔触颜色
  21. stroke-dasharraystring[“”, “-”, “.”, “-.”, “-..”, “. ”, “- ”, “--”, “- .”, “--.”, “--..”]
  22. stroke-linecapstring[“butt”, “square”, “round”]
  23. stroke-linejoinstring[“bevel”, “round”, “miter”]
  24. stroke-miterlimitnumber 
  25. stroke-opacitynumber 
  26. stroke-widthnumber笔触宽度(像素,默认为1)
  27. targetstring与 href 一起使用
  28. textstring文本元素的内容。使用\n换行
  29. text-anchorstring[“start”, “middle”, “end”],默认为 “middle
  30. titlestring工具提示内容
  31. transformstring请参照:Element.transform
  32. widthnumber 
  33. xnumber 
  34. ynumber 

线性渐变

线性渐变的格式:“‹angle›-‹colour›[-‹colour›[:‹offset›]]*-‹colour›”,例如:“90-#fff-#000”90°线性渐变从白色到黑色;“0-#fff-#f00:20-#000” 0°从白色通过红色(20%位置)渐变为黑色。

径向渐变:“r[(‹fx›, ‹fy›)]‹colour›[-‹colour›[:‹offset›]]*-‹colour›”,例如:“r#fff-#000”从白色到黑色;“r(0.25, 0.75)#fff-#000”从白色渐变到黑色,焦点在0.25,0.75。焦点坐标的外围是0 .. 1。径向渐变只适用于圆形和椭圆形。

路径字符串

请参考SVG文件路径字符串 ,Raphael完全支持它。

颜色解析

  • 颜色的名称(“red“,“green“,“cornflowerblue“等)
  • #•••——缩写HTML颜色:(“#000”,“#fc0”等)
  • #••••••——HTML颜色:(“#000000”,“#bd2300”)
  • rgb(•••, •••, •••)——红色、绿色和蓝色通道值:(“rgb(200, 100, 0)”)
  • rgb(•••%, •••%, •••%)——和上面一样,但是用百分比:(“rgb(100%, 175%, 0%)”)
  • rgba(•••, •••, •••, •••)——红色、绿色、蓝色通道值:(“rgba(200, 100, 0, .5)”)
  • rgba(•••%, •••%, •••%, •••%)——和上面一样,但是用百分比:(“rgba(100%, 175%, 0%, 50%)”)
  • hsb(•••, •••, •••)——色相、饱和度和亮度值:(“hsb(0.5, 0.25, 1)”)
  • hsb(•••%, •••%, •••%) ——和上面一样,但是用百分比
  • hsba(•••, •••, •••, •••)——和上面一样,但是有透明度
  • hsl(•••, •••, •••)——基本和HSB相同,请参照:维基百科
  • hsl(•••%, •••%, •••%)——和上面一样,但是用百分比
  • hsla(•••, •••, •••, •••)——和上面一样,但是有透明度
  • 对于HSB及HSL,你可以指定色相度数:“hsl(240deg, 1, .5)”,或者“hsl(240°, 1, .5)

Element.click(handler)

为元素添加click事件的处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.clone()

返回: object 给定的元素的一个克隆元素

Element.data(key, [value])

添加或检索与给定的键关联的值。请参照:Element.removeData

参数

key
string
数据的键
value
可选
any
数据的值

返回:object元素

或者,如果该值未指定:

返回: any

用法

for (var i = 0, i <
    5, i++) {
    paper.circle(10 + 15 * i,
    10, 10)
    .attr({fill: "#000"})
    .data("i", i)
    .click(function () {
    alert(this.data("i"));
    });
    }

Element.dblclick(handler)

为元素添加dblclick事件的处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.drag(onmove, onstart, onend, [mcontext], [scontext], [econtext])

为元素添加drag事件的处理程序。

参数

onmove
function
移动处理函数
onstart
function
拖拽开始的处理函数
onend
function
拖拽结束处理函数
mcontext
可选
object
移动处理函数环境(上下文)
scontext
可选
object
拖拽开始处理函数环境
econtext
可选
object
拖拽结束处理函数环境

下面额外的drag事件会被触发:开始时drag.start.<id>;结束时drag.end.<id>;每次移动时drag.move.<id>。当元素被拖入了另一个元素drag.over.<id>将被触发。

拖拽开始事件和拖拽开始处理函数将在指定的环境内调用,或在包含以下元素的环境内调用:

  1. xnumber鼠标的 x轴位置
  2. ynumber鼠标的 y轴位置
  3. eventobjectDOM事件对象

移动事件和移动处理函数将在指定的环境内调用,或在包含以下元素的环境内调用:

  1. dxnumber相对起始点的x位移
  2. dynumber相对起始点的y位移
  3. xnumber鼠标的 x轴位置
  4. ynumber鼠标的 y轴位置
  5. eventobjectDOM事件对象

拖拽结束事件和拖拽结束处理函数将在指定的环境内调用,或在包含以下元素的环境内调用:

  1. eventobjectDOM事件对象

返回:object元素

Element.getBBox(isWithoutTransform)

返回指定元素的边界框

参数

isWithoutTransform
boolean
如果你想得到变换之前的边界,使用true。默认值为 false

返回: object 边界框对象:

  1. {
    1. x:number左上角 x
    2. y:number左上角y
    3. x2:number右下角 x
    4. y2:number右下角 y
    5. width:number
    6. height:number
    }

Element.getPointAtLength(length)

返回在指定路径上指定长度的坐标点。只适用于“路径”类型的元素。

参数

length
number
 

返回: object 名称:值

  1. {
    1. x:numberx 坐标
    2. y:numbery 坐标
    3. alpha:number导数(切线)的角度
    }

Element.getSubpath(from, to)

返回在指定路径上指定长度定子路径。只适用于“路径”类型的元素。

参数

from
number
片段开始位置
to
number
片段结束的位置

返回: string 段的路径字符串

Element.getTotalLength()

返回路径的长度,以像素为单位。只适用于“路径”类型的元素。

返回: number 长度。

Element.glow([glow])

为指定元素添加类似光晕的效果,返回创建的光晕元素组。请参照:Paper.set.

注:光晕不与元素关联。如果你改变元素的属性,它并不会自我调整。

参数

glow
可选
object
参数对象(所有属性可选):
  1. {
    1. widthnumber光晕大小,默认是10
    2. fillboolean是否填充,默认是false
    3. opacitynumber透明度,默认是0.5
    4. offsetxnumber横向偏移,默认为0
    5. offsetynumber垂直偏移,默认为0
    6. colorstring发光颜色,默认为black
  2. }

返回: object 表示光晕的元素组,请参照:Paper.set

Element.hide()

隐藏指定元素。请参照:Element.show.

返回:object元素

Element.hover(f_in, f_out, [icontext], [ocontext])

为元素增加hover事件的处理程序。

参数

f_in
function
悬停进入处理句柄
f_out
function
悬停离开处理句柄
icontext
可选
object
悬停进入处理句柄环境
ocontext
可选
object
悬停离开处理句柄环境

返回:object元素

Element.id

数字

元素的唯一的ID。当你要监听元素的事件时尤其有用。因为所有的事件被以下面的格式触发:<module>.<action>.<id> 。对Paper.getById方法也有用。

Element.insertAfter()

在指定对象后插入当前对象。

返回:object元素

Element.insertBefore()

在指定对象前插入当前对象。

返回:object元素

Element.isPointInside(x, y)

确定指定点在当前元素的形状内

参数

x
number
点的x坐标
y
number
点的y坐标

返回: boolean true 如果点在形状内

Element.matrix

object

矩阵对象,它代表元素的变换

Element.mousedown(handler)

为元素添加mousedown事件的处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.mousemove(handler)

为元素添加mousemove事件的处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.mouseout(handler)

为元素添加mouseout的事件的处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.mouseover(handler)

为元素添加mouseover事件的处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.mouseup(handler)

为元素添加mouseup事件的处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.next

object

层次结构中的下一个元素的引用。

Element.node

object

DOM对象的引用。

用法

// 在画布上,画一个圆,圆心坐标为:X:10 , Y:10 ,圆的半径:10
    var c = paper.circle(10, 10, 10);
    c.node.onclick = function () {
    c.attr("fill", "red");
    };

Element.onDragOver(f)

为元素分配drag.over.<id>事件处理程序的快捷方式,其中id是元素的id(请参照:Element.id )。

参数

f
function
事件的处理程序,第一个参数是你拖拽的元素

Element.paper

object

绘制对象的“画布”的内部引用。主要用于插件和元素扩展。

用法

Raphael.el.cross = function () {
    this.attr({fill: "red"});
    this.paper.path("M10,10L50,50M50,10L10,50")
    .attr({stroke: "red"});
    }

Element.pause([anim])

暂停执行动画,稍后可以恢复执行。

参数

anim
可选
object
动画对象

返回: object 原始元素

Element.prev

object

层次结构中前一个元素的引用。

Element.raphael

object

Raphael对象的内部引用。即使它目前不可用。

用法

Raphael.el.red = function () {
    var hsb = this.paper.raphael.rgb2hsb(this.attr("fill"));
    hsb.h = 1;
    this.attr({fill: this.paper.raphael.hsb2rgb(hsb).hex});
    }

Element.remove()

从画布上移除元素。

Element.removeData([key])

删除元素与指定键相关联的值。如果不提供关键,则删除元素中的所有数据。

参数

key
可选
string

返回:object元素

Element.resume([anim])

恢复动画,如果它被Element.pause方法暂停。

参数

anim
可选
object
动画对象

返回: object 原始元素

Element.rotate(deg, [cx], [cy])

建议不要使用!使用Element.transform代替。围绕指定的点旋转指定角度。

参数

deg
number
角度
cx
可选
number
旋转中心的x坐标
cy
可选
number
旋转中心的y坐标

如果cxcy没有指定,形状的中心将作为旋转中心。

返回:object元素

Element.scale(sx, sy, [cx], [cy])

建议不要使用。使用Element.transform代替。为元素添加缩放。

参数

sx
number
水平缩放值
sy
number
垂直缩放值
cx
可选
number
缩放中心的x坐标
cy
可选
number
缩放中心的y坐标

如果cxcy没有指定,则使用形状的中心。

返回:object元素

Element.setTime(anim, value)

以毫秒为单位给元素设置动画的状态。类似Element.status方法。

参数

anim
object
动画对象
value
number
动画持续的毫秒数

返回: object 如果value被指定则返回原始元素

请注意,在动画过程中会触发下列事件:

在每个动画帧anim.frame.<id> ,在开始时 anim.start.<id>结束时anim.finish.<id>

Element.show()

使元素可见。请参照:Element.hide

返回:object元素

Element.status([anim], [value])

获取或设置元素的动画状态。

参数

anim
可选
object
动画对象
可选
number
0 - 1。如果指定,方法就像一个setter,并设置指定动画的状态为指定值。这将导致动画跳转到指定位置。

返回: number 状态

返回: array 状态,如果anim未指定。对象数组:

  1. {
    1. anim:object动画对象
    2. status:number状态
  2. }

返回: object 如果value被指定则返回原始元素

Element.stop([anim])

停止执行动画。

参数

anim
可选
object
动画对象

返回: object 原始元素

Element.toBack()

将元素向下移动。

返回:object元素

Element.toFront()

将元素向上移动。

返回:object元素

Element.touchcancel(handler)

为元素添加touchcancel事件的处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.touchend(handler)

为元素添加touchend事件的处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.touchmove(handler)

为元素添加touchmove事件的处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.touchstart(handler)

为元素添加touchstart事件的处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.transform([tstr])

为元素增加变换,这是独立于其他属性的变换,即变换不改变矩形的xy。变换字符串跟路径字符串的语法类似:

"t100,100r30,100,100s2,2,100,100r45s1.5"

每个字母是一个命令。有四个命令:t是平移,r是旋转,s是缩放,m是矩阵。

也有另类的“绝对”平移、旋转和缩放:TRS。他们不会考虑到以前的变换。例如:...T100,0总会横向移动元素100px,而...t100,0会移动垂直移动如果之前有r90。比较以下r90t100,0r90T100,0的结果。

所以,上面的例子可以读作“平移100,100;围绕100,100旋转30°;围绕100,100缩放两倍;围绕中心旋转45°;相对中心缩放1.5倍“。正如你可以看到旋转和缩放命令的原点坐标为可选参数,默认的是该元素的中心点。

矩阵接受六个参数。

用法

var el = paper.rect(10, 20, 300, 200);
    // 转换 100, 100, 旋转 45°, 转换 -100, 0
    el.transform("t100,100r45t-100,0");
    // 可以追加,或者预先转换
    el.transform("...t50,50");
    el.transform("s2...");
    // 或者包裹
    el.transform("t50,50...t-50-50");
    // 重置转换
    el.transform("");
    // 获取不带参数的当前值
    console.log(el.transform());

参数

tstr
可选
string
变换字符串

如果未指定 tstr

返回: string 转换字符串

else

返回:object元素

Element.translate(dx, dy)

建议不要使用。使用Element.transform代替。为元素增加平移变换。

参数

dx
number
水平位移
dy
number
垂直位移

返回:object元素

Element.unclick(handler)

移除元素的单击事件处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.undblclick(handler)

移除元素的dblclick事件处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.undrag()

移除元素的drag事件处理程序。

Element.unhover(f_in, f_out)

移除元素的hover事件处理程序。

参数

f_in
function
开始悬停的处理程序
f_out
function
结束悬停的处理程序

返回:object元素

Element.unmousedown(handler)

删除元素的mousedown事件处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.unmousemove(handler)

删除元素的mousemove事件处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.unmouseout(handler)

删除元素的mouseout事件处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.unmouseover(handler)

移除元素的mouseover事件处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.unmouseup(handler)

删除元素的mouseup事件处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.untouchcancel(handler)

移除元素的touchcancel事件处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.untouchend(handler)

移除元素的touchend事件处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.untouchmove(handler)

移除元素的touchmove事件处理程序。

参数

handler
function
事件处理函数

返回:object元素

Element.untouchstart(handler)

移除元素touchstart的事件处理程序。

参数

handler
function
事件处理函数

返回:object元素

矩阵

Matrix.add(a, b, c, d, e, f, matrix)

为现有矩阵增加一个矩阵。

参数

a
number
 
b
number
 
c
number
 
d
number
 
e
number
 
f
number
 
matrix
object
矩阵

Matrix.clone()

返回矩阵的副本

返回: object 矩阵

Matrix.invert()

返回矩阵的反转版本

返回: object 矩阵

Matrix.rotate(a, x, y)

旋转矩阵

参数

a
number
 
x
number
 
y
number
 

Matrix.scale(x, [y], [cx], [cy])

缩放矩阵

参数

x
number
 
y
可选
number
 
cx
可选
number
 
cy
可选
number
 

Matrix.split()

将矩阵分割成简单的变换

返回: object 格式:

  1. dxnumber水平平移
  2. dynumber垂直平移y
  3. scalexnumber水平缩放
  4. scaleynumber垂直缩放
  5. shearnumber剪切
  6. rotatenumber旋转角度
  7. isSimpleboolean是否可以简单变换代替

Matrix.toTransformString()

返回转换字符串

返回: string 转换字符串

Matrix.translate(x, y)

平移矩阵

参数

x
number
 
y
number
 

Matrix.x(x, y)

返回给定点在经过变换之后的x坐标。请参照:Matrix.y

参数

x
number
 
y
number
 

返回: 数字x

Matrix.y(x, y)

返回给定点在经过变换之后的y坐标。请参照:Matrix.x

参数

x
number
 
y
number
 

返回: 数字y

画布

Paper.add(json)

导入JSON格式的元素。格式:{type: type, <attributes>}

参数

json
array
 

返回 object 导入的元素集合

用法

paper.add([
    {
    type: "circle",
    cx: 10,
    cy: 10,
    r: 5
    },
    {
    type: "rect",
    x: 10,
    y: 10,
    width: 10,
    height: 10,
    fill: "#fc0"
    }
    ]);

Paper.bottom

指向画布上的底层元素

Paper.ca

object

Paper.customAttributes的引用

Paper.circle(x, y, r)

绘制一个圆。

参数

x
number
圆心的x坐标
y
number
圆心的y坐标
r
number
半径,半径距离

返回: object Raphael元素对象,类型为“圆”

用法

var c = paper.circle(50, 50, 40);

Paper.clear()

清空画布,即删除所有画布上的元素。

Paper.customAttributes

object

你可以添加自定义属性来方便设置一批属性:

用法

paper.customAttributes.hue = function (num) {
    num = num % 1;
    return {fill: "hsb(" + num + ", 0.75, 1)"};
    };
    // 自定义属性 “hue” 会改变填充
    // 得到固定的色相与饱和度和亮度。
    // 可以这样:
    var c = paper.circle(10, 10, 10).attr({hue: .45});
    // 甚至这样:
    c.animate({hue: 1}, 1e3);

    // 你也可以创建自定义属性
    // 也可以多个参数
    paper.customAttributes.hsb = function (h, s, b) {
    return {fill: "hsb(" + [h, s, b].join(",") + ")"};
    };
    c.attr({hsb: "0.5 .8 1"});
    c.animate({hsb: [1, 0, 0.5]}, 1e3);

Paper.ellipse(x, y, rx, ry)

绘制一个椭圆。

参数

x
number
该中心的x坐标
y
number
y坐标的中心
rx
number
水平半径
ry
number
垂直半径

返回: object Raphael元素对象,类型为“椭圆”

用法

var c = paper.ellipse(50, 50, 40, 20);

Paper.forEach(callback, thisArg)

为画布上每个元素执行指定函数

如果回调函数返回false则会停止循环。

参数

callback
function
函数运行
thisArg
object
回调函数的环境

返回: object 画布对象

用法

paper.forEach(function (el) {
    el.attr({ stroke: "blue" });
    });

Paper.getById(id)

返回匹配指定ID的元素。

参数

id
number
ID

返回: object Raphael元素对象

Paper.getElementByPoint(x, y)

返回位于指定位置的最上层元素

返回: object Raphael元素对象

参数

x
number
相对窗口左上角的x坐标
y
number
相对窗口左上角的y坐标

用法

paper.getElementByPoint(mouseX, mouseY).attr({stroke: "#f00"});

Paper.getElementsByPoint(x, y)

返回位于指定位置的所有元素集合

参数

x
number
点的x坐标
y
number
点的y坐标

返回: object 集合

Paper.getFont(family, [weight], [style], [stretch])

根据指定的参数从注册字体中获取字体对象。您可以只指定字体名称中的一部分,像“Myriad”,“Myriad Pro”。

参数

family
string
字体名称或其中的任何单词
weight
可选
string
字体粗细
style
可选
string
字体样式
stretch
可选
string
字体变形

返回: object 字体对象

用法

paper.print(100, 100, "Test
    string", paper.getFont("Times", 800), 30);

Paper.image(src, x, y, width, height)

嵌入一张图像。

参数

src
string
源图像的URI
x
number
x坐标
y
number
y坐标
width
number
图像的宽度
height
number
图像的高度

返回: object Raphael元素对象,类型为“图像”

用法

var c = paper.image("apple.png", 10, 10, 80, 80);

Paper.path([pathString])

由指定的路径字符串创建一个路径元素。

参数

pathString
可选
string
SVG格式的路径字符串。

路径字符串由一个或多个命令组成。每个命令以一个字母开始,随后是逗号(“,”)分隔的参数。例如:

"M10,20L30,40"

我们看到两个命令:“M”与参数(10, 20)和“L”与参数(30, 40)大写字母的意思是命令是绝对的,小写是相对的。

这里是可用命令的简表,详细内容请参照:SVG路径字符串格式

命令 名称 参数
M 移动到(moveTo) (x y)+
Z 闭合路径(closepath) (none)
L 直线(lineTo) (x y)+
H 水平直线 x+
V 垂直直线 y+
C 曲线(curveto) (x1 y1 x2 y2 x y)+
S 平滑曲线 (x2 y2 x y)+
Q 二次贝赛尔曲线 (x1 y1 x y)+
T 平滑二次贝塞尔曲线 (x y)+
A 椭圆弧 (rx ry x-axis-rotation large-arc-flag sweep-flag x y)+
R Catmull-Rom 曲线* x1 y1 (x y)+

* “Catmull-Rom 曲线”不是标准SVG命令,在2.0版时被加入。 注:有种特殊情况,路径只包含三个命令:“M10,10R…z”。在这种情况下,路径将平滑连接到它的起点。

用法

var c = paper.path("M10 10L90 90");
    // draw a diagonal line:
    // move to 10,10, line to 90,90

路径字符串的例子可以查看这些图标:http://lab.wangyuanwai.com/raphael-js/docs/icons/icons.html

Paper.print(x, y, string, font, [size], [origin], [letter_spacing])

创建路径,表示指定字体,指定大小,在指定位置的指定文本。该方法的结果是路径元素,它包含整个文本作为一个单独的路径。

参数

x
number
x坐标
y
number
y坐标
string
string
显示文本
font
object
字体对象,请参照:Paper.getFont
size
可选
number
字体大小,默认是16
origin
可选
string
文本垂直对齐方式"baseline""middle" ,默认为"middle"
letter_spacing
可选
number
范围-1..1 ,默认为0

返回: object 产生的路径元素,其中包括所有字母

用法

var txt = r.print(10, 50, "print", r.getFont("Museo"), 30).attr({fill:
    "#fff"});

Paper.raphael

指向Raphael对象

Paper.rect(x, y, width, height, [r])

绘制一个矩形。

参数

x
number
左上角的x坐标
y
number
左上角的y坐标
width
number
宽度
height
number
高度
r
可选
number
圆角半径,默认为​​0

返回: object Raphael元素对象,类型为“矩形”

用法

// 规则的矩形
    var c = paper.rect(10, 10, 50, 50);
    // 带圆角的矩形
    var c = paper.rect(40, 40, 50, 50, 10);

Paper.remove()

从DOM中删除的画布。

Paper.renderfix()

修复Firefox和IE9的像素渲染的问题。如果画布依赖于其他元素,换行后,它可能会移动半像素导致线条失去细节。这个方法解决此问题。

Paper.safari()

Safari(WebKit)有一个不方便的渲染错误:有时需要强制渲染。此方法对于处理此错误应该有帮助。

Paper.set()

创建类数组对象,保存和一次操作其中的多个元素。警告:它不创建任何元素,只是分组已存在的元素。“集合”充当伪元素 - 所有元素可用的方法,都可以在集合上使用。

返回: object 类数组对象表示元素集合

用法

var st = paper.set();
    st.push(
    paper.circle(10, 10, 5),
    paper.circle(30, 10, 5)
    );
    st.attr({fill: "red"}); // 改变两个圆的填充

Paper.setFinish()

请参照:Paper.setStart 。此方法结束捕获并返回元素集合。

返回: object 集合

Paper.setSize(width, height)

改变画布尺寸

参数

width
number
新的画布宽度
height
number
新的画布高度

Paper.setStart()

创建Paper.set 。调用此方法之后到调用 Paper.setFinish方法之前创建的所有元素都会被添加到集合内。

用法

paper.setStart();
    paper.circle(10, 10, 5),
    paper.circle(30, 10, 5)
    var st = paper.setFinish();
    st.attr({fill: "red"}); // 改变两个圆的填充

Paper.setViewBox(x, y, w, h, fit)

设置画布的视框。实际上,你可以通过指定新的边界来缩放和平移整个画布。

参数

x
number
新x坐标,默认为0
y
number
新y坐标,默认为0
w
number
新的画布宽度
h
number
新的画布高度
適合
boolean
设置true,如果你想要图形适应新的边界框

Paper.text(x, y, text)

绘制一个文本字符串。如果你需要换行,使用“\n”。

参数

x
number
x坐标
y
number
y坐标
text
string
文本字符串

返回: object Raphael元素对象,类型为“文本”

用法

var t = paper.text(50, 50, "魏翼超然!\n ./");

Paper.top

指向画布上的顶端元素

Raphael(...)

创建一个画布对象用来绘制。你必须第一步就这么做,该实例将来调用的所有绘图方法都被绑定到这个画布。

参数

container
HTML元素 string
DOM元素或它的ID,这将是绘图表面的父级节点
width
number
 
height
number
 
callback
可选
function
回调函数,新创建的画布将成为该函数的环境

x
number
 
y
number
 
width
number
 
height
number
 
callback
可选
function
回调函数,新创建的画布将成为该函数的环境

all
array
(前3个或4个数组元素对应 [containerID,width,height]或[x,y,width,height]。其余数组元素是元素描述{type:类型,<属性>})。请参照:Paper.add
callback
可选
function
回调函数,新创建的画布将成为该函数的环境

onReadyCallback
function
DOM ready事件回调。你也可以使用eve的“DOMLoad”事件。在这种情况下该方法将返回undefined

返回: object 画布

用法

// 每个示例都创建一个画布
    // 画布的尺寸是:宽 320px x 高 200px.
    // 画布开始于 10,50 .
    var paper = Raphael(10, 50, 320, 200);
    // 画布开始于  左上角,并且在 id=“notepad” 的元素里面创建
    // (注意:当节点有属性: dir="rtl",会从右上角开始创建)
    var paper = Raphael(document.getElementById("notepad"), 320, 200);
    // 同上
    var paper = Raphael("notepad", 320, 200);
    // 图像
    var set = Raphael(["notepad", 320, 200, {
    type: "rect",
    x: 10,
    y: 10,
    width: 25,
    height: 25,
    stroke: "#f00"
    }, {
    type: "text",
    x: 30,
    y: 40,
    text: "Dump"
    }]);

Raphael.angle(x1, y1, x2, y2, [x3], [y3])

返回两个或三个点之间的角度

参数

x1
number
第一点的x坐标
y1
number
第一点的y坐标
x2
number
第二点的x坐标
y2
number
第二点的y坐标
x3
可选
number
第三点的x坐标
y3
可选
number
第三点的y坐标

返回: number 度角

Raphael.animation(params, ms, [easing], [callback])

创建一个动画对象可以传递给Element.animateElement.animateWith方法。请参照:Animation.delayAnimation.repeat

参数

params
object
元素的最终属性,请参照:Element.attr
ms
number
动画持续的时间,单位毫秒ms
easing
可选
string
缓动类型。接受Raphael.easing_formulas其中之一,或CSS格式: cubic-bezier(XX, XX, XX, XX)
callback
可选
function
回调函数。动画结束时将被调用。

返回: object 动画

Raphael.bezierBBox(…)

返回指定三次贝赛尔曲线的边界框

参数

p1x
number
第一点的x坐标
p1y
number
第一点的y坐标
c1x
number
第一个锚点的x坐标
c1y
number
第一个锚点的y坐标
c2x
number
第二个锚点的x坐标
c2y
number
第二个锚点的y坐标
p2x
number
第二点的x坐标
p2y
number
第二点的y坐标

bez
array
贝赛尔曲线的6个点组成的数组

返回: object 点,格式:

  1. {
    1. min: {
      1. x:number最左边点的x坐标
      2. y:number最上边点的y坐标
    2. }
    3. max: {
      1. x:number最右边点的x坐标
      2. y:number最下边点的y坐标
    4. }
  2. }

Raphael.color(clr)

解析指定颜色字符串并返回包含全部值的颜色对象。

参数

CLR
string
颜色字符串,支持的格式请参照:Raphael.getRGB

返回: object RGB HSB 组合对象:

  1. {
    1. rnumber红色,
    2. gnumber绿色,
    3. bnumber蓝色,
    4. hexstring颜色的 HTML/CSS 格式:#••••••,
    5. errorbooleantrue,如果无法解析字符串,
    6. h字符串色相,
    7. s字符串饱和度,
    8. v字符串色调,
    9. l字符串亮度
    }

Raphael.createUUID()

返回RFC4122,第4版ID

Raphael.deg(deg)

弧度转角度

参数

deg
number
弧度值

返回: number 角度值

Raphael.easing_formulas

对象,其中包含动画过渡公式。你可以自己扩展。默认情况下,它含有以下过渡:

  • “linear”(线性)
  • “<”或“easeIn”或“ease-in” (由慢到快)
  • “>”或“easeOut”或“ease-out”(又快到慢)
  • “<>”或“easeInOut”或“ease-in-out”(由慢到快再到慢)
  • “backIn”或“back-in”(开始时回弹)
  • “backOut”或“back-out”(结束时回弹)
  • “elastic”(橡皮筋)
  • “bounce”(弹跳)

请参照:过渡示例.

Raphael.el

object

你可以给元素添加自己的方法。当你要修改默认功能或要在一个方法中包装一些常见的变换或属性,这很有用。与画布方法不同,你可以随时重新定义元素的方法。扩展元素的方法,不会影响元素集合。

用法

Raphael.el.red = function () {
    this.attr({fill: "#f00"});
    };
    // 开始使用参数
    paper.circle(100, 100, 20).red();

Raphael.findDotsAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t)

在给定的三次贝赛尔曲线上查找给定位置的点的坐标。

参数

p1x
number
第一点的x坐标
p1y
number
第一点的y坐标
c1x
number
第一个锚点的x坐标
c1y
number
第一个锚点的y坐标
c2x
number
第二个锚点的x坐标
c2y
number
第二个锚点的y坐标
p2x
number
第二点的x坐标
p2y
number
第二点的y坐标
ţ
number
曲线上的位置(0 .. 1)

返回: object 点,格式:

  1. {
    1. x:number点的x坐标
    2. y:number点的y坐标
    3. m: {
      1. x:number左锚的x坐标
      2. y:number左锚的y坐标
    4. }
    5. n: {
      1. x:number右锚的x坐标
      2. y:number右锚的y坐标
    6. }
    7. start: {
      1. x:number曲线起点的x坐标
      2. y:number曲线起点的y坐标
    8. }
    9. end: {
      1. x:number曲线终点的x坐标
      2. y:number曲线终点的y坐标
    10. }
    11. alpha:number曲线上该点导数(切线)的角度
  2. }

Raphael.fn

object

你可以为画布添加你自己的方法。例如:如果你想画一个饼图,可以创建自己的饼图函数然后作为Raphael插件。要这么做,你需要扩展Raphael.fn对象。您应该在Raphael实例被创建之前修改fn对象,否则将没有任何效果。请注意:Raphael2.0移除了为插件提供命名空间的功能。应该由插件确保命名空间负责保证适当的环境的安全。

用法

Raphael.fn.arrow = function (x1, y1, x2, y2, size) {
    return this.path( ... );
    };
    // 或者创建命名空间
    Raphael.fn.mystuff = {
    arrow: function () {…},
    star: function () {…},
    // etc…
    };
    var paper = Raphael(10, 10, 630, 480);
    // 开始使用
    paper.arrow(10, 10, 30, 30, 5).attr({fill: "#f00"});
    paper.mystuff.arrow();
    paper.mystuff.star();

Raphael.format(token, …)

简单的格式化功能。将“ {<number>} “结构替换为相应的参数。

参数

token
string
格式字符串
string
参数的其余部分将被视为替换参数

返回: string 经过格式化的字符串

用法

var x = 10,
    y = 20,
    width = 40,
    height = 50;
    // 将会绘制一个矩形,它的效果等同于: "M10,20h40v50h-40z"
    paper.path(Raphael.format("M{0},{1}h{2}v{3}h{4}z", x, y, width, height,
    -width));

Raphael.fullfill(token, json)

Raphael.format更先进一点点的格式化功能。将“ {<name>} “结构替换为相应的参数。

参数

token
string
格式
json
object
对象,其属性将被用来做替换

返回: string 经过格式化的字符串

用法

//将会绘制一个矩形,它的效果等同于: "M10,20h40v50h-40z"
    paper.path(Raphael.fullfill("M{x},{y}h{dim.width}v{dim.height}h{dim['negative width']}z", {
    x: 10,
    y: 20,
    dim: {
    width: 40,
    height: 50,
    "negative width": -40
    }
    }));

Raphael.getColor([value])

每次调用返回色谱中的下一个颜色。要重置回红色,调用Raphael.getColor.reset

参数

可选
number
亮度,默认为0.75

返回: string 颜色的十六进制表示。

Raphael.getColor.reset()

复位色谱位置 Raphael.getColor

Raphael.getPointAtLength(path, length)

返回位于路径上给定长度的点的坐标。

参数

path
string
SVG路径字符串
length
number
 

返回: object 点:

  1. {
    1. x:numberx 坐标
    2. y:numbery 坐标
    3. alpha:number导数(切线)的角度
  2. }

Raphael.getRGB(colour)

将颜色字符串解析为RGB对象

参数

colour
string
颜色字符串,格式:
  • 颜色的名称(“red“,“green“,“cornflowerblue“等)
  • #•••——HTML颜色缩写:(“#000”,“#fc0”等)
  • #••••••——HTML颜色:(“#000000”,“#bd2300”)
  • rgb(•••, •••, •••)——红色、绿色和蓝色通道值:(“rgb(200, 100, 0)”) RGB(•••••••••) -红色,绿色和蓝色通道值( rgb(200, 100, 0)
  • rgb(•••%, •••%, •••%)——和上面一样,但是用百分比:(“rgb(100%, 175%, 0%)”)
  • hsb(•••, •••, •••)——色相、饱和度和亮度值:(“hsb(0.5, 0.25, 1)”)
  • hsb(•••%, •••%, •••%) ——和上面一样,但是用百分比
  • hsl(•••, •••, •••) ——和HSB类似
  • hsl(•••%, •••%, •••%) ——和HSB类似

返回: object RGB对象,格式:

  1. {
    1. rnumber红色,
    2. gnumber绿色,
    3. bnumber蓝色
    4. hexstring颜色的 HTML/CSS 格式:#••••••,
    5. errorbooleantrue,如果不能解析
  2. }

Raphael.getSubpath(path, from, to)

从指定路径获取一段子路径,指定起始和结束位置。

参数

path
string
SVG路径字符串
from
number
片段开始位置
to
number
片段结束的位置

返回: string 段的路径字符串

Raphael.getTotalLength(path)

返回在指定路径的长度(像素)。

参数

path
string
SVG的路径字符串。

返回: number 长度

Raphael.hsb(h, s, b)

HSB值转换为十六进制颜色。

参数

h
number
色相
s
number
饱和度
b
number
色调或明度

返回: string 颜色的十六进制表示。

Raphael.hsb2rgb(h, s, v)

HSB值转换为RGB对象。

参数

h
number
色相
s
number
饱和度
v
number
色调或明度

返回: object RGB对象,格式:

  1. {
    1. rnumber红色,
    2. gnumber绿色,
    3. bnumber蓝色,
    4. hexstringHTML/CSS颜色格式: #••••••
  2. }

Raphael.hsl(h, s, l)

HSL值转换为十六进制颜色。

参数

h
number
色相
s
number
饱和度
l
number
亮度

返回: string 颜色的十六进制表示。

Raphael.hsl2rgb(h, s, l)

HSL值转换为RGB对象。

参数

h
number
色相
s
number
饱和度
l
number
亮度

返回: object RGB对象,格式:

  1. {
    1. rnumber红色,
    2. gnumber绿色,
    3. bnumber蓝色,
    4. hexstringHTML/CSS颜色格式: #••••••
  2. }

Raphael.is(o, type)

代替typeof操作符。

参数

o
...
任何对象或基本类型变量
type
string
类型,即“string”,“function”,“number”等名称

返回: boolean 指定值是指定的类型

Raphael.isBBoxIntersect(bbox1, bbox2)

返回true ,如果两个边界框相交

参数

bbox1
string
第一个边界框
bbox2
string
第二个边界框

返回: boolean true,如果它们相交

Raphael.isPointInsideBBox(bbox, x, y)

返回true,如果给定的点在边界框内。

参数

bbox
string
边界框
x
string
点的x坐标
y
string
点的y坐标

返回: boolean true,如果点在边界框内

Raphael.isPointInsidePath(path, x, y)

返回true,如果指定的点在给定的封闭路径内。

参数

路径
string
路径字符串
x
number
点的x坐标
y
number
点的y坐标

Returns: boolean true,如果点在闭合路径内

Raphael.mapPath(path, matrix)

用指定矩阵变换路径

参数

path
string
路径字符串
matrix
object
请参照:矩阵

返回: string 经过变换的路径字符串

Raphael.matrix(a, b, c, d, e, f)

用指定的参数生成矩阵

参数

  • a
    number
     
  • b
    number
     
  • c
    number
     
  • d
    number
     
  • e
    number
     
  • f
    number
     
  • 返回: object 矩阵

  • Raphael.ninja()

    如果你不想保留Raphael的痕迹(Raphael只创建一个全局变量Raphael),可使用ninja方法。请注意,在这种情况下,插件可能会停止工作,因为它们依赖全局变量的存在。

    返回: object Raphael对象

    用法

    (function (local_raphael) {
        var paper = local_raphael(10, 10, 320, 200);
        …
        })(Raphael.ninja());
    

    Raphael.parsePathString(pathString)

    将指定路径字符串解析成一个数组,其中的元素是路径段数组。

    参数

    pathString
    string array
    路径字符串或路径段数组(在后一种情况下,将马上返回)

    返回: array 路径段数组。

    Raphael.parseTransformString(TString)

    解析指定路径字符串为变换数组。

    参数

    TString
    string array
    变换字符串或变换数组(在后一种情况下,将马上返回)

    返回: array 变换数组。

    Raphael.path2curve(pathString)

    将指定路径转换为新路径,新路径的所有片段都是三次贝赛尔曲线。

    参数

    pathString
    string array
    路径字符串或路径段数组

    返回: array 路径段数组

    Raphael.pathBBox(path)

    返回指定路径的边界框

    参数

    path
    string
    路径字符串

    返回: object 边界框

    1. {
      1. x:number框左上角的x坐标
      2. y:number框左上角的y坐标
      3. x2:number框右下角的x坐标
      4. y2:number框右下角的y坐标
      5. width:number框的宽度
      6. height:number框的高度
    2. }

    Raphael.pathIntersection(path1, path2)

    查找两条路径的交点

    参数

    path1
    string
    路径字符串
    path2
    string
    路径字符串

    Returns: array 交点

    1. [
    2. {
      1. x:number点的x坐标
      2. y:number点的y坐标
      3. t1:numberpath1部分路径段的t值
      4. t2:numberpath2部分路径段的t值
      5. segment1:numberpath1部分路径段的顺序
      6. segment2:numberpath2部分路径段的顺序
      7. bez1:arraypath1部分路径段的贝赛尔曲线,表示为8个坐标
      8. bez2:arraypath2部分路径段的贝赛尔曲线,表示为8个坐标
    3. }
    4. ]

    Raphael.pathToRelative(pathString)

    将路径转换为相对形式

    参数

    pathString
    string array
    路径字符串或路径段数组

    返回: array 路径段数组组成的数组

    Raphael.rad(deg)

    角度转弧度

    参数

    deg
    number
    角度

    Returns: number 弧度值。

    Raphael.registerFont(font)

    给Raphael字体注册指定字体。应当作为Cufón字体文件的内部调用。返回原来的参数,所以它可以链式操作。

    关于Cufón如何从TTF,OTF等转换字体形式到JavaScript文件

    参数

    font
    object
    注册的字体

    返回: object 传入的字体

    用法

    Cufon.registerFont(Raphael.registerFont({…}));
    

    Raphael.rgb(r, g, b)

    将RGB值转换为十六进制颜色。

    参数

    r
    number
    红色
    g
    number
    绿色
    b
    number
    蓝色

    返回: string 颜色的十六进制表示。

    Raphael.rgb2hsb(r, g, b)

    将RGB值转换为HSB对象。

    参数

    r
    number
    红色
    g
    number
    绿色
    b
    number
    蓝色

    返回: object HSB对象,格式:

    1. {
      1. hnumber色相
      2. snumber饱和度
      3. bnumber明度
    2. }

    Raphael.rgb2hsl(r, g, b)

    将RGB值转换为HSL对象。

    参数

    r
    number
    红色
    g
    number
    绿色
    b
    number
    蓝色

    返回 object HSL对象,格式:

    1. {
      1. hnumber色相
      2. snumber饱和度
      3. lnumber亮度
    2. }

    Raphael.setWindow(newwin)

    需要在<iframe>绘制时使用。切换窗口为iframe。

    参数

    newwin
    窗口
    新的窗口对象

    Raphael.snapTo(values, value, [tolerance])

    将给定值对齐到指定网格。

    参数

    values
    array number
    指定值的数组或网格的梯级
    value
    number
    要调整的值
    tolerance
    可选
    number
    对齐的阈值默认值是10

    返回: 数量 经过调整的值。

    Raphael.st

    object

    你可以为元素和集合添加自己的方法。为给元素添加的每个方法写一个集合方法是明智的,你就可以在集合上调用同样的方法。请参照:Raphael.el

    用法

    Raphael.el.red = function () {
        this.attr({fill: "#f00"});
        };
        Raphael.st.red = function () {
        this.forEach(function (el) {
        el.red();
        });
        };
        // 使用
        paper.set(paper.circle(100, 100, 20),
        paper.circle(110, 100, 20)).red();
    

    Raphael.svg

    布尔

    如果浏览器支持SVG则为true

    Raphael.toMatrix(path, transform)

    返回指定路径所应用的变换矩阵

    参数

    path
    string
    路径字符串
    transform
    string array
    变换字符串

    返回: object 矩阵

    Raphael.transformPath(path, transform)

    返回指定路径经过指定变换后的路径

    参数

    path
    string
    路径字符串
    transform
    string array
    变换字符串

    返回: string 路径

    Raphael.type

    string

    可以是“SVG”,“VML”或为空,依赖于浏览器的支持。

    Raphael.vml

    布尔

    true,如果浏览器支持VML。

    集合

    set.clear()

    移除集合中的全部元素

    Set.exclude(element)

    从集合中删除指定元素

    参数

    element
    object
    要删除的元素

    Returns: boolean true,如果对象存在并且 已经被删除

    Set.forEach(callback, thisArg)

    为集合中的每个元素执行指定函数。

    如果函数返回false则停止循环运行。

    参数

    callback
    function
    回调函数
    thisArg
    object
    回调函数的环境

    返回: 对象集合对象

    Set.pop()

    删除最后一个元素并返回它。

    返回: object 元素

    Set.push()

    加入一个元素

    返回: object 原始元素

    Set.splice(index, count, [insertion…])

    从集合中删除指定元素

    参数

    index
    number
    开始删除的位置
    count
    number
    删除个数
    insertion…
    可选
    object
    要在删除位置插入的元素

    Returns: object 被删除的元素

    eve(name, scope, varargs)

    使用指定的name、作用域和参数触发事件。

    参数

    name
    string
    事件名称,点(.)或斜线(/)分隔
    scope
    object
    事件处理程序的环境
    varargs
    ...
    其余的参数将被发送到事件处理程序

    Returns: object 监听器返回值组成的数组

    eve.listeners(name)

    内部方法,返回监听指定name事件的回调函数组成的数组。

    参数

    name
    string
    事件名称,点(.)或斜线(/)分隔

    返回: array 事件处理程序的数组

    eve.nt([subname])

    在事件处理程序内使用,可以获取事件的实际名称。

    参数

    subname
    可选
    string
    事件的子名称

    返回: string 名称的事件,如果没有指定subname

    返回: boolean true ,如果当前事件的名称中包含subname

    eve.off(name, f)

    从指定名称的事件监听器列表中删除指定的函数。

    参数

    name
    string
    事件名称,点(.)或斜线(/)分隔,可以用通配符
    f
    function
    事件处理函数

    eve.on(name, f)

    为给定的名称绑定一个事件处理程序。可以在名称中使用通配符“ * “:

    eve.on("*.under.*", f);
        eve("mouse.under.floor"); //  触发 f
    

    使用eve触发监听。

    参数

    name
    string
    事件名称,点(.)或斜线(/)分隔,可以用通配符
    f
    function
    事件处理函数

    返回: function 返回的函数接受一个数字参数,表示处理程序的z-index。这是一个可选功能,只有当你需要使用,以确保处理程序的一些子集被设置为特定的调用顺序,而不使用指派顺序。

    例如:

    eve.on("mouse", eat)(2);
        eve.on("mouse", scream);
        eve.on("mouse", catch)(1);
    

    这将确保catch函数将被在eat 之前调用。如果你想要把你的处理程序放在未索引的处理程序之前,指定一个负值。注:我假设大部分的时间你不需要担心的z-index,但很高兴有此功能来“以防万一”。

    eve.once(name, f)

    为给定的名称绑定一个一次性事件处理程序。只运行一次,然后解除本身。

    eve.once("login", f);
        eve("login"); // 触发 f
        eve("login"); // 没有监听
    

    使用eve触发监听。

    参数

    name
    string
    事件名称,点(.)或斜线(/)分隔,可以用通配符
    f
    function
    事件处理函数

    返回: function eve.on返回的函数类似

    eve.stop()

    用于在事件处理程序内停止事件,防止触发任何后续监听器。

    eve.unbind()

    请参照:eve.off

    eve.version

    string

    当前库的版本。