Dreamweaver 及更新版本已移除對 ColdFusion 的支援。
關於 ColdFusion 表單
ColdFusion 表單為您提供數種內建機制來驗證表單資料。 例如,您可以檢查以確保使用者輸入有效的日期。某些表單控制項具有額外功能。 有數種沒有 HTML 對應項目,而其他則直接支援從資料來源動態填入控制項。
Dreamweaver 為使用 ColdFusion MX 7 或更新版本作為 開發伺服器的 ColdFusion 開發人員提供許多增強功能。這些增強功能包括更多「插入」面板 按鈕、選單項目和「屬性」檢視窗,讓您能夠快速 建置和設定 ColdFusion 表單的屬性。您也可以產生 驗證網站訪客所提供資訊的代碼。例如,您可以檢查使用者提供的電子郵件地址是否包含 @ 符號,或必填文字欄位是否包含特定類型的值。
啟用 ColdFusion 增強功能
其中 一些增強功能需要您將執行 ColdFusion MX 7 或更新版本的電腦定義為 Dreamweaver 的測試伺服器。 例如,表單控制項的屬性檢視器只有在您指定正確的測試伺服器時才可使用。
您只需要定義 測試伺服器一次。Dreamweaver 接著會 自動偵測測試伺服器版本,並在偵測到 ColdFusion 時提供增強功能。
在開啟 ColdFusion 文件之前,Dreamweaver 工作區不會有任何可見變更。
建立 ColdFusion 表單
您可以使用多個「插入」面板按鈕、 選單項目和屬性檢測器,在 Dreamweaver 中快速建立 ColdFusion 表單並設定其屬性。
這些增強功能 僅在您可存取執行 ColdFusion MX 7 或更新版本的電腦時才可使用。
Dreamweaver 會插入空的 ColdFusion 表單。在「設計」檢視中,表單會以點狀的紅色外框來表示。 如果您看不到此外框,請確定已選取「檢視」> 「視覺效果輔助」>「隱藏元素」。
CFForm
設定表單名稱。
動作
讓您指定提交表單時要處理的 ColdFusion 頁面名稱。
方法
讓您定義瀏覽器用來傳送 表單資料到伺服器的方法:
POST
使用 HTTP post 方法傳送資料; 此方法會在單獨的訊息中將資料傳送到伺服器。
GET
使用 HTTP get 方法傳送資料, 將表單欄位內容置於 URL 查詢字串中。
目標
讓您修改 cfform 標記的 target 屬性值。
編碼方式類型
指定用來傳輸表單資料的編碼方法。
編碼方式類型與字元編碼沒有關聯。 這個屬性會指定用來將表單送到伺服器的內容類型 (當方法的值為 post 時)。 這個屬性的預設值為 application/x-www-form-urlencoded。
格式
決定所要建立的表單種類:
HTML
會產生 HTML 表單並將其傳送到用戶端。 cfgrid 和 cftree 子控制項可以是 Flash 或 applet 格式。
Flash
會產生 Flash 表單並將其傳送到用戶端。 所有控制項 都是 Flash 格式。
XML
生成 XForms XML 並將結果放入具有 ColdFusion 表單名稱的變數中。並不會傳送任何資料給用戶端。 Cfgrid 和 Cftree 子控制項都可以採用 Flash 或 Applet 格式。
樣式
讓您指定表單的樣式。 如需更多資訊, 請參閱 ColdFusion 文件。
Flash/XML 外觀
可讓您指定 Halo 色彩以設定輸出的樣式。 主題決定用於醒目顯示和選取元素的色彩。
保存資料
決定當表單發佈到自身時,是否以提交的值 覆蓋初始控制項值。
如果為 False,則使用控制項標記屬性中 指定的值。
如果為 True,則使用送出的值。
Script src
指定相對於網頁根目錄的 JavaScript 檔案 URL,該檔案包含標記及其下層標記使用的用戶端代碼。如果檔案不在預設 位置,此屬性會很有用。在某些封鎖存取 /CFIDE 目錄的託管環境 和組態中,可能需要此屬性。預設 位置是在 ColdFusion Administrator 中設定;預設情況下,它 是 /CFIDE/scripts/cfform.js。
封存
指定 cfgrid、 cfslider 和 cftree applet 控制項的可下載 Java 類別 URL。預設的位置為 /CFIDE/classes/cfapplets.jar。
高度
指定表單的高度。
寬度
指定表單的寬度。
顯示 cfform 的標記編輯器
讓您編輯沒有列在「屬性」檢視窗上的屬性。
將插入點置於您希望 ColdFusion 表單控制項出現在 ColdFusion 表單中的位置,然後從「插入」選單選取控制項(「插入」>「ColdFusion Objects」>「CFForm」),或從「插入」面板中的「CFForm」類別選取。
確保在「設計」檢視中選取控制項,然後 在「屬性」檢視窗中設定屬性。如需屬性的更多資訊,請按一下「屬性」檢視窗中的「說明」圖示。
如果您要建立以 HTML 為基礎的表單,您可以使用換行符號、段落符號、預先格式化文字或表格來格式化表單。您無法在另一個 ColdFusion 表單中插入 ColdFusion 表單(也就是說,您無法重疊標記),但您可以在頁面中包含多個 ColdFusion 表單。
如果您要建立 Flash 式 表單,請使用階層式樣式表 (CSS) 樣式 來配置您的表單。ColdFusion 會忽略表單中的所有 HTML。
請記得 為 ColdFusion 表單欄位加上描述性文字標籤,讓 使用者知道他們要回應什麼內容。例如,建立「輸入您的姓名」標籤來請求姓名資訊。
插入 ColdFusion 表單控制項
使用 「插入」面板或「插入」選單,快速插入 ColdFusion 表單 控制項到 ColdFusion 表單中。您需要先建立空白的 ColdFusion 表單,才能在其中插入控制項。
只有在您可以存取執行 ColdFusion MX 7 或更新版本的電腦時,才能使用這些增強功能。
如需特定控制項屬性的相關資訊, 請參閱控制項的相關主題。
插入 ColdFusion 文字欄位
您 可以視覺化方式將 ColdFusion 文字欄位或密碼欄位插入 您的表單中,然後設定其選項。
只有在您可以存取執行 ColdFusion MX 7 或更新版本的電腦時,才能使用此增強功能。
以視覺化方式插入 ColdFusion 文字 欄位
文字欄位便會出現在表單中。
以視覺化的方式插入密碼欄位
CFTextField 選項 (ColdFusion)
若要設定 ColdFusion 文字或 密碼欄位的選項,請在 CFTextField 「屬性」檢視窗中設定下列任何選項:
CFtextfield
設定 <cfinput> 標籤的 id 屬性。
值
讓您指定當頁面 第一次在瀏覽器中開啟時,要在欄位中顯示的文字。此資訊可以是靜態 或動態的。
若要指定動態值,請按一下「值」方塊旁的閃電圖示,並在「動態資料」對話框中選取記錄集欄。當您在瀏覽器中檢視表單時,資料錄集欄會提供值 給文字欄位。
文字模式
讓您可以在標準文字輸入欄位和 密碼輸入欄位之間切換。此控制項修改的屬性 是 type。
唯讀
讓您將顯示的文字設定成唯讀狀態。
最大長度
設定文字欄位接受的字元數目上限。
遮罩
讓您為要求的文字指定遮罩。 您可以使用這項屬性來驗證使用者輸入的資料。 遮罩格式是由 A、9、X 和 ? 等字元所組成。
如果 cfinput 類型為「密碼」標籤時,遮罩屬性會被忽略。
驗證
指定目前欄位的驗證類型。
驗證於
指定欄位驗證的時機:onSubmit、onBlur 或 onServer。
標籤
讓您指定文字欄位的標籤。
模式
讓您指定 JavaScript 規則運算式圖樣 來驗證輸入。請省略字串前後的斜線。 如需詳細資訊, 請參閱 ColdFusion 文件。
高度
讓您指定控制項的高度 (以像素為單位)。
寬度
讓您指定控制項的寬度 (以像素為單位)。
大小
讓您指定控制項的大小。
必要項
讓您指定文字欄位是否必須包含資料, 才能將表格提交到伺服器。
顯示標籤編輯器
讓您編輯沒有列在「屬性」檢視窗上的屬性。
插入 ColdFusion 隱藏欄位
您 可以將 ColdFusion 隱藏欄位以視覺化方式插入表格中, 並設定其屬性。使用隱藏欄位來儲存和提交 使用者不輸入的資訊。此資訊對使用者隱藏。
此增強功能僅在您可以存取 執行 ColdFusion MX 7 或更新版本的電腦時才可使用。
ColdFusion 表單中會出現一個標記。 如果您沒有看到 標記,請選取「檢視 > 視覺輔助 > 隱形元素」。
Cfhiddenfield
讓您指定隱藏欄位唯一的名稱。
值
讓您指定隱藏欄位的值。 資料可以是靜態或動態。
若要指定動態值,請 按一下「值」方框旁的閃電圖示,然後在「動態資料」對話框中選取 記錄集欄。當您在瀏覽器中檢視表單時,記錄集欄位會提供一個值給文字欄位。
驗證
指定目前欄位的驗證類型。
驗證於
指定欄位在何時進行驗證:onSubmit、onBlur 或 onServer。
標籤
讓您指定控制項的標籤。 ColdFusion 伺服器在執行時間 會忽略此屬性。
模式
讓您指定 JavaScript 規則運算式圖樣 來驗證輸入。請省略字串前後的斜線。 如需詳細資訊,請 參閱 ColdFusion 文件。
高度
讓您指定控制項的高度 (以像素為單位)。 在執行階段,ColdFusion 伺服器會忽略這個屬性。
寬度
讓您指定控制項的寬度 (以像素為單位)。 在執行階段,ColdFusion 伺服器會忽略這個屬性。
大小
讓您指定控制項的大小。 ColdFusion 伺服器在執行時間 會忽略此屬性。
必要項
讓您指定在表單提交到伺服器之前,隱藏欄位是否必須包含 資料。
顯示標籤編輯器
讓您編輯沒有列在「屬性」檢視窗上的屬性。
插入 ColdFusion 文字區域
您 可以視覺化地插入 ColdFusion 文字區域到表單中,並設定 其屬性。文字區域是由 多行文字組成的輸入元素。
此增強功能僅在 您能存取執行 ColdFusion MX 7 或更新版本的電腦時才可使用。
文字區域便會出現在 ColdFusion 表單中。
Cftextarea
讓您為這個控制項指定唯一的名稱。
字元寬度
讓您設定每一行的字元數。
行數
讓您設定要在文字 區域中顯示的列數。
換行
讓您指定使用者輸入的文字 換行方式。
必要項
讓您指定使用者是否必須在 欄位中輸入資料 (勾選) 或不需要 (未勾選)。
初始值
讓您指定當 頁面最初在瀏覽器中開啟時,要在文字區域中顯示的文字。
驗證
指定欄位的驗證類型。
驗證於
指定欄位何時進行驗證:onSubmit、onBlur 或 onServer。
標籤
讓您指定控制項的標籤。
樣式
讓您指定控制項的樣式。 如需更多資訊, 請參閱 ColdFusion 說明文件。
高度
讓您指定控制項的高度 (以像素為單位)。 在執行階段,ColdFusion 伺服器會忽略這個屬性。
寬度
讓您指定控制項的寬度 (以像素為單位)。 在執行階段,ColdFusion 伺服器會忽略這個屬性。
顯示標籤編輯器
讓您編輯沒有列在「屬性」檢視窗上的屬性。
插入 ColdFusion 按鈕
您 可以將 ColdFusion 按鈕以視覺方式插入表單中並設定其 屬性。ColdFusion 按鈕會控制 ColdFusion 表單的作業。 按鈕可用來將 ColdFusion 表單資料提交到伺服器 或重設 ColdFusion 表單。標準 ColdFusion 按鈕 通常標示為「提交」、「重設」或「傳送」。您也可以指定在指令碼中定義的其他 處理工作。例如, 按鈕可能會根據 指定值計算所選項目的總成本。
此增強功能僅在 您能存取執行 ColdFusion MX 7 或更新版本的電腦時才可使用。
按鈕便會出現在 ColdFusion 表單中。
Cfbutton
讓您為這個控制項指定唯一的名稱。
動作
讓您指定要建立的按鈕類型。
顯示標籤編輯器
讓您編輯沒有列在「屬性」檢視窗上的屬性。
其他屬性在執行階段會被 ColdFusion 伺服器忽略。
插入 ColdFusion 核取方塊
您 可以將 ColdFusion 核取方塊以視覺方式插入表單中並設定 其屬性。使用核取方塊讓使用者從一組選項中選取多個 選項。
此增強功能僅在您擁有執行 ColdFusion MX 7 或更新版本之電腦的存取權時才可使用。
核取方塊便會出現在 ColdFusion 表單中。
Cfcheckbox
讓您為這個控制項指定唯一的名稱。
核取的值
讓您指定使用者核取時核取方塊要傳回的 值。
初始化狀態
讓您指定頁面第一次在瀏覽器中開啟時核取方塊是否為已核取狀態。
驗證
指定核取方塊的驗證類型。
驗證於
指定核取方塊何時進行驗證:onSubmit、 onBlur 或 onServer。
標籤
讓您指定核取方塊的標籤。
模式
讓您指定用於驗證輸入的 JavaScript 規則運算式圖樣。請省略字串前後的斜線。 如需詳細資訊, 請參閱 ColdFusion 文件。
高度
讓您指定控制項的高度 (以像素為單位)。 在執行階段,ColdFusion 伺服器會忽略這個屬性。
寬度
讓您指定控制項的寬度 (以像素為單位)。 在執行階段,ColdFusion 伺服器會忽略這個屬性。
大小
讓您指定控制項的大小。 執行時期 ColdFusion 伺服器會忽略此屬性。
必要項
讓您指定表單提交至伺服器前是否必須先核取核取方塊。
顯示標籤編輯器
讓您編輯沒有列在「屬性」檢視窗上的屬性。
插入 ColdFusion 選項按鈕
您 可以在表單中以視覺化方式插入 ColdFusion 選項按鈕並 設定其屬性。當您希望使用者從一組選項中只選取一個選項時,請使用選項按鈕。選項按鈕通常 以群組形式使用。群組中的所有選項按鈕必須具有相同的 名稱。
此增強功能僅在您有權存取執行 ColdFusion MX 7 或更新版本的電腦時才可用。
選項按鈕便會出現在 ColdFusion 表單中。
Cfradiobutton
讓您為這個控制項指定唯一的名稱。
核取的值
讓您指定選項按鈕在使用者核取時要傳回的值。
初始化狀態
讓您指定頁面第一次在瀏覽器中開啟時選項按鈕是否為已核取狀態。
驗證
指定選項按鈕的驗證類型。
驗證於
指定選項按鈕何時進行驗證:onSubmit、 onBlur 或 onServer。
標籤
讓您指定選項按鈕的標籤。
模式
讓您指定用於驗證輸入的 JavaScript 規則運算式圖樣。請省略字串前後的斜線。 如需詳細資訊, 請參閱 ColdFusion 文件。
高度
讓您指定控制項的高度 (以像素為單位)。 在執行階段,ColdFusion 伺服器會忽略這個屬性。
寬度
讓您指定控制項的寬度 (以像素為單位)。 在執行階段,ColdFusion 伺服器會忽略這個屬性。
大小
讓您指定控制項的大小。 執行時期 ColdFusion 伺服器會忽略此屬性。
必要項
讓您指定表單提交至伺服器前是否必須先核取選項按鈕。
顯示標籤編輯器
讓您編輯沒有列在「屬性」檢視窗上的屬性。
插入 ColdFusion 選取方塊
您 可以在表單中以視覺化方式插入 ColdFusion 選取方塊並設定 其屬性。選取方塊可讓訪客從清單中選取一個或多個項目。選取方塊在空間有限但需要顯示許多項目時很有用。當您想要控制傳回伺服器的值時,這些方塊也很有用。與使用者可以輸入任何內容 (包括無效資料) 的文字欄位不同,使用選取方塊,您可以設定選單傳回的確切值。
您可以將兩種類型的選取方塊插入表單:使用者按一下時會「下拉」的選單,或顯示可捲動項目清單供使用者選取的選單。
此增強功能只有在您能夠存取執行 ColdFusion MX 7 或更新版本的電腦時才可使用。
選取方塊便會出現在 ColdFusion 表單中。
Cfselect
讓您為這個控制項指定唯一的名稱。
類型
讓您選擇彈出式選單或清單。 如果您選取清單類型,「清單高度」和「允許多重清單選取」選項會變為可用。
清單高度
可讓您指定清單選單中要顯示的行數。只有在選取清單類型時,才能使用這個屬性。
允許多個清單選取範圍
可讓您指定使用者是否可以同時從清單中選取多個選項。只有在您選取清單類型時才可使用。
編輯值
會開啟對話框,讓您從選取方塊新增、編輯或移除選項。
起始時已選取
讓您指定哪些選項已經預設選取。 如果您選取了「允許多重清單選取」選項,就可以選取多個選項。
資料集
讓您指定要用來填入清單或選單的 ColdFusion 查詢名稱。
顯示欄
可讓您指定記錄集欄位,以提供每個清單元素的顯示標籤。配合「資料集」屬性使用。
值欄
可讓您指定記錄集欄位,以提供每個清單元素的值。配合「資料集」屬性使用。
Flash 標籤
讓您指定選取方塊的標籤。
Flash 高度
讓您指定控制項的高度 (以像素為單位)。 在執行階段,ColdFusion 伺服器會忽略這個屬性。
Flash 寬度
讓您指定控制項的寬度 (以像素為單位)。 在執行階段,ColdFusion 伺服器會忽略這個屬性。
訊息
指定在「必要」屬性設為「是」而使用者在提交表單前未進行選取時要顯示的訊息。
必要項
可讓您指定在表單提交至伺服器前是否必須選取選單項目。
顯示標籤編輯器
讓您編輯沒有列在「屬性」檢視窗上的屬性。
插入 ColdFusion 影像欄位
您可以視覺化地將 ColdFusion 影像欄位插入表單並設定其選項。使用影像欄位製作自訂按鈕。
此增強功能只有在您能夠存取執行 ColdFusion MX 7 或更新版本的電腦時才可使用。
如果影像位於網站根資料夾之外,您應該將影像複製到根資料夾。根資料夾外的影像在您發佈網站時可能無法存取。
Cfimagefield
讓您為這個控制項指定唯一的名稱。
原始檔
讓您指定要插入之影像的 URL。
替代
讓您可以指定要在影像無法顯示時顯示的訊息。
對齊
讓您指定圖片的對齊方式。
邊框
讓您設定影像邊框的寬度。
編輯影像
讓您以預設的影像編輯器開啟影像。
若要 定義預設影像編輯器,請選取「編輯」>「偏好設定」> 「檔案類型/編輯器」。否則,「編輯影像」按鈕不會 執行任何動作。
驗證
指定影像欄位的驗證類型。
驗證於
指定驗證欄位的時機:onSubmit、onBlur 或 onServer。
標籤
讓您指定選項按鈕的標籤。
模式
讓您指定 JavaScript 規則運算式圖樣來驗證輸入。請省略字串前後的斜線。 如需詳細資訊, 請參閱 ColdFusion 文件。
高度
讓您指定控制項的高度 (以像素為單位)。
寬度
讓您指定控制項的寬度 (以像素為單位)。
大小
讓您指定控制項的大小。 ColdFusion 伺服器在執行階段會忽略此 屬性。
必要項
讓您指定控制項是否必須包含資料 才能將表單提交到伺服器。
顯示標籤編輯器
讓您編輯沒有列在「屬性」檢視窗上的屬性。
插入 ColdFusion 檔案欄位
您可以視覺化方式將 ColdFusion 檔案 欄位插入表單中並設定其屬性。使用檔案欄位讓 使用者從電腦中選取檔案 (例如文書處理 文件或圖形檔案),並將其上傳到伺服器。ColdFusion 檔案欄位看起來像其他文字欄位,但它還有一個「瀏覽」按鈕。使用者可以手動輸入要 上傳的檔案路徑,或使用「瀏覽」按鈕來定位並選取檔案。
檔案 欄位需要您使用 POST 方法將 檔案從瀏覽器傳輸到伺服器。檔案會發佈 到您在表單「動作」方塊中指定的地址。請聯繫 您的伺服器管理員,在表單中使用檔案欄位之前, 先確認是否允許匿名檔案上傳。
檔案欄位 還需要將表單編碼設定為 multipart/form。當您插入檔案欄位控制項時,Dreamweaver 會自動進行此設定。
只有當您可以存取執行 ColdFusion MX 7 或更新版本的電腦時, 才能使用此增強功能。
若要快速選取表單,請按一下表單 外框中的任意位置,然後按一下「文件」視窗底部 標記選擇器中的 <cfform> 標記。
檔案欄位便會出現在文件中。
Cffilefield
讓您為這個控制項指定唯一的名稱。
最大長度
讓您指定檔案路徑可擁有的字元數上限。
驗證
指定欄位的驗證類型。
驗證於
指定欄位驗證時機:onSubmit、onBlur 或 onServer。
標籤
讓您指定欄位的標籤。
模式
讓您指定 JavaScript 規則運算式圖樣來驗證輸入。請省略字串前後的斜線。 如需詳細資訊,請參閱 ColdFusion 說明文件。
高度
讓您指定控制項的高度 (以像素為單位)。 在執行階段,ColdFusion 伺服器會忽略這個屬性。
寬度
讓您指定控制項的寬度 (以像素為單位)。 在執行階段,ColdFusion 伺服器會忽略這個屬性。
大小
讓您指定控制項的大小。
必要項
讓您指定檔案欄位在表單提交至伺服器前是否必須包含資料。
顯示標籤編輯器
讓您編輯沒有列在「屬性」檢視窗上的屬性。
插入 ColdFusion 日期欄位
雖然您無法在 Dreamweaver 中以視覺方式插入 ColdFusion 日期欄位,但可以視覺方式設定其屬性。ColdFusion 日期欄位是特殊類型的文字欄位,可讓使用者從彈出式行事曆選取日期以插入文字欄位中。
此增強功能只有在您能存取執行 ColdFusion MX 7 或更新版本的電腦時才可使用。
若要快速選取表單,請在表單外框內按一下任意位置,然後按一下「文件」視窗底部標記選擇器中的 <cfform> 標記。
日期欄位控制項只能在 Flash 型 ColdFusion 表單中轉譯。
<cfinput name="datefield" type="datefield">
Cfdatefield
讓您為這個控制項指定唯一的名稱。
值
讓您指定當頁面首次在瀏覽器中開啟時, 要在欄位中顯示的日期。日期可為靜態 或動態。
若要指定動態值,請按一下「值」方塊旁邊的閃電圖示,並在「動態資料」對話框中選取記錄集欄位。當您在瀏覽器中檢視表單時,記錄集欄位會提供值給日期欄位。
驗證
指定欄位的驗證類型。
驗證於
指定何時驗證欄位:onSubmit、onBlur 或 onServer。
標籤
讓您指定欄位的標籤。
模式
讓您指定 JavaScript 規則運算式圖樣來驗證輸入。請省略字串前後的斜線。 如需詳細資訊,請參閱 Adobe ColdFusion 說明文件。
高度
讓您指定控制項的高度 (以像素為單位)。
寬度
讓您指定控制項的寬度 (以像素為單位)。
大小
讓您指定控制項的大小。
必要項
讓您指定日期欄位在表單提交至伺服器之前 是否必須包含值。
顯示標籤編輯器
讓您編輯沒有列在「屬性」檢視窗上的屬性。
修改 ColdFusion 表單控制項
無論您是在設計檢視 或程式碼檢視中工作,都可以視覺化變更 ColdFusion 表單控制項的屬性。
此增強功能僅在您 可存取執行 ColdFusion MX 7 或更新版本的電腦時才可使用。
「屬性」面板會顯示表單控制項的屬性。
如需更多資訊,請按一下「屬性」面板中的「說明」圖示。
驗證 ColdFusion 表單資料
您可以在 Dreamweaver 中建置 ColdFusion 表單,檢查指定欄位的內容以確保使用者輸入正確的資料類型。
只有當您可存取執行 ColdFusion MX 7 或更新版本的電腦時,才能使用此增強功能。
每個輸入「屬性」面板的下半部分包含控制項,可協助您定義特定的驗證規則。例如,您可能要指定文字欄位應包含電話號碼。若要進行此操作,請從「屬性」面板的「值」快顯選單中選取「電話」。您也可以從「驗證於」快顯選單中指定何時進行驗證。