Skip to content

feeingHe/-Viewer-

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 

Repository files navigation

VIEWER 图片、视频附件查看器插件

Viewer组件

说明:

该组件采用UMD规范,基于swiper2开发,兼容CMD/AMD 等规范。

浏览器向下兼容到IE9,可预览图片、视频;

依赖文件:picture-viewer.all.min.js/viewer.css (某些规范下需要提前引入jquery)
调用的方式:$(selector).picViewer(options) 返回Viewer对象。

1、options配置项说明

options配置项 类型 是否必须 默认值 参数说明
data Object [] 组件的数据源,如:
 [ 
{img: ”../img/1.png”, text:”我是文字1” },
{
img:”../img/2.png”, text:”我是文字2”,
isVideo:true,
videoSrc:”./video/sy.mp4” }
]
height Number 300 组件的高度值~
width Number 300 组件的宽度值
viewable Boolean true 组件是否可点击打开大图预览
uploadBtnText String “上传” 上传按钮文字的内容【第一个按钮显示的文案】
deleteBtnText String “删除该附件” 删除按钮文字的内容【第二个按钮显示的文案】
uploadBtnTitle String “上传” 上传按钮的提示文字【第一个按钮显示的提示文案】
deleteBtnTitle String “删除该附件” 删除按钮的提示文字【第二个按钮显示的提示文案】
hasUploadAndDeleteBtns Boolean true 是否有 上传删除 按钮
paginationModel String “point” 分页器的模式,
可选值有:
“point” :分页器为 圆点模式
“image” :分页器为 缩略图模式
afterView Function null 点击打开大图预览之后的回调方法,
必须配合viewable为true时使用
onUpload Function null 点击上传按钮之后的回调
onDelete Function null 点击删除按钮之后的回调
swiper Object 默认值:
{ 
loop: false,
// 循环模式选项
// 如果需要分页器
pagination:'.swiper-pagination',
paginationClickable:true,
// 如果需要前进后退按钮
navigation: {
nextEl: '.swiper-button-next',
prevEl: '.swiper-button-prev'
},
onSlideClick: function () {}
}

该配置项与swiper2的所有配置均一致,
配置项比较多,
具体请查看swiper2的API文档,
请自行百度搜索

2、Viewer对象方法说明

方法 参数说明
addItem 新增某一项
Viewer.addItem(index,data)
index:在索引值为index的图片后,新增某一项或者多项,索引的起始值为0。
data:需要新增的数据,支持Object/Array
示例:
 Viewer.addItem(activeIndex, [{
img: './images/tibet-2.jpg',
videoSrc:'./video/sy.mp4',
text: '我是img123123',
isVideo:true
}]);
removeItemByIndex 删除某一项
Viewer.removeItemByIndex (index)
index:删除索引值为 index的附件,索引的起始值为0。
示例:
Viewer. removeItemByIndex(3);
refresh 刷新viewer组件
Viewer.refresh (data)
data:此项说明参考options配置项的data说明。
 Viewer.addItem({
height:500
});
getSwiper 获取swiper对象 Viewer.getSwiper(callbackFn)
callbackFn:回调的方法,swiper对象以参数返回。
示例:
 Viewer.getSwiper(function( swiper ){
//swiper对象以参数的形式返回
//swiper对象具体用法同swiper2组件返回的对象
//具体参考swiper2的官方文档,此处不再赘述
});

3、Viewer调用示例

var viewer = $('.test').picViewer({
    height:340,
    width:500,
    viewable:true,//是否开启图片查看器
    uploadBtnText:"上传1213",
    deleteBtnText:"删除该附件223",
    uploadBtnTitle:"上传aaa",
    deleteBtnTitle:"删除该附件aa",
    hasUploadAndDeleteBtns:true,//是否有上传和删除按钮 
    paginationModel:"image", //point image
    data:[
        { img: './images/tibet-1.jpg',
            text: "我是video",
            isVideo:true,//标识video
            videoSrc:'./video/sy.mp4'
        },
        {  img: './images/posx.jpg', text: 'adsad' }, 
 ],
 afterView:function(d){
        console.log(d)
 },
 onUpload:function(params){
        viewer.addItem(params.activeIndex,[{
            img: './images/tibet-2.jpg',
            videoSrc:'./video/sy.mp4',
            text: '我是img123123',
            isVideo:true
        }]);
        console.log(params)
 },
 onDelete:function(params){
        viewer.removeItemByIndex(params.activeIndex);
        viewer.getSwiper(function(swiper){
            console.log('swiper:',swiper)
        });
        viewer.refresh({
            height:200
        })

 },
 swiper:{
        // swiper2 兼容到ie9
        slidesPerView: 1,
        mode:'vertical',
        loop:false
  },
});

*** waao ~ ,markdown的 table 排版是个辛苦活呢,用个 star 表示你的认可吧~***

About

图片附件查看器插件

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published