《fullAvatarEditor富頭像上傳編輯器文檔》要點:
本文介紹了fullAvatarEditor富頭像上傳編輯器文檔,希望對您有用。如果有疑問,可以聯系我們。
相關主題:文件圖片上傳插件
這個富頭像上傳編輯器文檔是網上找的,有點亂,放著備用。官網關閉了,將就著用吧。
new fullAvatarEditor(swfContainerID, [height], [width], flashvars, [callback]);
返回值:object,該對象可調用call方法,請參見 call方法。
用以包裹Flash的HTML元素的ID。
Flash的高度,默認為 600。
Flash的寬度,默認為 630。
名稱 | 類型 | 默認值 | 描述 |
---|---|---|---|
id | String | fullAvatarEditor | 接收消息的swf的ID,用以區分同一頁面如果存在多個組件。 |
upload_url | String | null | 上傳圖片的接口。該接口需返回一個json字符串,且會原樣輸出到callback 回調函數 的參數對象的屬性content中,請參見 上傳接口的返回數據。 |
quality | Number | 100 | 生成的頭像圖片的質量,取值范圍1-100,數值越大生成的圖片越清晰,相對地文件也會越大。 |
isShowUploadResultIconv2.0 | Boolean | true | 在上傳完成時(無論成功和失敗),是否顯示表示上傳結果的圖標。 |
執行該函數時,函數中的this關鍵字指向表示swf的HTMLObjectElement,并且會給函數傳遞一個表示事件消息的json對象作為參數。
json對象的屬性如下:
code : Number主要用來辨識消息的具體來源和內容,以便客戶端知道如何處理。
type : Number0 表示成功,1 表示警告,2 表示錯誤,3 表示異常。
content : *表示消息的內容。可能的值:
code | type | content | 描述 |
---|---|---|---|
1 | 0 | 頁面成功加載組件后觸發的事件消息。 | |
2 |
|
| |
3 |
|
| |
4 | 2 | 選擇的原圖片文件大小,帶單位。如:8.88MB | 選擇的原圖片文件大小超出了指定的值。 |
5 |
|
|
|
object.call(methodName[, methodParameter]);
methodName:String | 要調用的flash內的方法名稱。 |
methodParameter:String | 傳遞到該方法的參數。 |
該方法供 new fullAvatarEditor 返回的對象(HTMLObjectElement)調用,主要是調用flash里的方法。
可調用的方法枚舉表 | ||
methodName | methodParameter | 功能描述 |
---|---|---|
changePanel | upload 或 webcam | 切換到本地上傳圖片選擇面板或攝像頭拍照面板。 |
loadPic | 要加載的圖片的url。 | 加載網絡圖片。 |
pressShutter | 執行拍照操作。 | |
srcUpload | true|false | 設置是否上傳原圖片。 |
upload | 執行上傳保存的操作。 |
發送方式: | post | ||
原圖file域: | Field Name: | __source | |
File Name: | 如果是本地和網絡圖片為原始文件名(不含擴展名)、如果是攝像頭拍照則為 *FromWebcam | ||
頭像file域: | Field Name: | __avatar1,__avatar2,__avatar3,... 即 __avatar + 1至頭像總數。 | |
File Name: | 同上。 | ||
其他文本域: | Field Name: | __initParams(String) | 加載指定url的原圖時將該參數追加到url中,可保證視圖跟保存頭像時一致。可用于修改頭像,幫助提升用戶體驗。注意:上傳原圖時才會發送該數據。 |
接口至少必須返回一個包含名為“success”、值為true(表示上傳成功)或false(表示上傳失敗)的json字符串,且會原樣輸出到 callback 回調函數 的參數對象的屬性content中。
例:當上傳成功或失敗時可分別返回以下json對象。
{
"success" : true,//該名/值對是必須定義的,表示上傳成功
"sourceUrl" : "原圖片位于服務器的虛擬路徑",
"avatarUrls": ["頭像圖片位于服務器的虛擬路徑",..]
}
或
{
"success" : false,//該名/值對是必須定義的,表示上傳失敗
"msg" : "上傳的原圖文件大小超出限值了!"
}
在進行調用時即可如下使用獲取返回的數據
var swf = new fullAvatarEditor('swf', {
id: 'swf',
upload_url: '/upload.php'
}, function(json){
if (json.code == 5)
{
switch(json.type)
{
//表示圖片上傳成功。
case 0:
alert('原圖片位于服務器的虛擬路徑為'+json.content.sourceUrl);
alert('頭像圖片位于服務器的虛擬路徑為'+json.content.avatarUrls.join(','));
break;
case 1:
alert('頭像上傳失敗,原因:' + json.content.msg);//will output:頭像上傳失敗,原因:上傳的原圖文件大小超出限值了!
break;
case 2:
alert('頭像上傳失敗,原因:指定的上傳地址不存在或有問題!');
break;
case 3:
alert('頭像上傳失敗,原因:發生了安全性錯誤!請聯系站長添加crossdomain.xml到網站根目錄。');
break;
}
}
});
轉載請注明本頁網址:
http://www.snjht.com/jiaocheng/109.html