2025-06-21 23:30:33 +03:00

75 lines
2.4 KiB
JavaScript

import { addUniqueItem, noopReturn } from "@motionone/utils";
import { getAnimationData } from "../data";
/**
* A list of all transformable axes. We'll use this list to generated a version
* of each axes for each transform.
*/
export const axes = ["", "X", "Y", "Z"];
/**
* An ordered array of each transformable value. By default, transform values
* will be sorted to this order.
*/
const order = ["translate", "scale", "rotate", "skew"];
export const transformAlias = {
x: "translateX",
y: "translateY",
z: "translateZ",
};
const rotation = {
syntax: "<angle>",
initialValue: "0deg",
toDefaultUnit: (v) => v + "deg",
};
const baseTransformProperties = {
translate: {
syntax: "<length-percentage>",
initialValue: "0px",
toDefaultUnit: (v) => v + "px",
},
rotate: rotation,
scale: {
syntax: "<number>",
initialValue: 1,
toDefaultUnit: noopReturn,
},
skew: rotation,
};
export const transformDefinitions = new Map();
export const asTransformCssVar = (name) => `--motion-${name}`;
/**
* Generate a list of every possible transform key
*/
const transforms = ["x", "y", "z"];
order.forEach((name) => {
axes.forEach((axis) => {
transforms.push(name + axis);
transformDefinitions.set(asTransformCssVar(name + axis), baseTransformProperties[name]);
});
});
/**
* A function to use with Array.sort to sort transform keys by their default order.
*/
export const compareTransformOrder = (a, b) => transforms.indexOf(a) - transforms.indexOf(b);
/**
* Provide a quick way to check if a string is the name of a transform
*/
const transformLookup = new Set(transforms);
export const isTransform = (name) => transformLookup.has(name);
export const addTransformToElement = (element, name) => {
// Map x to translateX etc
if (transformAlias[name])
name = transformAlias[name];
const { transforms } = getAnimationData(element);
addUniqueItem(transforms, name);
/**
* TODO: An optimisation here could be to cache the transform in element data
* and only update if this has changed.
*/
element.style.transform = buildTransformTemplate(transforms);
};
export const buildTransformTemplate = (transforms) => transforms
.sort(compareTransformOrder)
.reduce(transformListToString, "")
.trim();
const transformListToString = (template, name) => `${template} ${name}(var(${asTransformCssVar(name)}))`;
//# sourceMappingURL=transforms.js.map