GSAP - GSAP方法:gsap.context()

一、gsap.context()提供了兩個關鍵好處:

  • 收集在提供的函數中創建的所有GSAP動畫和ScrollTriggers,以便您可以輕松地一次性將它們全部revert() or kill()。不需要跟蹤一堆變量、數組等。這在React模塊或任何你需要通過將元素恢復到原始狀態來“清理”的地方特別有用。
  • [可選]將所有選擇器文本設置為特定的元素或Ref.這可以幫助簡化你的代碼,避免在React/Angular中創建大量的Ref。在提供的函數中,任何與gsap相關的選擇器文本將只應用于Element/Ref的后代。

假設你有一大塊GSAP代碼,它正在創建一堆不同的動畫,你需要能夠將它們全部還原()…

let ctx = gsap.context(() => {
 gsap.to(...);
 gsap.from(...);
 gsap.timeline().to(...).to(...);
 ...
});
// 然后
ctx.revert(); // BOOM! 在該函數中創建的每個GSAP動畫都將恢復!

二、選擇器文本作用域:

你可以選擇傳入一個Element或React Ref或Angular ElementRef,然后所提供函數中的所有選擇器文本都將被限定在特定的Element/Ref上,這可以極大地簡化你的代碼。不再為你想要動畫的每個元素創建Ref !

let ctx = gsap.context(() => {
  gsap.to(".box", {...}) // <- 正常的選擇器文本,自動作用域到myRefOrElement
  gsap.from(".circle", {...}); 
}, myRefOrElement); // <- scope!!!

作用域可以是選擇器文本本身,如".myClass"。或者一個元素,React Ref或Angular的ElementRef。

三、添加到上下文:

也許你需要設置事件處理程序(比如鼠標點擊)來創建新的動畫,這些動畫也應該被收集到上下文中,但顯然這些事件將在上下文的函數已經執行之后發生。沒問題!你可以將自己的方法添加到Context對象中,這樣當它們運行時,它們會自動將任何生成的GSAP動畫/ScrollTriggers添加到Context中:

let ctx = gsap.context((self) => {
  //使用任意字符串作為名稱;它會被添加到Context對象中,所以在這種情況下你可以調用ctx.onClick()
  self.add("onClick", (e) => {
    gsap.to(...); // <-- 被添加到上下文!
  });
}, myRefOrElement);

// 現在Context有了一個onClick()方法,我們可以使用該方法,該函數中的任何動畫都會被添加到Context中
myButton.addEventListener("click", (e) => ctx.onClick(e));

或者你可以像這樣直接向Context中添加內容(作為第一個參數):

// 先創建好上下文
let ctx = gsap.context(() => {...});

// 之后再添加到上下文
ctx.add(() => {
  gsap.to(...); // 現在所有這些都被添加到Context中。
  gsap.from(...); 
});

四、清理函數:

您可以選擇返回一個“清理函數”,如果/當上下文恢復時應該調用該函數。這可以包含你自己的自定義清理代碼:

let ctx = gsap.context(() => {
  ...
  return () => {
    //我的自定義清理代碼。在觸發ctx.revert()時調用。
  };
});

你也可以在任何.add()函數中返回一個清理函數;當Context的revert()被調用時,它們都將被調用。

五、忽略特定的animations/ScrollTriggers

在非常不常見的情況下,你可能想要在函數內部創建某些GSAP動畫和/或ScrollTriggers,這些動畫應該從上下文中排除(當上下文被恢復/殺死時不被恢復/殺死),在這種情況下,你可以像這樣使用ignore():

let ctx = gsap.context((self) => {
  gsap.to(...); // <- 將得到恢復當ctx.revert()被調用的時候
  self.ignore(() => {
    gsap.to(...); // <- 當ctx.revert()被調用時將不會被恢復。忽略,沒有記錄在上下文中。
  });
});

六、小秘訣:

  • 當在Context上調用revert()時,它對于它包含的動畫/ScrollTriggers是永久的。它們將被還原并殺死,Context將自己清除,使它們符合垃圾收集的條件。但是在此之后仍然可以添加更多的動畫,并且可以在相同的Context上再次調用revert()來revert/kill這些動畫。
  • Context并不是用來控制動畫的。這就是時間線的作用。Context只是用于還原/刪除和[可選地]定義選擇器文本的作用域。
    Context對象本身被傳遞給函數,所以你可以很容易地引用它,像:gsap.context((self) => { ... self.add(...); });
    gsap.context()在3.11.0版本中添加

七、React Demo

gsap.context()可以解決React 18“在嚴格模式下雙重調用useEffect()”的問題,該問題通常會從()邏輯中中斷-只需在useEffect()清理函數中調用revert():
React Demo

?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,505評論 6 533
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,556評論 3 418
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,463評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,009評論 1 312
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,778評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,218評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,281評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,436評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,969評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,795評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,993評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,537評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,229評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,659評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,917評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,687評論 3 392
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,990評論 2 374

推薦閱讀更多精彩內容