jQuery.Keyframes 技术文档

1. 安装指南

首先，您需要在 HTML 文档中引入 jQuery 库：

<script src='http://code.jquery.com/jquery-3.3.1.slim.min.js'></script>

然后，通过以下代码行将 jQuery.Keyframes 库包含到您的文档中：

<script src='/path/to/jquery.keyframes[.min].js'></script>

请确保在页面加载完毕后再定义和播放动画，可以使用 window.onload 事件。

2. 项目使用说明

检测 CSS 动画支持

var supportedFlag = $.keyframe.isSupported();

添加新的动画序列（关键帧）

$.keyframe.define([{
    name: 'trapdoor-sequence',
    '0%': {'height': '70px'},
    '30%': {'height': '10px'},
    '60%': {'height': '30px'},
    '100%': {'height': '10px'}
}]);

添加单个帧样式

$.keyframe.define({
    name: 'ball-roll',
    from: {
        'transform': 'rotate(0deg)'
    },
    to: {
        'transform': 'rotate(360deg)'
    }
});

添加多个帧样式

$.keyframe.define([{
    name: 'roll-clockwise',
    '0%': {
        'margin-left': '0px',
        'background-color': 'red',
        'transform': 'rotate(0deg)'
    },
    '100%': {
        'margin-left': '600px',
        'transform': 'rotate(360deg)'
    }
    },{
    name: 'roll-anti-clockwise',
    '0%': {
        'margin-left': '0px',
        'background-color': 'red',
        'transform': 'rotate(0deg)'
    },
    '100%': {
        'margin-left': '600px',
        'transform': 'rotate(-360deg)'
    }
}]);

添加响应式动画

$.keyframe.define([{
    name: 'roll-clockwise',
    media: 'screen and (max-width: 700px)',
    from: {
        'margin-left': '0px'
    },
    to: {
        'margin-left': '600px'
    }
}]);

3. 项目 API 使用文档

播放动画

播放 CSS3 动画的方法在 W3Schools 上有详细文档。

$(selector).playKeyframe({
    name: 'trapdoor-sequence',
    duration: '1s',
    timingFunction: 'linear',
    delay: '0s',
    iterationCount: 'infinite',
    direction: 'normal',
    fillMode: 'forwards',
    complete: function(){}
});

播放动画（简写形式）

$(selector).playKeyframe(
    'trapdoor-sequence 1s linear 0s infinite normal forwards',
    complete
);

播放多个动画

$(selector).playKeyframe([
    'trapdoor-sequence 1s linear 0s infinite',
    {
      name: 'ball-roll',
      duration: "3s",
      timingFunction: 'ease',
      iterationCount: 1
    }
], complete);

重置动画

$(selector).resetKeyframe(callback);

冻结关键帧动画并杀死回调

$(selector).pauseKeyframe();

恢复关键帧动画

$(selector).resumeKeyframe();

4. 项目安装方式

请参照“安装指南”部分中的步骤进行安装。确保在文档中正确引入 jQuery 和 jQuery.Keyframes 库，并在页面加载完毕后使用相关方法。