# S.ImageZoom

乔花

2010.07

一. 应用场景

二. 同类组件

三. 功能分析

四. 技术方案

五. Public API

六. 开发计划

七. 其它

淘宝、京东等电子商务网站的宝贝图片细节显示

1) 凡客: 大图, 小图高度不相等.

2) 京东: 黄色的镜片遮罩影响了色度. 透明的效果好些.

3) 淘宝: 默认有一个放大镜在小图右下角, 提醒用户有放大的功能, 用户引导性比较好. 鼠标移至小图上方, 放大镜消失; 小图上没有镜片效果.

4) Zazzle: 大图和小图的高度有点偏差, 不知道是不是故意这么设计的.

5) Apple:
* 标移至上方显示放大镜, 点击, 以鼠标点击的位置为轴心放大图片, 鼠标变成手型, 单击鼠标不放可拖动大图. 只能单独显示小图或者大图, 没有整体和局部的对比;
*用户增加了点击鼠标拖动的操作;
*在大图上移动, 用户鼠标的移动范围要大些, 影响效率;
*用户不能直接定位到自己想看的位置.
*小图放大到大图, 过渡很自然.

    1. JQZoom：http://www.mind-projects.it/projects/jqzoom/
        - 基于 jQuery 类库，大小 8.7k
        - 支持 standard 和 reverse 两种显示类型；
        - 提供 preload 功能，大图显示时支持特效；
        - 配置丰富，调用方便。

    2. ImageZoom: http://www.cnblogs.com/cloudgamer/archive/2010/04/01/ImageZoom.html
        - 基于 CJL 类库，大小 6.1k
        - 支持 standard, follow, reverse, handle 等多种显示类型；
        - 支持使用原图放大。大图未加载前，使用原图放大，减少等待时间；
        - 支持预加载、放大系数、自动隐藏、鼠标滚动缩放大图等功能；
        - 功能是同类组件中最全的，两篇介绍博文也相当不错。

    3. ImageScaler: http://yiminghe.javaeye.com/blog/388872
        - 基于 Ext 类库，大小 6.9k
        - 有缩放功能、支持拖拽、移动；
        - 严格说来，这个组件的目的不是图片放大，而是图片裁剪功能，挺有意思。

    4. AnythingZoomer: http://css-tricks.com/examples/AnythingZoomer/image.php
        - 基于 jQuery 类库，大小 1.2k
        - 显示类型只有跟随模式；
        - 强大之处在于，该组件可以放大任何区域，比如文本等等，不愧为 anything zoomer!

    5. CloudZoom: http://www.professorcloud.com/mainsite/cloud-zoom.htm
        - 做的很漂亮, 细节处理...

    1. 显示类型，可总结为以下 3 类：
        - 标准模式 standard: 可参考 JQZoom 的默认显示，可设置 放大镜 lens 是否显示；
        - 反转模式 reverse:  可参考 JQZoom 的反转模式，或 CJL ImageZoom 的 cropper 模式，该模式下，lens 必须显示；
        - 跟随模式 follow:   可参考 CJL ImageZoom 的 follow 模式。

       特有意思：Zazzle 上的 follow 模式非常值得仿效：Zazzle
       反转模式在调研的在线应用中，没有一家采用。很可能是因为反转效果很唐突，对用户体验无益。
       无 lens 的标准模式，在在线应用中也很少看到。因为有 lens 的感觉更佳，组件实现时，可以不考虑无 lens 的标准模式。
       综上考虑，KISSY 将实现以下两种显示类型：
        - 标准模式 standard  显示 lens
        - 跟随模式 follow    分 普通跟随模式 和 Zazzle 的跟随模式，具体参数实现时再定

    2. 大图的预加载功能。基本是标配，KISSY 可以进一步做到：
        - 仿照 Zazzle 的效果，在大图加载过程中显示进度条，以及相关提示文字

    3. 放大系数、滚轮缩放、拖曳裁剪等功能，对用户用途不大，不支持

    4. 放大镜提示小图片很不错，能引导用户主动悬浮，支持该功能

- 假定：小图和大图的尺寸都已知

- 小图上某个区域的尺寸也给定

- 1) 目标显示区域如何计算

- 2) 如何将小图上的显示区域映射到大图上的显示区域

目标显示区域计算

镜片位置

边界处理

鼠标移动时，小区域映射到大区域

一些细节

- 边框: 扣除上下左右边框宽度

- 跟随模式下：
* 1) 镜片边界超过小图宽度有镜片宽度的一半；
* 2) 显示区域应该是以鼠标为中心的，所以大图偏移应加镜片宽度的一半。

- 大小图尺寸：当小图加载完才继续初始化。大图加载设置定时器，没有加载完成前，使用 config 中设定的大图尺寸大小；当加载完之后重新计算显示区域大小；如果超时就给出无法加载提示。

    config:
        type: STANDARD,            // 显示类型

        bigImageSrc: '',           // 大图路径，为 '' 时，会取 data-src
        bigImageSize: [900, 900],  // 大图高宽, 大图高宽是指在没有加载完大图前, 使用这个值来替代计算,
                                   // 等加载完后会重新更新镜片大小, 具体场景下, 设置个更合适的值.
        position: 'right',         // 大图显示位置。仅支持 right, 不开放其它值
        offset: 10,                // 大图位置的偏移量。单一值或 [x, y]
        preload: true,             // 是否预加载大图
        timeout: 120,              // 等待大图加载的最大时间, 单位: s  默认 2 min
        timeoutMsg: '图片暂不可用',

        zoomSize: [AUTO, AUTO],    // 放大区域宽高
        lensIcon: true,            // 是否显示放大镜提示图标

        zoomCls: ''                // 放大区域额外样式
    Member:
        image       // 需要缩放的图片
        config      // 配置参数
        lens        // 镜片
        lensIcon    // 放大镜图标
        bigImage    // 大图
    Method:
        show()      // 显示
        hide()      // 隐藏
        set(name, val) // 重新设置某些值

基本使用

    1) 出现镜片, 大图位置在小图右边, 如宝贝详情页上:
            new S.ImageZoom("#standard", {
                                bigImageSrc: "http://img03.taobaocdn.com/bao/uploaded/i3/T1fftwXf8jXXX7ps79_073021.jpg"
                            });

7月完成初稿; --version 0.1

8月第一次重构, 去除不必要功能; --version 1.0

9月第二次重构, 基于 Overlay 扩展; --version 1.0

9月实现Follow模式, 类似于 zazzle 上的效果; --version 1.1

    接口是否足够 KISS：
    S.ImageZoom(selector, config);

    第一次悬浮事件的命名?
    zoom.on('firstHover', ...);
    or
    zoom.on('loadBigImage', ...);

    需不需要下面这些事件：
    zoom.on('show', ...);
    zoom.on('hide', ...);

    要暴露哪些公共方法：
    ?

    已有功能是否已满足 8/2 原则?
    已有功能是否都需要? 有什么可以砍掉的鸡肋吗?
    通过扩展可以实现不常用的那 20% 吗?

    支持 touch 设备?

使用文档： http://kissyteam.github.com/kissy/docs/imagezoom/index.html

测试页面： http://kissyteam.github.com/kissy/src/imagezoom/test.html