boycot 搜索
avatar

boycot

使用Element.animate添加文字与图片动画

在网页添加一些简单的切换动画一般使用 CSS3 的 animation 或者 transition 实现,而 Element.animate 是新的原生 Javascript Api,能使用 JS 快速为 Dom 添加动画。

前言

为了增加网站的用户体验,在很多场景下一般可以为元素的切换添加一下转场动画。

最简单的方法,一般可以使用 CSS 的transition或者animation实现。当前也有很多 CSS 动画库,例如animate.css,它与wow.js搭配使用经常用于很多产品宣传首页。

当然我们也可以使用一些主流的 JS 动画库操作某些元素的单独动画,例如:VelocityAnime.js等。或者更传统的Jquery也有提供.animate操作动画的方案。

而本文则介绍一下原生较新的 Javascript Api: Element.animate()

关于 Element.animate

Element.animate()Web Animations API提供的使用 Javascript 操作元素动画的解决方案。

参数

Element.animate(keyframes, options)方法接收 2 个参数,第一个为keyframes,第二个为options

keyframes:与 CSS3 的 keyframes 的概念是一致的,代表关键帧的集合。它可以接收一个关键帧数组,也可以简写成一个对象。它支持所有 CSS 动画支持的属性,另简写写法添加offset, float, easing等关键字 。具体写法请参考Keyframe Formats (MDN)或下文的案例使用。

options: 动画的相关配置。其接收delay, duration, easing, iterations等配置参数,可配置动画的延迟执行时间、执行持续时间、缓动曲线、执行次数等,其与 CSS 动画属性也保持一致,更多参数请参考KeyframeEffect (MDN)

这个方法会返回一个Animation实例,通过这个实例我们可以对动画进行暂停、取消、读取执行状态等。或者通过.finished返回 Promise 来对执行完动画进行下一步操作。

兼容性

因为该 API 较新,所以对传统的浏览器支持并不友好,所有 IE 浏览器都不支持。在Can I use上查询如下:

兼容性

但是只要简单使用if (dom.animate) {}包裹即可向下兼容,对一些不支持的浏览器不执行动画就可以。

使用案例

文字动画特效

简单写了三种文字动画特效:

  • FadeIn:渐变进入
  • FadeUpInOut: 旧文本先淡出新文本再淡入
  • Typewriter: 打字机特效

文字切换特效

淡入淡出

Effect1Effect2是更改opactitytranslate属性实现的文字淡入淡出动画。

<div class="text-wrapper" id="Effect1"></div>
<div class="text-wrapper" id="Effect2"></div>
<script>
  // ...省略事件绑定等代码
  function animateEffect1(text) {
    const target = document.querySelector("#Effect1");
    target.innerText = text;
    // 使用对象简写写法opactiy from 0, to 1, 执行时间600ms
    target.animate({ opacity: [0, 1] }, 600);
  }
  async function animateEffect2(text) {
    const target = document.querySelector("#Effect2");
    // finished返回Promise,可等待文本淡出动画执行完再执行新文本淡入动画
    await target.animate(
      {
        opacity: [1, 0],
        transform: ["translateY(0)", "translateY(-20px)"],
      },
      300
    ).finished;
    target.innerText = text; // 当旧文本动画执行完再开始替换文本
    target.animate(
      {
        opacity: [0, 1],
        transform: ["translateY(20px)", "translateY(0)"],
      },
      300
    );
  }
</script>

打字机

Effect3实现了一个文字打字机特效,该特效需要确保文字是等宽字体,而且文本不能为多行文本。

