## addFile('name值', '標題' [, '提示', '默認值', '限制大小', '文件后綴', '額外css類']) | 版本 | 新增功能 | | --- | --- | | 1.0.5 | 自定義js回調函數 | 標識符：`file` | 參數 | 含義 | 類型 | | --- | --- | --- | | name | name值 | string | | title | 標題 | string | | tips | 提示 | string | | default | 默認值 | string | | size | 限制大小（單位kb） | string | | ext | 文件后綴（如：'rar,doc,zip'） | string | | extra_class | 額外css類 | string | ### 簡單例子 ~~~ return ZBuilder::make('form') ->addFile('file', '文件') ->fetch(); ~~~ 效果：  ### 默認值 默認值是附件id，不要填寫文件地址 ### 限制大小 默認可以不同填寫大小限制，可以在后臺，“系統” -> “系統設置” -> “上傳”設置。 如果在某些情況下，需要重新定義，可以填寫此參數，大小為kb，比如限制上傳大小為1mb。 ~~~ return ZBuilder::make('form') ->addFile('file', '文件', '', '', '1024') ->fetch(); ~~~ ### 文件后綴 跟限制大小一樣，可以在后臺“系統” -> “系統設置” -> “上傳”設置。 也可以重新定義 ~~~ return ZBuilder::make('form') ->addFile('file', '文件', '', '', '1024', 'zip,7z') ->fetch(); ~~~ ### 自定義js回調 從1.0.5版本開始，可通過自定義js回調函數來處理上傳成功之后，或者上傳失敗之后需要做的事情，比如： ~~~ return ZBuilder::make('form') ->addFile('file', '文件') ->js('test') // 引入自定義的外部js文件 ->fetch(); ~~~ 然后在**test.js**中定義 ~~~ var dp_file_upload_success = function () { console.log(1111) }; ~~~ 那么在文件上傳成功后，會執行`dp_file_upload_success`函數，在控制臺輸出`1111`.當然了，你也可以利用jQuery給表單添加個按鈕，或者顯示隱藏某些元素，這個按自己實際需求做就可以了。 >[info] `dp_file_upload_success`函數是針對表單中的所有文件上傳組件，包括單文件上傳，多文件上傳，也就是說，不管你的表單中添加了多少個文件上傳組件，每次上傳成功，都會去執行`dp_file_upload_success`函數。 如果只想某個文件上傳組件上傳成功時才觸發`dp_file_upload_success`函數，可以這么做。 ~~~ return ZBuilder::make('form') ->addFile('file1', '文件1') ->addFile('file2', '文件2') ->js('test') // 引入自定義的外部js文件 ->fetch(); ~~~ **test.js**代碼如下： ~~~ var dp_file_upload_success_file2 = function () { console.log(1111) }; ~~~ 這樣的話，只有當file2這個組件上傳文件成功后才會觸發`dp_file_upload_success_file2`函數。而當file1組件上傳文件成功后，是不會觸發`dp_file_upload_success_file2`函數的。 除了`dp_file_upload_success`函數外，還支持以下回調函數。 | 全局函數 | 含義 | | --- | --- | | dp_file_upload_success | 文件上傳成功后執行，針對所有文件上傳組件 | | dp_file_upload_success_表單項名 | 僅對某個文件上傳組件上傳成功后起作用 | | dp_file_upload_error | 文件上傳失敗后執行，針對所有文件上傳組件 | | dp_file_upload_error_表單項名 | 僅對某個文件上傳組件上傳失敗后起作用 | | dp_file_upload_complete | 文件上傳完成后執行，針對所有文件上傳組件 | | dp_file_upload_complete_表單項名 | 僅對某個文件上傳組件上傳完成后起作用 |