From a658de757b5d4ca10dd49988d50f2bd9dc164b33 Mon Sep 17 00:00:00 2001 From: unanmed <1319491857@qq.com> Date: Thu, 12 Nov 2026 21:27:50 +0800 Subject: [PATCH] =?UTF-8?q?refactor:=20=E9=87=8D=E5=81=9A=20use=20?= =?UTF-8?q?=E5=AE=9E=E7=8E=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- packages/render-vue/src/types.ts | 56 ++--- packages/render-vue/src/use.ts | 406 ++++++++++++++++++++++++++++--- 2 files changed, 388 insertions(+), 74 deletions(-) diff --git a/packages/render-vue/src/types.ts b/packages/render-vue/src/types.ts index 1865970..be31c8b 100644 --- a/packages/render-vue/src/types.ts +++ b/packages/render-vue/src/types.ts @@ -3,15 +3,10 @@ import { IRenderItemBaseHooks, IRenderTreeRoot } from '@motajs/render'; -import { VNodeProps } from 'vue'; +import { Ref, VNodeProps } from 'vue'; import { BaseProps } from './props'; import { TagDefine } from './elements'; -import { - IAnimater, - IExcitable, - IExcitation, - ITransition -} from '@motajs/animate'; +import { ExcitationCurve } from '@motajs/animate'; //#region 标签管理 @@ -67,49 +62,28 @@ export type DefaultProps< //#region 功能接口 -export interface IRendererUsing { - /** Using 对象使用的渲染器 */ - readonly renderer: IRenderTreeRoot; +export interface ITransitionedController { + readonly ref: Readonly>; + readonly value: T; /** - * 当渲染器的激励源触发激励时同时执行传入的可激励对象,相当于每帧执行一次。 - * - * 在**组件内**需要每帧执行时**务必**使用此接口,否则可能会导致激励对象没有被正确删除,出现内存泄漏问题。 - * - * 在**组件外不要**使用此接口,否则可能没有效果! - * @param excitable 可激励对象 + * 执行动画,使当前值缓慢变化至目标值 + * @param value 目标值 + * @param time 动画时长 */ - onExcited(excitable: IExcitable): void; + set(value: T, time?: number): void; /** - * 当渲染器的激励源触发激励时同时执行传入的函数,相当于每帧执行一次。 - * - * 在**组件内**需要每帧执行时**务必**使用此接口,否则可能会导致激励对象没有被正确删除,出现内存泄漏问题。 - * - * 在**组件外不要**使用此接口,否则可能没有效果! - * @param excitable 可激励对象 + * 设置动画的速率曲线 + * @param timing 速率曲线 */ - onExcitedFunc(fn: (payload: number) => void): void; + mode(timing: ExcitationCurve): void; /** - * 创建一个动画执行器。 - * - * 在**组件内**需要动画器时**务必**使用此接口,否则可能会动画器没有被正确销毁,出现内存泄漏问题。 - * - * 在**组件外不要**使用此接口,否则可能没有效果! - * @param excitation 动画执行器使用的激励源 + * 设置动画的动画时长 + * @param time 动画时长 */ - useAnimater(excitation: IExcitation): IAnimater; - - /** - * 创建一个渐变执行器。 - * - * 在**组件内**需要渐变对象时**务必**使用此接口,否则可能会渐变对象没有被正确销毁,出现内存泄漏问题。 - * - * 在**组件外不要**使用此接口,否则可能没有效果! - * @param excitation 渐变执行器使用的激励源 - */ - useTransition(excitation: IExcitation): ITransition; + setTime(time: number): void; } //#endregion diff --git a/packages/render-vue/src/use.ts b/packages/render-vue/src/use.ts index d56d304..3e1bb2f 100644 --- a/packages/render-vue/src/use.ts +++ b/packages/render-vue/src/use.ts @@ -1,6 +1,12 @@ -import { IRenderTreeRoot } from '@motajs/render'; -import { onMounted, onUnmounted } from 'vue'; -import { IRendererUsing } from './types'; +import { IRenderTreeRoot, MotaRenderer, RenderItem } from '@motajs/render'; +import { + computed, + ComputedRef, + getCurrentInstance, + onUnmounted, + Ref, + ref +} from 'vue'; import { IExcitable, IAnimater, @@ -8,44 +14,378 @@ import { Animater, IExcitation, Transition, - excited + excited, + ExcitationCurve, + IAnimatable } from '@motajs/animate'; +import { ITransitionedController } from './types'; -export class RendererUsing implements IRendererUsing { - constructor(readonly renderer: IRenderTreeRoot) {} +//#region 函数功能接口 - onExcited(excitable: IExcitable): void { - onMounted(() => { - this.renderer.excitation.add(excitable); - }); - onUnmounted(() => { - this.renderer.excitation.remove(excitable); - }); +/** + * 尝试获取当前组件的根渲染元素,若无法找到可能存在的根元素,则返回 `null`。 + * 仅允许在组件的 `setup` 或其生命周期钩子中调用,否则一定返回 `null`。 + * + * ```ts + * const root = useRootRenderer()!; + * const ex = root.excitation; // 例如从根元素获取激励源 + * ``` + */ +export function useRendererRoot(): IRenderTreeRoot | null { + const instance = getCurrentInstance(); + if (!instance) return null; + // 尝试从几个路径获取根元素 + const root = instance.root.vnode.el; + if (root instanceof MotaRenderer) return root; + const currEl = instance.proxy?.$el; + if (currEl instanceof RenderItem) return currEl.root; + const appEl = instance.appContext.app._container; + if (appEl instanceof MotaRenderer) return appEl; + return null; +} + +/** + * 当根元素被激励时同时激励传入的被激励对象,仅可在组件的 `setup` 或其生命周期钩子(如 `onMounted`)中使用。 + * 在组件内需要每帧执行时务必使用此接口,否则可能会导致激励对象没有被正确删除,出现内存泄漏问题。在组件外调用此方法无效。 + * + * ```ts + * let curr = 0; + * const excitable: IExcitable = { + * excited(time) { curr = time; } + * } + * onExcited(excitable); + * ``` + * @param excitable 要执行的被激励对象 + */ +export function onExcited(excitable: IExcitable): void { + const renderer = useRendererRoot(); + if (!renderer) return; + const num = renderer.delegateExcitable(excitable); + onUnmounted(() => { + renderer.removeExcitable(num); + }); +} + +/** + * 当根元素被激励时同时执行传入的激励函数,仅可在组件的 `setup` 或其生命周期钩子(如 `onMounted`)中使用。 + * 在组件内需要每帧执行时务必使用此接口,否则可能会导致激励对象没有被正确删除,出现内存泄漏问题。在组件外调用此方法无效。 + * + * ```ts + * let curr = 0; + * const func = (time: number) => void (curr += time); + * onExcitedFunc(func); + * ``` + * @param excitable 要执行的激励函数 + */ +export function onExcitedFunc(func: (time: number) => void): void { + onExcited(excited(func)); +} + +/** + * 创建一个受指定激励源激励(一般为根渲染器的激励源)的动画执行器,仅可在组件的 `setup` 或其声明周期钩子中使用。 + * 如果不传入动画对象,那么当当前组件被卸载时,会一并把内部创建的动画对象销毁,此后不能再使用此动画对象。 + * 在组件中建议使用此方法来获取动画器,否则可能会导致动画器没有被正确销毁,出现内存泄漏问题。 + * + * ```ts + * const obj = ref(0); + * const anim = useAnimater()!; + * anim.animate(obj).to(100, 1000); + * ``` + * @param anim 手动指定动画对象,不传时会自动创建 + * @param excitation 手动指定激励源,不传时会使用根渲染器的激励源 + */ +export function useAnimater( + anim?: IAnimater, + excitation?: IExcitation +): IAnimater | null { + const renderer = useRendererRoot(); + if (!renderer) return null; + const ex = excitation ?? renderer.excitation; + const animater = anim ?? new Animater(); + animater.bindExcitation(ex); + onUnmounted(() => { + animater.unbindExcitation(); + if (!anim) animater.destroy(); + }); + return animater; +} + +/** + * 创建一个受指定激励源激励(一般为根渲染器的激励源)的渐变执行器,仅可在组件的 `setup` 或其声明周期钩子中使用。 + * 如果不传入渐变对象,那么当当前组件被卸载时,会一并把内部创建的渐变对象销毁,此后不能再使用此渐变对象。 + * 在组件中建议使用此方法来获取渐变对象,否则可能会导致渐变对象没有被正确销毁,出现内存泄漏问题。 + * + * ```ts + * const obj = ref(0); + * const anim = useAnimater()!; + * anim.transition(obj).to(100, 1000); + * ``` + * @param anim 手动指定动画对象,不传时会自动创建 + * @param excitation 手动指定激励源,不传时会使用根渲染器的激励源 + */ +export function useTransition( + tran?: ITransition, + excitation?: IExcitation +): ITransition | null { + const renderer = useRendererRoot(); + if (!renderer) return null; + const ex = excitation ?? renderer.excitation; + const transition = tran ?? new Transition(); + transition.bindExcitation(ex); + onUnmounted(() => { + transition.unbindExcitation(); + if (!tran) transition.destroy(); + }); + return transition; +} + +const transitionMap: Map = new Map(); + +/** + * 创建一个渐变数值,当数值发生变化时会缓慢变化值目标值而非突变,只可以用于组件内,不可用于组件外 + * ```tsx + * const value = transitioned(10, 300, linear()); // 创建渐变,初始值为 10,渐变时长 300ms,线性变化 + * value.set(100); // 渐变至 100 + * + * // 直接在元素上使用 + * + * ``` + * @param value 初始值 + * @param time 渐变时长 + * @param curve 渐变的速率曲线 + */ +export function transitioned( + value: number, + time: number, + curve: ExcitationCurve +): ITransitionedController | null { + const renderer = useRendererRoot(); + if (!renderer) return null; + const tran = transitionMap.getOrInsertComputed( + renderer, + () => new Transition() + ); + if (!tran.excitation) { + tran.bindExcitation(renderer.excitation); + } + return new RenderTransition(value, tran, time, curve); +} + +/** + * 创建一个渐变颜色,当颜色发生变化时会缓慢变化值目标值而非突变,自动判断颜色字符串类型,只可用于组件内,不可用于组件外 + * ```tsx + * // 创建渐变,初始值为 '#fff'(白色),渐变时长 300ms,线性变化 + * const color = transitionedColor('#fff', 300, linear()); + * color.set('rgba(129, 30, 40, 0.7)'); // 渐变至这个颜色 + * + * // 直接在元素上使用 + * + * ``` + * @param color 颜色的初始值 + * @param time 渐变时长 + * @param curve 渐变的速率曲线 + */ +export function transitionedColor( + color: string, + time: number, + curve: ExcitationCurve +): ITransitionedController | null { + const renderer = useRendererRoot(); + if (!renderer) return null; + const tran = transitionMap.getOrInsertComputed( + renderer, + () => new Transition() + ); + if (!tran.excitation) { + tran.bindExcitation(renderer.excitation); + } + return new RenderColorTransition(color, tran, time, curve); +} + +//#endregion + +//#region 渐变 + +class RenderTransition implements ITransitionedController { + readonly ref: Ref; + + set value(v: number) { + this.set(v); + } + get value() { + return this.ref.value; } - onExcitedFunc(fn: (payload: number) => void): void { - this.onExcited(excited(fn)); + constructor( + value: number, + readonly transition: ITransition, + public time: number, + public curve: ExcitationCurve + ) { + this.ref = ref(value); } - useAnimater(excitation: IExcitation): IAnimater { - const anim = new Animater(); - onMounted(() => { - anim.bindExcitation(excitation); - }); - onUnmounted(() => { - anim.unbindExcitation(); - }); - return anim; + set(value: number, time: number = this.time): void { + this.transition.curve(this.curve).transition(this.ref).to(value, time); } - useTransition(excitation: IExcitation): ITransition { - const tran = new Transition(); - onMounted(() => { - tran.bindExcitation(excitation); - }); - onUnmounted(() => { - tran.unbindExcitation(); - }); - return tran; + mode(timing: ExcitationCurve): void { + this.curve = timing; + } + + setTime(time: number): void { + this.time = time; } } + +type ColorRGBA = [number, number, number, number]; + +class RenderColorTransition implements ITransitionedController { + /** R 通道可动画对象 */ + private readonly rValue: IAnimatable; + /** G 通道可动画对象 */ + private readonly gValue: IAnimatable; + /** B 通道可动画对象 */ + private readonly bValue: IAnimatable; + /** A 通道可动画对象 */ + private readonly aValue: IAnimatable; + + readonly ref: ComputedRef; + + set value(v: string) { + this.set(v); + } + get value() { + return this.encodeColor(); + } + + constructor( + value: string, + readonly transition: ITransition, + public time: number, + public curve: ExcitationCurve + ) { + const [r, g, b, a] = this.decodeColor(value); + this.rValue = ref(r); + this.gValue = ref(g); + this.bValue = ref(b); + this.aValue = ref(a); + this.ref = computed(() => this.encodeColor()); + } + + set(value: string, time: number = this.time): void { + this.transitionColor(this.decodeColor(value), time); + } + + mode(timing: ExcitationCurve): void { + this.curve = timing; + } + + setTime(time: number): void { + this.time = time; + } + + /** + * 渐变至目标颜色 + * @param param0 目标颜色数组 + * @param time 渐变时长 + */ + private transitionColor([r, g, b, a]: ColorRGBA, time: number) { + this.transition + .curve(this.curve) + .transition(this.rValue) + .to(r, time) + .transition(this.gValue) + .to(g, time) + .transition(this.bValue) + .to(b, time) + .transition(this.aValue) + .to(a, time); + } + + /** + * 解析十六进制、rgba、rgb 颜色字符串 + * @param color 颜色字符串 + */ + private decodeColor(color: string): ColorRGBA { + if (color.startsWith('#')) { + return this.decodeHash(color); + } else if (color.startsWith('rgba(')) { + return this.decodeRGBA(color); + } else if (color.startsWith('rgb(')) { + return this.decodeRGB(color); + } + return [0, 0, 0, 1]; + } + + /** + * 解析十六进制颜色字符串 + * @param color 十六进制字符串 + */ + private decodeHash(color: string): ColorRGBA { + switch (color.length) { + case 4: + return [ + Number(`0x${color.slice(1, 2).repeat(2)}`), + Number(`0x${color.slice(2, 3).repeat(2)}`), + Number(`0x${color.slice(3, 4).repeat(2)}`), + 1 + ]; + case 5: + return [ + Number(`0x${color.slice(1, 2).repeat(2)}`), + Number(`0x${color.slice(2, 3).repeat(2)}`), + Number(`0x${color.slice(3, 4).repeat(2)}`), + Number(`0x${color.slice(4, 5).repeat(2)}`) + ]; + case 7: + return [ + Number(`0x${color.slice(1, 3)}`), + Number(`0x${color.slice(3, 5)}`), + Number(`0x${color.slice(5, 7)}`), + 1 + ]; + case 9: + return [ + Number(`0x${color.slice(1, 3)}`), + Number(`0x${color.slice(3, 5)}`), + Number(`0x${color.slice(5, 7)}`), + Number(`0x${color.slice(7, 9)}`) + ]; + } + return [0, 0, 0, 0]; + } + + /** + * 解析 RGBA 颜色字符串 + * @param color 颜色字符串 + */ + private decodeRGBA(color: string): ColorRGBA { + const data = color.slice(color.indexOf('(') + 1, color.indexOf(')')); + const [r, g, b, a] = data.split(','); + return [Number(r), Number(g), Number(b), Number(a)]; + } + + /** + * 解析 RGB 颜色字符串 + * @param color 颜色字符串 + */ + private decodeRGB(color: string): ColorRGBA { + const data = color.slice(color.indexOf('(') + 1, color.indexOf(')')); + const [r, g, b] = data.split(','); + return [Number(r), Number(g), Number(b), 1]; + } + + /** + * 编码颜色为 RGBA 字符串 + */ + private encodeColor() { + const r = this.rValue.value; + const g = this.gValue.value; + const b = this.bValue.value; + const a = this.aValue.value; + return `rgba(${r},${g},${b},${a})`; + } +} + +//#endregion