<div class="text-wrapper" id="Effect3"></div>
<script>
  // ...省略事件绑定等代码
  async function animateEffect3(text) {
    const target = document.querySelector("#Effect3");
    const beforeWidth = target.offsetWidth; // 计算旧文本宽度
    const textBeforeLength = target.innerText.length; // 计算文本字数
    if (textBeforeLength > 0) {
      // 使用数组参数方式执行宽度减少阶跃动画
      await target.animate([{ width: `${beforeWidth}px` }, { width: 0 }], {
        duration: textBeforeLength * 100,
        easing: `steps(${textBeforeLength})`, // step是阶跃函数,表示动画按多少步执行完
      }).finished;
    }
    target.innerText = text; // 切换新文本
    const afterWidth = target.offsetWidth; // 计算新文本宽度
    const textAfterLength = target.innerText.length; // 计算文本字数
    target.animate([{ width: 0 }, { width: `${afterWidth}px` }], {
      duration: textAfterLength * 100,
      easing: `steps(${textAfterLength})`,
    });
  }
</script>

easing属性中使用了steps阶跃函数,它表示动画需要按多少步执行完,每一步状态里面是属性是一致的,每步属性变化是跳跃的,没有过渡。这里使得文本每次减少一个字符的宽度,构造出打字机的效果。

以上文字特效的实现已上传到codepen,请参考此处: https://codepen.io/leon-kfd/pen/vYJbodr

图片切换特效

在使用 CSS 实现元素动画,一般通过添加类名、移出类名来实现。因为图片无法准确知道需要加载的时间,一般情况是监听图片的 load 事件回调进行判断,所以基本无法使用纯 CSS 来实现切换动画。

本次使用原生Element.animate()API 实现了一个简单的图片切换特效。

图片切换动画特效

这个特效主要原理:

  • 点击切换时,调用函数切换图片路径,这时候图片会异步加载
  • 在新图片加载过程中,旧图片执行一个高斯模糊叠加的渐变淡出动画,并把这个 Animation 对象记录下来
  • 为图片元素添加 load 事件监听,当图片加载完成,把旧图片淡出动画cancel(因为无法确保旧图片淡出动画执行完前新图片已经加载完成,需要Cancel掉旧动画防止重复执行)
  • 执行新图片的高斯模糊淡入动画,动画执行后修改元素 CSS 最终状态

Demo 代码如下:

<button id="btn">Random Img</button>
<p class="img-wrapper">
  <img id="img" />
</p>

<script>
  let leaveAnimation = null; // 用于记录Animation对象
  btn.addEventListener("click", () => {
    randomPhoto();
  });

  async function randomPhoto(first) {
    const target = `https://source.unsplash.com/random/512x512/?nature,${+new Date()}`;
    img.src = target;
    // 切换图片路径后,执行图片淡出动画,此时新图片在后台加载
    if (!first) {
      try {
        leaveAnimation = img.animate(
          [
            { filter: "blur(20px)", tarnsform: "scale(1,1)" },
            { filter: "blur(60px)" },
          ],
          400
        );
        await leaveAnimation.finished;
        img.style.filter = "blur(60px)";
      } catch {
        console.log("Cancel animation");
      }
    }
  }

  img.addEventListener("load", async () => {
    img.style.opacity = 1; // 用于防止首次加载闪图
    if (leaveAnimation) leaveAnimation.cancel(); // cancel掉淡出动画,防止重复执行
    const changeAnimation = img.animate(
      [
        { filter: "blur(20px)", tarnsform: "scale(1,1)" },
        { filter: "blur(0)", tarnsform: "scale(1)" },
      ],
      400
    );
    await changeAnimation.finished;
    img.style.filter = "blur(0)"; // 等待动画执行完后更改最终状态
  });

  randomPhoto(true); // 页面加载立即执行一遍
</script>

以上图片特效的实现已上传到codepen,请参考此处: https://codepen.io/leon-kfd/pen/ZEXYKLR

Demo 中使用了 unsplash 的随机图片接口, https://source.unsplash.com/random

另因当前Element.animate()仍属于实验特性,并不保证将来 api 会进行改动或添加新的特性。

