HarmonyOS - 基于ArkUI（JS）实现信件弹出效果 原创 精华

作者：罗晓纯

自从大家使用QQ、微信、邮件等网络平台交流以后，大家对纸这种介质和书信这种通讯方式可能都比较陌生了。可别觉得书信是一个过时的东西，它可是80后的情怀，90后的回忆，00后的新宠，是经典的代名词。今天就想实现把这些古老的元素融入到新时代的产物当中。

工具：DevEc Studio 3.0 Beta3

主要用到知识：animation，Options，keyframes

官方API链接： 动画效果

信件由信封上部分、信封主体和信纸三部分组成，首先通过css实现将三个部分组合成信封的样式，接下来根据animation组件方法中的播放或取消方法来实现信件弹出或收回的动画效果，并在信件展开的同时，使用定时器实现模拟读取文字的效果。

调整信封上下两个部分的位置，并调整信封和信纸三个部分的层级

在点击信件之后，通过id属性标识获取组件对象并调用animate组件方法，给不同id对象调用对应的动画方法

对信封两个部分传入展开后的新位置，同时传入信纸新的height值和bottom值

使用定时器实现模拟读文字效果

判断是折叠信封时，调用animate组件的cancel（）方法，实现信封收回的效果

使用到的官方 API

​ 1. Options属性说明

string normal 指定动画的播放模式：<br />normal：动画正向循环播放；<br />reverse：动画反向循环播放；<br />alternate：动画交替循环播放，奇数次正向播放，偶数次反向播放；<br />alternate-reverse：动画反向交替循环播放，奇数次反向播放，偶数次正向播放。 string 指定动画开始和结束的状态：<br />none：在动画执行之前和之后都不会应用任何样式到目标上。<br />forwards：在动画结束后，目标将保留动画结束时的状态（在最后一个关键帧中定义）。<br />backwards6+：动画将在animation-delay期间应用第一个关键帧中定义的值。当animation-direction为"normal"或"alternate"时应用from关键帧中的值，当animation-direction为"reverse"或"alternate-reverse"时应用to关键帧中的值。<br />both：动画将遵循forwards和backwards的规则，从而在两个方向上扩展动画属性。

​ 2. keyframes 属性说明

string ‘center center’ 变换对象的中心点。<br />第一个参数表示x轴的值，可以设置为left、center、right、长度值或百分比值。<br />第二个参数表示y轴的值，可以设置为top、center、bottom、长度值或百分比值。 transform Transform 设置到变换对象上的类型 offset number -offset值（如果提供）必须在0.0到1.0（含）之间，并以升序排列。<br />-若只有两帧，可以不填offset。<br />-若超过两帧，offset必填。

​ 4. animation对象方法说明

<div class="wrap" >
    <div class="letter">
        <image class="envelopeHead" id="envelopeHead" src="common/images/before.png" style="bottom: {{headerBottom}}px"></image>
        <image class="envelope"  id="envelope" src="common/images/after.png" style="bottom: {{envelopeBottom}}px"></image>
        <div class="paper" id="paper"  onclick="fold" style="bottom: {{paperBottom}}px;height:{{paperHeight}}px">
            <text class="title">{{ title }}</text>
           <text class="content">{{content}}</text>
2. css 部分
.wrap {
    justify-content: center;
    align-items: center;
    flex-direction: column;
    width: 100%;
    height: 100%;
    background-color: #dce6f2;
.letter{
    height: 450px;
    position: relative;
    top: 0px;
/*信封口样式*/
.envelopeHead {
    position: absolute;
    bottom: 250px;
    left: 15px;
    width: 330px;
    height: 200px;
    z-index: 1;
/*信封样式*/
.envelope{
    bottom: 150px;
    position: absolute;
    left: 15px;
    width: 330px;
    height: 200px;
    z-index: 3;
/*信纸样式*/
.paper{
    position: absolute;
    width: 290px;
    left: 35px;
    justify-content: flex-start;
    background-color: #f7f2ec;
    bottom: 150px;
    z-index: 2;
    flex-direction: column;
    padding: 0 10px;
/* 称呼*/
.title{
    font-size: 26px;
    text-shadow: 0 1px 0 #ede8d9;
    height:60px;
    width: 100%;
/*信件内容*/
.content{
    font-size: 26px;
    text-shadow: 0 1px 0 #ede8d9;
    width: 100%;
    line-height:40px;
3. js 部分
import prompt from '@system.prompt';
export default {
    data: {
        title: "致各位小伙伴:",
        content: "",
        message: "展信悦！欢迎大家来到Harmony OS社区！",
        headerBottom: 240,
        paperBottom: 150,
        envelopeBottom: 150,
        paperHeight: 170,
        animation: '',
        animation2: '',
        animation3: '',
        number: 1
    onInit() {
    onShow() {
        var options = {
            duration: 150,
            easing: 'ease-in-out',
            delay: 0,
            fill: 'forwards',
            iterations: 2,
            direction: 'normal',
        var frames = [
                transform: {
                    translate: '0px 120px'
                opacity: 1.0,
                offset: 1.0,
                height: '350px',
                'bottom': 0
        var framesHead = [
                transform: {
                    translate: '0px 120px'
                opacity: 1.0,
                offset: 1.0,
        var framesEnvelope = [
                transform: {
                    translate: '0px 120px'
                opacity: 1.0,
                offset: 1.0,
        this.animationPaper = this.$element('paper').animate(frames, options);
        this.animationHead = this.$element('envelopeHead').animate(framesHead, options);
        this.animationEnvelope = this.$element('envelope').animate(framesEnvelope, options);
    fold() {
        // 判断是否是展开信纸
        if (this.number % 2 === 1) {
            // 展开信纸
            this.animationPaper.play();
            this.animationHead.play();
            this.animationEnvelope.play();
            for (var index = 0; index < 8; index++) {
                this.content += " "
            var num = 0
            var timer = setInterval(() => {
                if (num < this.message.length) {
                    this.content += this.message[num]
                    num++
                }else{
                    this.timer = null;
            }, 150)
        } else {
            // 收回信纸
            this.animationPaper.cancel();
            this.animationHead.cancel();
            this.animationEnvelope.cancel();
            this.content = "";
        this.number++
该篇是通过鸿蒙动画实现的一个小练习，目前我们已经可以借助各种特效功能把实体产品的操作体验模拟到网页上，使得页面看起来更加人性化，更具亲和力。后续还需继续努力，也欢迎大家一起讨论研究！
更多原创内容请关注：中软国际 HarmonyOS 技术团队
入门到精通、技巧到案例，系统化分享HarmonyOS开发技术，欢迎投稿和订阅，让我们一起携手前行共建鸿蒙生态。