表达式基础

本章介绍 After Effects 表达式的基础语法，帮助您快速入门表达式开发。

什么是表达式？

表达式是用于控制图层属性值的 JavaScript 代码片段。它们可以根据时间、其他属性或外部数据动态计算属性值。

基本语法

变量声明

// 声明变量
var speed = 100;
let amplitude = 50;
const frequency = 2;

数据类型

// 数字
var number = 42;

// 字符串
var text = "Hello World";

// 布尔值
var isVisible = true;

// 数组
var position = [100, 200];
var color = [1, 0, 0, 1]; // RGBA

运算符

// 算术运算符
var result = 10 + 5;  // 加法
var result = 10 - 5;  // 减法
var result = 10 * 5;  // 乘法
var result = 10 / 5;  // 除法
var result = 10 % 3;  // 取模

// 比较运算符
var isEqual = (a == b);
var isGreater = (a > b);
var isLess = (a < b);

// 逻辑运算符
var result = (a && b);  // 逻辑与
var result = (a || b);  // 逻辑或
var result = !a;        // 逻辑非

常用全局变量

时间相关

time        // 当前时间 (秒)
frameDuration // 帧持续时间
frameRate   // 帧率

属性相关

value       // 当前属性值
thisComp    // 当前合成
thisLayer   // 当前图层
thisProperty // 当前属性

实用示例

简单的摆动动画

// 在X轴上创建摆动效果
var amplitude = 100;  // 摆动振幅
var frequency = 2;    // 摆动频率

value + [Math.sin(time * frequency) * amplitude, 0];

基于时间的缩放

// 随时间逐渐放大
var startScale = 50;
var endScale = 100;
var duration = 2; // 动画时长 (秒)

if (time < duration) {
    var progress = time / duration;
    startScale + (endScale - startScale) * progress;
} else {
    endScale;
}

条件动画

// 根据时间的不同行为
if (time < 1) {
    // 第一秒：淡入
    [time * 100, time * 100];
} else if (time < 3) {
    // 接下来2秒：稳定
    [100, 100];
} else {
    // 3秒后：淡出
    var fadeTime = time - 3;
    [100 - fadeTime * 50, 100 - fadeTime * 50];
}

属性链接

// 将旋转链接到另一图层的位置
var targetLayer = thisComp.layer("目标图层");
var distance = length(targetLayer.transform.position - thisLayer.transform.position);
distance * 0.5; // 基于距离的旋转

数学函数

三角函数

// 正弦波动画
Math.sin(time * 2) * 100;

// 余弦波动画
Math.cos(time * 2) * 100;

// 圆周运动
var radius = 100;
var centerX = 960;
var centerY = 540;
[
    centerX + Math.cos(time) * radius,
    centerY + Math.sin(time) * radius
];

实用函数

// 随机值
Math.random() * 100; // 0-100的随机数

// 绝对值
Math.abs(-50); // 返回 50

// 幂
Math.pow(2, 3); // 2的3次方 = 8

// 平方根
Math.sqrt(16); // 返回 4

最佳实践

1. 使用有意义的变量名

// 好
var rotationSpeed = 45;
var bounceAmplitude = 50;

// 避免
var a = 45;
var b = 50;

2. 为您的代码添加注释

// 根据时间计算反弹效果
var bounceFreq = 3; // 每秒反弹次数
var bounceAmp = 20; // 反弹振幅（像素）
Math.sin(time * bounceFreq * Math.PI * 2) * bounceAmp;

3. 使用函数实现可复用性

// 定义一个可复用的缓动函数
function easeInOut(t) {
    return t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t;
}

// 使用函数
var progress = time / 2; // 2秒动画
easeInOut(progress) * 100;

常见错误规避

忘记分号 - 始终用分号结束语句
大小写敏感 - JavaScript是大小写敏感的 (Time ≠ time)
数组索引 - 数组从索引0开始，而不是1
无限循环 - 在表达式中小心使用while循环

🔗 相关链接

常用属性和方法 - 学习更多属性和方法
数学运算 - 掌握数学函数
时间控制 - 深入了解时间相关的表达式
返回表达式主页 - 返回表达式文档

下一步

掌握基础后，我们建议继续学习：