Pixate Action API 文档翻译

Pixate 是一款用来构建可交互原型的工具，产品经理用来检验自己的想法非常的方便。除了在 Pixate 的编辑器界面中采用拖拽的方法所见即所得地绘制应用的界面及交互，他们还提供了一系列的 API 让用户用代码的方式来构建可交互原型，文档是英文的在这里。我尝试着翻成中文，一些用词或许不合适，还请见谅。

一、介绍

你有没有想过在 Pixate 中自动地执行一些重复任务，或者快速地创建通用的规则？如果是的话，「动作」将是你正在寻找的东西。从它的核心来看，「动作」只是一堆告诉 Pixate 要做什么的代码而已。从现在开始，这些围绕着在原型中解决控制图层、动画配置的问题，但是很快你会可以用它来拓展编辑器以及原型数据在 Pixate 中的进进出出。

如果你决定了编写你自己的 Pixate 动作，有一些值得提前掌握的事情。

语法

Pixate 动作用一个 Javascript 的子集来编写，以及保留了你需要的用来判断条件、重复逻辑以及功能的大部分语言特性。

撤销更改

在执行「动作」之后，你可以经由撤销功能来撤销所做的更改。

反馈

「动作」还只是一个 Beta 特性，我们很乐意看到你的反馈。如果有任何需要讨论「动作」或者其他 Pixate 周边其他可拓展性功效的话请前往社群站点。

二、顶级 API

getSelectedLayer

获得一个图层对象，作为当前编辑器界面中选中的图层。

一个被选中的图层包裹的 Layer 对象，或者什么都没有选中的话是 null

var selectedLayer = getSelectedLayer();

getSelectedLayers

获取一组图层对象，作为当前编辑器界面中选中的图层。

一个Layer对象组成的数组作为被选中的图层，或者什么都没有选中的话是一个空数组[]

var selectedLayers = getSelectedLayers();

getSelectedAnmations

获取一个动画对象组成的数组作为当前编辑器界面中选中的动画。

一个Animation组成的数组作为选中的动画，或者什么都没选中的话返回空数组[]

var animations = getSelectedAnimations();

getLayerByName

获取一个与提供的图层名称匹配的图层对象。如果有多个相同名称的图层，第一个匹配到的会被返回。如果你真的需要操作多个图层，你应该使用getAllLayers()来替代。

参数

name string
用来查找的名称，需要与其在图层列表中呈现的一样。

一个包裹着匹配图层的Layer对象，或者什么都没有匹配的话返回null。

var namedLayer = getLayerByName('myLayer');

getAllLayers

获取原型图中所有图层组成的图层对象集合。

包含了原型中包含了所有Layer对象的数组，若没有图层存在则返回空数组。

var layers = getAllLayers();
//filter the layers array to just transparent layers
var transparentLayer = layers.filter(function(layer){
return layer.color === 'transparent';
});

getAssetByName

获取一个与所提供名字匹配的资源文件对象。在搜索的优先级上原型自有的资源文件比共享的其他资源文件要高。如果有多个相同名字的资源，返回的结果是第一个匹配的。

参数

name string
表示用来搜索的名字，需要与在资源窗口中显示的名字一样。

一个被选中的资源包裹的Asset对象，如果没有匹配的话返回null。

var myAsset = getAssetByName('header.png');

fetchJSON

从外部来源获取 JSON 数据用在你的脚本中，由于需要异步所以需要提供一个功能用在请求完成后的调用。这个功能将会完全取决于 JSON 数据能不能出现（可能关系到你的整个脚本）。

从外部获取 JSON 需要重点注意的是设置你的浏览器允许跨域资源共享策略,只有这样才能防止一些URL访问不受限制。

参数

url string(required)
需要获取 JSON 数据的远端地址。

callback string(required)
用来处理返回值的功能，这个功能用来提供给 JSON 数据作为单个自变量。

fetchJSON('http://api.myprodcut.com/users',function(users){
  //use the fetched JSON to dynamically create a few layers
  users.forEach(function(user){
    createLayer(user.name);
  })
});

警告：这个功能还在实验阶段，可能会发生变化甚至被移除
#####createAction
用提供的名称内容来创建一个新的动作，这对于使用现有的原型数据或者第三方数据来动态地创建动作是非常有用的。
######参数
name string(required)
用来创建动作的名称（不用必须是唯一的）。

contentstring(required)
动作的内容。
######注意：
createAction()不能像其他操控原型数据的API一样被撤销。你需要手动地在编辑器界面的动作列表中删除它。

var content = 'var layer = createLayer(); layer.backgroundColor = "crimson";';
createAction("Make red layer", content);

警告：这个功能是实验性的，可能会发生改变甚至被移除

createLayer

在原型中创建一个新的图层，返回一个包围着的图层对象。图层经过创建之后在界面中被选中。

参数

namestring
创建图层的名称，是可选的。

一个新的Layer对象。

var header = createLayer('Header');

nestLayer

把一个或者多个图层嵌入其他图层中，用来创建图层组或者层级图层非常有用。

目标图层将会按照功能提供的顺序来嵌入。

参数

targetLayer(required)
用来嵌入目标图层的对象图层。

sourceLayer(required)
将会嵌入对象图层的一个或者多个目标图层。

var buttonGroup = createLayer('Button Group');
var acceptButton = createLayer('Accept Button');
var cancelButton = createLayer('Cancel Button');

nestLayers(buttonGroup,acceptButton,cancelButton);

addAnimationCondition

为一个动画对象添加一个新的动画条件，这个操作与在编辑器界面里添加动画条件、对象，或者比率相同。

注意：在添加额外的条件前，你必须为continuousToValue动画提供begin和end两个值，或者withDuration动画提供condition。

参数

animationAnimation(required)
对象动画。

新的AnimationCondition对象。

var layer = createLayer();
var move = createMoveAnimation(layer);
var moveElse = addAnimationCondition(move);