乳白
杏仁黄
茉莉黄
麦秆黄
油菜花黄
佛手黄
篾黄
葵扇黄
柠檬黄
金瓜黄
藤黄
酪黄
香水玫瑰黄
淡密黄
大豆黄
素馨黄
向日葵黄
雅梨黄
黄连黄
金盏黄
蛋壳黄
肉色
鹅掌黄
鸡蛋黄
鼬黄
榴萼黄
淡橘橙
枇杷黄
橙皮黄
北瓜黄
杏黄
雄黄
万寿菊黄
菊蕾白
秋葵黄
硫华黄
柚黄
芒果黄
蒿黄
姜黄
香蕉黄
草黄
新禾绿
月灰
淡灰绿
草灰绿
苔绿
碧螺春绿
燕羽灰
蟹壳灰
潭水绿
橄榄绿
蚌肉白
豆汁黄
淡茧黄
乳鸭黄
荔肉白
象牙黄
炒米黄
鹦鹉冠黄
木瓜黄
浅烙黄
莲子白
谷黄
栀子黄
芥黄
银鼠灰
尘灰
枯绿
鲛青
粽叶绿
灰绿
鹤灰
淡松烟
暗海水绿
棕榈绿
米色
淡肉色
麦芽糖黄
琥珀黄
甘草黄
初熟杏黄
浅驼色
沙石黄
虎皮黄
土黄
百灵鸟灰
山鸡黄
龟背黄
苍黄
莱阳梨黄
蜴蜊绿
松鼠灰
橄榄灰
蟹壳绿
古铜绿
焦茶绿
粉白
落英淡粉
瓜瓤粉
蜜黄
金叶黄
金莺黄
鹿角棕
凋叶棕
玳瑁黄
软木黄
风帆黄
桂皮淡棕
猴毛灰
山鸡褐
驼色
茶褐
古铜褐
荷花白
玫瑰粉
橘橙
美人焦橙
润红
淡桃红
海螺橙
桃红
颊红
淡罂粟红
晨曦红
蟹壳红
金莲花橙
草莓红
龙睛鱼红
蜻蜓红
大红
柿红
榴花红
银朱
朱红
鲑鱼红
金黄
鹿皮褐
醉瓜肉
麂棕
淡银灰
淡赭
槟榔综
银灰
海鸥灰
淡咖啡
岩石棕
芒果棕
石板灰
珠母灰
丁香棕
咖啡
筍皮棕
燕颔红
玉粉红
金驼
铁棕
蛛网灰
淡可可棕
中红灰
淡土黄
淡豆沙
椰壳棕
淡铁灰
中灰驼
淡栗棕
可可棕
柞叶棕
野蔷薇红
菠萝红
藕荷
陶瓷红
晓灰
余烬红
火砖红
火泥棕
绀红
橡树棕
海报灰
玫瑰灰
火山棕
豆沙
淡米粉
初桃粉红
介壳淡粉红
淡藏花红
瓜瓤红
芙蓉红
莓酱红
法螺红
落霞红
淡玫瑰灰
蟹蝥红
火岩棕
赭石
暗驼棕
酱棕
栗棕
洋水仙红
谷鞘红
苹果红
铁水红
桂红
极光红
粉红
舌红
曲红
红汞红
淡绯
无花果红
榴子红
胭脂红
合欢红
春梅红
香叶红
珊瑚红
萝卜红
淡茜红
艳红
淡菽红
鱼鳃红
樱桃红
淡蕊香红
石竹红
草茉莉红
茶花红
枸枢红
秋海棠红
丽春红
夕阳红
鹤顶红
鹅血石红
覆盆子红
貂紫
暗玉紫
栗紫
葡萄酱紫
牡丹粉红
山茶红
海棠红
玉红
高粱红
满江红
枣红
葡萄紫
酱紫
淡曙红
唐菖蒲红
鹅冠红
莓红
枫叶红
苋菜红
烟红
暗紫苑红
殷红
猪肝紫
金鱼紫
草珠红
淡绛红
品红
凤仙花红
粉团花红
夹竹桃红
榲桲红
姜红
莲瓣红
水红
报春红
月季红
豇豆红
霞光红
松叶牡丹红
喜蛋红
鼠鼻红
尖晶玉红
山黎豆红
锦葵红
鼠背灰
甘蔗紫
石竹紫
苍蝇灰
卵石紫
李紫
茄皮紫
吊钟花红
兔眼红
紫荆红
菜头紫
鹞冠紫
葡萄酒红
磨石紫
檀紫
火鹅紫
墨紫
晶红
扁豆花红
白芨红
嫩菱红
菠根红
酢酱草红
洋葱紫
海象紫
绀紫
古铜紫
石蕊红
芍药耕红
藏花红
初荷红
马鞭草紫
丁香淡紫
丹紫红
玫瑰红
淡牵牛紫
凤信紫
萝兰紫
玫瑰紫
藤萝紫
槿紫
蕈紫
桔梗紫
魏紫
芝兰紫
菱锰红
龙须红
蓟粉红
电气石红
樱草紫
芦穗灰
隐红灰
苋菜紫
芦灰
暮云灰
斑鸠灰
淡藤萝紫
淡青紫
青蛤壳紫
豆蔻紫
扁豆紫
芥花紫
青莲
芓紫
葛巾紫
牵牛紫
紫灰
龙睛鱼紫
荸荠紫
古鼎灰
乌梅紫
深牵牛紫
银白
芡食白
远山紫
淡蓝紫
山梗紫
螺甸紫
玛瑙灰
野菊紫
满天星紫
锌灰
野葡萄紫
剑锋紫
龙葵紫
暗龙胆紫
晶石紫
暗蓝紫
景泰蓝
尼罗蓝
远天蓝
星蓝
羽扇豆蓝
花青
睛蓝
虹蓝
湖水蓝
秋波蓝
涧石蓝
潮蓝
群青
霁青
碧青
宝石蓝
天蓝
柏林蓝
海青
钴蓝
鸢尾蓝
牵牛花蓝
飞燕草蓝
品蓝
银鱼白
安安蓝
鱼尾灰
鲸鱼灰
海参灰
沙鱼灰
钢蓝
云水蓝
晴山蓝
靛青
大理石灰
海涛蓝
蝶翅蓝
海军蓝
水牛灰
牛角灰
燕颔蓝
云峰白
井天蓝
云山蓝
釉蓝
鸥蓝
搪磁蓝
月影白
星灰
淡蓝灰
鷃蓝
嫩灰
战舰灰
瓦罐灰
青灰
鸽蓝
钢青
暗蓝
月白
海天蓝
清水蓝
瀑布蓝
蔚蓝
孔雀蓝
甸子蓝
石绿
竹篁绿
粉绿
美蝶绿
毛绿
蔻梢绿
麦苗绿
蛙绿
铜绿
竹绿
蓝绿
穹灰
翠蓝
胆矾蓝
樫鸟蓝
闪蓝
冰山蓝
虾壳青
晚波蓝
蜻蜓蓝
玉鈫蓝
垩灰
夏云灰
苍蓝
黄昏灰
灰蓝
深灰蓝
玉簪绿
青矾绿
草原远绿
梧枝绿
浪花绿
海王绿
亚丁绿
镍灰
明灰
淡绿灰
飞泉绿
狼烟灰
绿灰
苍绿
深海绿
长石灰
苷蓝绿
莽丛绿
淡翠绿
明绿
田园绿
翠绿
淡绿
葱绿
孔雀绿
艾绿
蟾绿
宫殿绿
松霜绿
蛋白石绿
薄荷绿
瓦松绿
荷叶绿
田螺绿
白屈菜绿
河豚灰
蒽油绿
槲寄生绿
云杉绿
嫩菊绿
艾背绿
嘉陵水绿
玉髓绿
鲜绿
宝石绿
海沬绿
姚黄
橄榄石绿
水绿
芦苇绿
槐花黄绿
苹果绿
芽绿
蝶黄
橄榄黄绿
鹦鹉绿
油绿
象牙白
汉白玉
雪白
鱼肚白
珍珠灰
浅灰
铅灰
中灰
瓦灰
夜灰
雁灰
深灰