跳到主要内容

Latex

Press play to preview the animation
import ...

export default makeScene2D(function* (view) {
const tex = createRef<Latex>();
view.add(<Latex ref={tex} tex="{{y=}}{{a}}{{x^2}}" fill="white" />);

yield* waitFor(0.2);
yield* tex().tex('{{y=}}{{a}}{{x^2}} + {{bx}}', 1);
yield* waitFor(0.2);
yield* tex().tex(
'{{y=}}{{\\left(}}{{a}}{{x^2}} + {{bx}}{{\\over 1}}{{\\right)}}',
1,
);
yield* waitFor(0.2);
yield* tex().tex('{{y=}}{{a}}{{x^2}}', 1);
});

Latex 组件用于显示数学公式并为其制作动画。

定义 LaTeX​

你可以使用 tex 属性指定要显示的 LaTeX 公式。与 Txt 节点类似,你可以分别使用 fill 和 fontSize 属性控制文本的颜色和大小。

务必始终设置某种 fill 颜色,否则将不会显示任何内容!

Press play to preview the animation
import ...

export default makeScene2D(function* (view) {
view.add(
<Latex
// Try editing the formula below:
tex="a^2 + b^2 = c^2"
fill="white"
fontSize={32}
/>,
);
});

为 LaTeX 制作动画​

我们可以通过对 tex 属性进行补间来为 LaTeX 制作动画。要启用删除、插入和变换动画,你必须将公式拆分为多个部分。你可以通过提供字符串数组来实现:

<Latex tex={['a^2', '+', 'b^2', '=', 'c^2']} />

或者使用花括号({{}})语法:

<Latex tex="{{a^2}} + {{b^2}} = {{c^2}}" />
// equivalent to
<Latex tex={['a^2', '+', 'b^2', '=', 'c^2']} />

你也可以混合使用两种方式:

<Latex tex={['{{a}}^2', '+', '{{b}}^2', '=', '{{c}}^2']} />
// equivalent to
<Latex tex={['a','^2', '+', 'b', '^2', '=', 'c', '^2']} />

仅存在于源公式中的 tex 部分会被视为已删除并淡出。类似地,仅存在于目标公式中的部分会淡入。同时存在于源公式和目标公式中的 tex 部分将进行补间:

Press play to preview the animation
import ...

export default makeScene2D(function* (view) {
const tex = createRef<Latex>();
view.add(<Latex ref={tex} tex="{{1}} + {{2}}" fill="white" />);

yield* waitFor(0.5);
yield* tex().tex(['2', '+', '3', '+', '4'], 1);
});

如果某个给定的 tex 部分在源公式和目标公式中都出现多次,但出现次数不匹配,该部分将被复制或合并。你可以在上面的示例中看到这一点。公式起初只有一个加号(+),但结束时有两个。

常见陷阱​

转义反斜杠​

反斜杠字符(\)在 JavaScript 中用作转义字符。要将其作为 LaTeX 公式的一部分使用,你需要通过将其加倍来进行转义:

node().tex('{{\\frac{1}{2}}}');

请注意,这不适用于 JSX 字符串属性内部:

// No escape needed:
<Latex tex="{{\frac{1}{2}}" />
// Escape necessary:
<Latex tex={'{{\frac{1}{2}}'} />

缺少空格​

目前,tex 各部分直接拼接在一起,中间不添加任何分隔符。如果公式依赖于两个部分之间的空格,这可能会破坏你的公式。例如,下面的公式会被破坏:

<Latex tex={['\\Delta', 'y']} />

节点会尝试将其解析为 \\Deltay,而不是正确的 \\Delta y。要避免这种情况,你应该将 y 部分用花括号包裹起来:

<Latex tex={['\\Delta', '{y}']} />

这样会被解析为正确的 \\Delta{y}。