在使用 CSS 美化表單元素時,文件上傳控件一直是個老大難問題——原生控件的外觀既單調又難以統一風格。本文將介紹一款名為 jQuery.liveFakeFile 的插件,它能將其貌不揚的文件上傳控件,變身為一個既美觀又好用的自定義按鈕,還能即時預覽用戶選取的圖片。
需求聽起來簡單,實作起來卻頗具技巧,具體如下:
文本上傳控件前面有一個輸入框。受 Michael McGrady 的啟發,我們創建一個「上傳圖片」按鈕,然後把文件上傳控件的 opacity 屬性設為 0,並透過定位使其點擊區域精確地覆蓋在按鈕之上。這樣一來,用戶的每一次點擊看似點擊的是按鈕,實則觸發的是文件上傳控件本身。
要顯示圖片看似簡單,但各瀏覽器之間存在差異:IE6 無法正確顯示,IE7 可透過 AlphaImageLoader 濾鏡實現;Firefox 則有專屬的 getAsDataURL() 方法可以顯示;而 Opera、Safari 同樣無法正常顯示。因此我們使用瀏覽器嗅探技術分別處理,對無法顯示圖片的瀏覽器則讓其顯示文字提示。
只需在觸發文件上傳控件的 change 事件時,透過正則表達式驗證即可。一旦符合格式要求,就將圖片或提示文字顯示出來,否則顯示錯誤提示信息。
由於是透過 JS 來改變文件上傳控件的外觀,就必須保證用戶在禁用 JS 的情況下仍能正常上傳圖片。因此在 HTML 結構中,我們放置的應該是原生的、可用的文件上傳控件。
HTML 結構很簡單,只需將上傳控件放進一個 class 為 "fileWrap" 的 div 即可:
<div class="fileWrap">
<input type="file" name="photo" />
</div>
透過 JS 生成後,完整的結構如下:
<div class="fileWrap">
<div class="imgWrap">
<img src="/lib/img/defImage.gif"/>
</div>
<div class="fakefile">
<button type="button">瀏覽圖片</button>
<p class="mes"/>
<input type="file" class="file fakeCn" name="photo" id="file_0"/>
</div>
</div>
對照生成的代碼,我們來定義相關的 CSS 屬性。fileWrap 作為容器,需要加上 overflow:hidden 以確保文件上傳控件不會超出點擊區域(因為它是借助定位覆蓋在按鈕之上的),並給定合適的寬度:
div.fileWrap{
overflow:hidden;
width:110px;
}
div.imgWrap{
text-align:center;
}
div.fakefile{
padding-top:25px;
position:relative;
}
div.fakefile button{
left:10px;
position:absolute;
top:3px; /* 確保按鈕與圖片之間不會靠得太近 */
z-index:1;
}
div.fakefile .mes{
padding:0 3px;
text-align:left;
}
div.fakefile input{
left:-135px; /* 大約為輸入框的寬度 */
opacity:0;
filter:alpha(opacity=0);
-moz-opacity:0;
z-index:2; /* 確保控件位於按鈕上方 */
}
這裡需要特別注意 fakefile 的 padding-top——由於錯誤信息位於按鈕下方,而按鈕是絕對定位的,若不設 padding-top,錯誤信息會被按鈕覆蓋。同時,文件上傳控件透過設為透明並定義 left 值產生偏移,再借助 z-index 確保其點擊區域位於「上傳圖片」按鈕之上。
(function($){
/*
* @author denisdeng dexibe@gmail.com
* @version: 2009.8.11 1.0
* @param reg[String] 圖片格式
* @param defImg[String] 預設圖片
* @param btnText[String] 按鈕文字
* @param error[String] 錯誤信息
* @param imgText[String] 圖片無法正常顯示時的文字
*/
$.fn.liveFakeFile = function(o){
var settings = {
reg:"png|jpe?g|gif|bmp",
defImg:'img/defImage.gif',
btnText:'瀏覽圖片',
blankImg: "img/blank.gif",
error: '對不起,照片格式不正確,請重新選擇',
imgText:'你已經選擇文件'
};
var ie7 = $.browser.msie && ($.browser.version == "7.0");
var ie8 = $.browser.msie && ($.browser.version == "8.0");
var moz = $.browser.mozilla;
return this.each(function(i,v){
if(o) settings = $.extend(settings, o);
var wrap = $('<div class="fakefile"></div>');
var mes = $('<p class="mes"></p>');
var button = $('<button type="button"></button>');
var parent = $(this).parent('.fileinputs');
var imgWrap = $('<div class="imgWrap"></div>');
var defImg = $('<img src="'+settings.defImg+'" />');
imgWrap.append(defImg);
button.append(settings.btnText);
wrap.append(button);
wrap.append(mes);
imgWrap.insertBefore($(this));
$(this).attr("id",'file_'+i).appendTo(wrap);
parent.append(wrap);
$(this).bind('change',function(){
var val = $(this).val();
var imgName = val.slice(val.lastIndexOf("\"")+1);
if(val.match(new RegExp(".(" + settings.reg + ")$", "i"))){
mes.empty();
// 針對不能正常顯示圖片的瀏覽器
var img = $('<span></span>').append(settings.imgText).append(imgName);
// 針對 IE7 或 IE8
if(ie7 || ie8){
var img = $('<img src="'+ settings.blankImg+'" alt="" style="filter:progid:DXImageTransform.Microsoft.AlphaImageLoader(sizingMethod=\'scale\',src=\''+val+'\');" />');
}
// 針對火狐
if(moz){
var obj = document.getElementById('file_'+i);
var img = $('<img src="'+obj.files[0].getAsDataURL()+'" alt="" width="75" />');
}
imgWrap.empty().append(img);
}else{
imgWrap.empty().append(defImg);
mes.html(settings.error);
}
});
})
})(jQuery)
注意,上述代碼先定義了圖片無法正常顯示的情況,再针对不同瀏覽器分別處理。使用起來非常簡單——在頁面頭部引入 jQuery 庫和本插件,假如頁面中有一個 class 為 ".fake" 的控件,只需調用:
<script type="text/javascript">
$(function(){
$(".fake").liveFakeFile();
})
</script>
參數 reg、defImg、btnText、blankImg、error、imgText 主要用來方便自定義。例如你可以傳入自訂物件:
<script type="text/javascript">
$(function(){
var obj = {
reg: "bmp",
defImg:'img/yourImg.gif',
btnText:' browse ',
blankImg: "img/blank.gif",
error: 'Sorry, the format of image is wrong, please select again!',
imgText:'you have select the image:'
}
$(".fake").liveFakeFile(obj);
})
</script>
透過這個插件,原本枯燥的文件上傳控件煥然一新,既提升了用戶體驗,又兼顧了無 JS 環境下的可用性,是美化表單上傳功能的理想選擇。