示範頁面:https://www.never-online.net/tutorial/js/upload/
前面幾章該交代的觀念大致都講完了,這一篇終於要開始寫真正的程式。第一個實例,我們來做一個批次上傳的 UI 控制項。之後的範例大多會以 UI 元件為主,共同的原則是:封裝成 Object,或者用 Function 包裝成「Class」。
對只讀過前幾章的朋友來說,這個例子可能有點深,但不用擔心,一步一步拆解其實很快就能懂。重點是理解「怎麼做」,而不是死記「怎麼寫」。
首先定義一個 upload「類別」。
對外應該開放的成員:
1、建構式中要傳入必要參數,例如要把 upload 建在哪個容器裡。
2、必須有 add() 方法,用來新增一組上傳欄位。
3、必須有 remove() 方法,用來刪除一組上傳欄位。
物件自身需要維護的內部狀態:
1、目前一共有幾組 upload 資訊(計數器)。
2、一個容器物件參照,同樣由建構式傳入。
從預覽圖看,我們至少要動態產生三個以上的元素(新增、刪除、file 欄位,可能還有更多)。既然是動態新增,就會用到 document.createElement;要放進容器則是 appendChild() 或 insertBefore();要移除就是 obj.parentNode.removeChild(obj)。這些上一章都提過。
其次,既然是控制項,就得用 function 或 object 封裝起來,這部分第一章已經簡單說明過。
<script>
function upload(target /* 容器 */) {
this._cnt = 0; /* 計數器 */
this.target = document.getElementById(target);
};
upload.prototype.add = function () {
/* 產生 file、產生新增、產生刪除、計數器 +1 */
};
upload.prototype.remove = function () {
/* 刪除 file、刪除新增、刪除刪除 */
};
</script>
<script>
upload.prototype.add = function () {
var self = this;
var cnt = this._cnt;
/* 產生 file 欄位 */
var cFile = document.createElement("input");
cFile.type = "file";
cFile.name = "upload";
cFile.id = "upload_file_" + cnt;
/* 產生「新增」 */
var cAdd = document.createElement("span");
cAdd.innerHTML = "新增";
cAdd.id = "upload_add_" + cnt;
cAdd.onclick = function () {
self.add();
};
/* 產生「刪除」 */
var cRemove = document.createElement("span");
cRemove.innerHTML = "刪除";
cRemove.id = "upload_remove_" + cnt;
cRemove.onclick = function () {
self.remove(cnt);
};
/* 全部掛到容器上 */
this.target.appendChild(cFile);
this.target.appendChild(cAdd);
this.target.appendChild(cRemove);
this._cnt++;
return this;
};
</script>
最直白的寫法是三段幾乎一模一樣的程式:
<script>
upload.prototype.remove = function (n) {
var a = document.getElementById("upload_file_" + n);
a.parentNode.removeChild(a);
var a = document.getElementById("upload_add_" + n);
a.parentNode.removeChild(a);
var a = document.getElementById("upload_remove_" + n);
a.parentNode.removeChild(a);
return this;
};
</script>
重複太多,也不好維護。與其貼三遍,不如把共同邏輯抽成一個內部方法:
<script>
upload.prototype._removeNode = function (id) {
var a = document.getElementById(id);
a.parentNode.removeChild(a);
};
upload.prototype.remove = function (n) {
this._removeNode("upload_file_" + n);
this._removeNode("upload_add_" + n);
this._removeNode("upload_remove_" + n);
return this;
};
</script>
<html>
<head>
<script>
/* 這裡放上面寫好的控制項程式碼 */
</script>
</head>
<body>
<div id="uploadContainer"></div>
<script>
var o = new upload("uploadContainer");
o.add();
</script>
</body>
</html>
效果出來了,但不太理想——所有元素全黏在一起。要美化,可以選擇加 <br> 換行,也可以每組再包一層 div。這裡我們選後者,因為以後要再加東西會方便得多:
<script>
upload.prototype.add = function () {
var self = this;
var cnt = this._cnt;
/* 外層容器,方便排版與日後擴充 */
var cWrap = document.createElement("div");
cWrap.id = "upload_wrap_" + cnt;
var cFile = document.createElement("input");
cFile.type = "file";
cFile.name = "upload";
cFile.id = "upload_file_" + cnt;
var cAdd = document.createElement("span");
cAdd.innerHTML = "新增";
cAdd.id = "upload_add_" + cnt;
cAdd.onclick = function () { self.add(); };
var cRemove = document.createElement("span");
cRemove.innerHTML = "刪除";
cRemove.id = "upload_remove_" + cnt;
cRemove.onclick = function () { self.remove(cnt); };
cWrap.appendChild(cFile);
cWrap.appendChild(cAdd);
cWrap.appendChild(cRemove);
this.target.appendChild(cWrap);
this._cnt++;
return this;
};
</script>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<title>batch upload control</title>
<style type="text/css" media="all" title="Default">
* { font-family: Arial; }
body { font-size: 10pt; }
#footer { font-size: 9pt; margin: 20px; }
span { margin: 3px; text-decoration: underline; cursor: default; }
</style>
<script type="text/javascript">
//<![CDATA[
function upload(target) {
this._cnt = 0;
this.target = document.getElementById(target);
};
upload.prototype.add = function () {
var self = this;
var cnt = this._cnt;
var cWrap = document.createElement("div");
cWrap.id = "upload_wrap_" + cnt;
var cFile = document.createElement("input");
cFile.type = "file";
cFile.name = "upload";
cFile.id = "upload_file_" + cnt;
var cAdd = document.createElement("span");
cAdd.innerHTML = "新增";
cAdd.onclick = function () { self.add(); };
var cRemove = document.createElement("span");
cRemove.innerHTML = "刪除";
cRemove.onclick = function () { self.remove(cnt); };
cAdd.id = "upload_add_" + cnt;
cRemove.id = "upload_remove_" + cnt;
cWrap.appendChild(cFile);
cWrap.appendChild(cAdd);
cWrap.appendChild(cRemove);
this.target.appendChild(cWrap);
this._cnt++;
return this;
};
upload.prototype._removeNode = function (id) {
var a = document.getElementById(id);
a.parentNode.removeChild(a);
};
upload.prototype.remove = function (n) {
this._removeNode("upload_file_" + n);
this._removeNode("upload_add_" + n);
this._removeNode("upload_remove_" + n);
return this;
};
onload = function () {
var o = new upload("container");
o.add();
};
//]]>
</script>
</head>
<body>
<h1>batch upload control with javascript</h1>
<div id="container"></div>
<div id="footer">tutorial of DHTML and javascript programming</div>
</body>
</html>
這個例子示範的不只是上傳控制項,更是一整套封裝思路:用建構式接收外部容器、用 prototype 掛方法、用計數器管理動態產生的元素、把重複邏輯抽成內部方法。把這套模式吃透,之後做任何 UI 元件都能套用。