diff --git a/tutorial/omi-transform.cn.md b/tutorial/omi-transform.cn.md index 48569d678..2f9dc5159 100644 --- a/tutorial/omi-transform.cn.md +++ b/tutorial/omi-transform.cn.md @@ -180,6 +180,131 @@ this.data.rotateZ = this.animDiv.rotateZ ## css3transform +## 简介 + +在过去的两年,越来越多的同事、朋友和其他不认识的童鞋进行移动web开发的时候,都使用了[css3transform](https://github.com/AlloyTeam/AlloyTouch/tree/master/css3transform),所有必要介绍一下,让更多的人受益,提高编程效率,并享受编程乐趣。(当然css3transform不仅仅支持移动设备,[支持CSS3 3D Transforms的浏览器](http://caniuse.com/#search=CSS3%203D)都能正常使用css3transform) + + +## 传送门 + +官方网站:[http://alloyteam.github.io/AlloyTouch/css3transform/](http://alloyteam.github.io/AlloyTouch/css3transform/) +Github地址:[https://github.com/AlloyTeam/AlloyTouch/tree/master/css3transform](https://github.com/AlloyTeam/AlloyTouch/tree/master/css3transform) + +## 安装 +```js +npm install css3transform +``` + +## API +```js +Transform(domElement, [notPerspective]); +``` + +通过上面一行代码的调用,就可以设置或者读取 domElement的"translateX", "translateY", "translateZ", "scaleX", "scaleY", "scaleZ", "rotateX", "rotateY", "rotateZ", "skewX", "skewY", "originX", "originY", "originZ"! + +方便吧! + + +## 使用姿势 + +```js +Transform(domElement);//or Transform(domElement, true); + +//set "translateX", "translateY", "translateZ", "scaleX", "scaleY", "scaleZ", "rotateX", "rotateY", "rotateZ", "skewX", "skewY", "originX", "originY", "originZ" +domElement.translateX = 100; +domElement.scaleX = 0.5; +domElement.originX = 50; + +//get "translateX", "translateY", "translateZ", "scaleX", "scaleY", "scaleZ", "rotateX", "rotateY", "rotateZ", "skewX", "skewY", "originX", "originY", "originZ" +console.log(domElement.translateX ) +``` + +## 传统的CSS3编程的问题 +以前,我们一般使用animate.css、zepto/jQuery的animate方法或者tween.js+css3进行交互特效编程。总结下来有三个缺点: +- 不直观 +- 不直接 +- 不方便 + +### 不直观 +看下面这张图: +![](https://lc-api-gold-cdn.xitu.io/827c350ead224a857fdb.png) + +顺序影响结果,不直观。那么为什么会是这个结果?可以通过new WebKitCSSMatrix(transform_str)对比最终的matrix。 +![](https://user-gold-cdn.xitu.io/2016/11/29/4a62743f763d912afed7202e03127712) + +这也直接说明了矩阵不符合交换律。A*B!=B*A + +## 不直接 + +zepto姿势: + +```js +$("#some_element").animate({ + opacity: 0.25, left: '50px', + color: '#abcdef', + rotateZ: '45deg', translate3d: '0,10px,0' +}, 500, 'ease-out') + +``` +translate3d: '0,10px,0'非常不方便,无法step递进递减控制。更别提配合一些运动或者时间的库来编程了。可能你会反驳'ease-out'不就可以实现缓动吗?但是如果我需要让x和y以及z分别对应不同的缓动函数,这种基于字符串编程的形式就费劲了~~ +这里还需要注意的是,zepto里的顺序也会影响结果。因为其最后也是拼成string赋给dom元素。 + +tween.js姿势 +```js +var position = { x: 100, y: 100, rotation: 0 }, + target = document.getElementById('target'); + + new TWEEN.Tween(position) + .to({ x: 700, y: 200, rotation: 359 }, 2000) + .delay(1000) + .easing(TWEEN.Easing.Elastic.InOut) + .onUpdate(function update() { + var t_str= 'translateX(' + position.x + 'px) translateY(' + position.y + 'px) rotate(' + Math.floor(position.rotation) + 'deg)'; + element.style.transform = element.style.msTransform = element.style.OTransform = element.style.MozTransform = element.style.webkitTransform = t_str; + }); +``` +使用字符串的方式,看着就心累。更别提写的过程要遭受多少折磨。 + +animate.css姿势: +```css +@keyframes pulse { + from { + -webkit-transform: scale3d(1, 1, 1); + transform: scale3d(1, 1, 1); + } + + 50% { + -webkit-transform: scale3d(1.05, 1.05, 1.05); + transform: scale3d(1.05, 1.05, 1.05); + } + + to { + -webkit-transform: scale3d(1, 1, 1); + transform: scale3d(1, 1, 1); + } +} +``` +animate.css封装了一大堆关键帧动画,开发者只需要关心添加或者移除相关的动画的class便可以。这一定程度上给交互特效带来了极大的遍历,但是要有硬伤: +- 可编程性不够高 +- 适用于简单场景 +- 没有change回调,只有end回调 + +## 不方便 +transform的旋转点基准点默认是在中心,但是有些是时候,不系统在中心,我们传统的做法是使用transform-origin来设置基准点。 +![](https://user-gold-cdn.xitu.io/2016/11/29/666f43f1ad1c941c7499c94104872d8d) + +注意,是另一个属性transform-origin,而不是transform。但是如果需要运动transform-origin呢?这种设计是不是就废了?有没有需要运动origin的场景?这个在游戏设计中是经常会使用的到,这个以后另外单独开篇再说,事实就是,有场景是需要运动origin来达到某种效果。 + + +## css3transform +基于上面种种不便,所以有了css3transform! + +- css3transform 专注于CSS3 transform读取和设置的一个超轻量级js库,大大提高了CSS3 transform的可编程性 +- css3transform 高度抽象,不与任何时间、运动框架捆绑,所以可以和任意时间、和运动框架轻松搭配使用 +- css3transform 使用matrix3d为最终输出给dom对象,硬件加速的同时,不失去可编程性 +- css3transform 拥有超级易用的API,一分钟轻松上手,二分钟嵌入真实项目实战 +- css3transform 扩展了transform本身的能力,让transform origin更加方便 + ## Star & Fork [→ omi-transform](https://github.com/Tencent/omi/tree/master/packages/omi-transform)