0.1.4 • Published 7 years ago

colorpath v0.1.4

Weekly downloads
2
License
MIT
Repository
github
Last release
7 years ago

安装

npm install colorpath

使用

colorpath 支持以下三个函数的运算和逆运算:

  • tint
  • shade
  • mix

引入 colorpath:

import clp from 'colorpath'

接下来就可以使用以下 API(参数中的 sourceColordestinationColormixer 均支持十六进制和 RGB 两种表示法):

  • tint(sourceColor, percentage)
clp.tint('#ff08d5', 0.4) //[255, 107, 230]
  • findTint(sourceColor, destinationColor)
clp.findTint('#ff08d5', '#ff6be6') //0.4028
  • shade(sourceColor, percentage)
clp.shade('#ffc8d5', 0.4) //[153, 120, 128]
  • findShade(sourceColor, destinationColor)
clp.findShade('#ffc8d5', '#997880') //0.3997
  • mix(sourceColor, mixer, percentage)
clp.mix('#ffc8d5', 'd3985a', 0.4) //[229, 171, 139]
  • findMixer(sourceColor, destinationColor)
clp.findMixer('#ffc8d5', '#e5ab8b') //{ mixer: [ 180, 117, 0 ], percentage: 0.6526 }
  • findPath(sourceColor, destinationColor)
clp.findPath('#ff08d5', '#ff6be6') //{ method: 'tint', percentage: 0.4028 }
clp.findPath('#ffc8d5', '#997880') //{ method: 'shade', percentage: 0.3997 }
clp.findPath('#ffc8d5', '#e5ab8b') //{ method: 'mix', mixer: [ 180, 117, 0 ], percentage: 0.6526 }

注意:若 findTintfindShade 无解,则会抛出一个错误;而 findPath 会先尝试调用 findTintfindShade,若发现无解会调用 findMixer。因此,如果不确定两种颜色之间是否存在 tint 或 shade 的关系,建议直接使用 findPath

命令行工具

安装

npm install -g colorpath

使用

$ clp <arguments> <method>

其中 arguments 为调用参数,method 为调用方法。上述例子中的 clp.findPath('#ffc8d5', '#e5ab8b') 对应的命令行调用为:

$ clp ffc8d5 e5ab8b --find-path