Etable/form：修訂版本之間的差異

2022年7月24日 (日) 16:11的最新修訂版本

六階段流程說明

(一)form_edit與form_ins

(二)addElements($i,$value)

• 處理會員欄，「$value=$xoopsUser->getVar('uname');」是以 xoops 為外套時期使用，應移除
• 處理formType中各欄，除hidden、wrap以外諸欄
  1. unix_time：出時分秒小日曆
  2. date：出日期小日曆
  3. time：用 XoopsFormTime
  4. datetime：用 XoopsFormDateTime
  5. select：用 XoopsFormSelect 及其中的 addOptionArray(選項陣列)
  6. searchSelect：用 XoopsFormSelect 及其中的 addOptionArray(選項陣列)
  7. select2：用 XoopsFormSelect 及其中的 setExtra(" onChange='createOpt…'",false)、addOptionArray(選項陣列)
  8. radio：用 XoopsFormRadio 及其中的 addOptionArray(選項陣列)
  9. checkbox或bitCheckbox：用 XoopsFormCheckBox(欄代名,'f[表代名][欄名]',核取陣列或null) 及其中的 addOptionArray(選項陣列)。bitCheckbox 由 $value 拆解出各bit組合，成為預選值。
  10. radioyn：用 XoopsFormRadioYN
  11. auto：用 XoopsFormTextArea
  12. rangeNumber：用 XoopsFormRangeNumber ，限制輸入範圍的數值，如「成績分數」
  13. file：用 XoopsFormFile 盤，前為路徑選單，後為上傳按鈕
  14. text：用 XoopsFormText ，可加 showColExplain
  15. 其他(如 function)：用 XoopsFormText
• 處理不在formType中的各欄，依coltype產生表單元素
  1. blob/binary：XoopsFormLabel(表代名,BIDNT)
  2. blob/非binary：XoopsFormTextArea
  3. 其他：XoopsFormText

(三) javascript 中的表達

1. getElementsByName 的 Elements 是複數加's'，可以有很多同 name 的元素，即使只有一個，也要加 [0] 表示第一個
   而 getElementById 的 Element 是單數，只應傳回一個，不用加 [0]
2. .value 可以換成 .name 或 .type 或 .checked 或 .length

(四)colValue($j,$value,$row)

formType中只有特定表現沒有專用表單元素：

1. '長欄名'=>array('function',函式名)，請參考範例
2. '長欄名'=>array('wrap')，$value中的半形分號「;」代換為換行<br/>

(五)main()中單筆資料前置處理，含插畢、刪一筆、編一筆

在編畢與插畢中，if(is_array($value)){…}裡面

1. 是 datetime ：綜合 $value['date'],$value['pm'],$value['hour'],$value['min'] 得出年月日時分秒字串
2. 是 time ：綜合 $value['hour'],$value['min'] 得出時分秒字串
3. 是 bitCheckbox ：將各元素值加總

(六)main()中蒐尋表單傳入值前置處理

欄名必須在 search 陣列中

1. 欄名在 searchId 陣列中，條件用「該欄欄名='蒐尋表單傳回值'」
2. formType[欄名][0]=='bitCheckbox'，條件用「該欄欄名&蒐尋表單傳回值=蒐尋表單傳回值」
3. 其他情形，條件用「該欄欄名 like '%蒐尋表單傳回值%'」

(七)main()輸出蒐尋排序表單

1. 日期欄用 text 型 input 輸入年月
2. select欄、radio欄、bitCheckbox欄：出 select 選單
3. checkbox欄：出核取方塊，選取有選的。其實 checkbox 應有三種蒐尋樣態，有選的、沒選的、全部。本段應改成選單。

表單物件應用

$表單=new XoopsThemeForm(抬頭,表單名,$_SERVER['PHP_SELF']);

$選單元素=new XoopsFormSelect(抬頭,元素名,後送預設值,選項數,是否複選,id,是否span); // 前二引數必填

1. $選單元素->addOptionArray($選項陣列); // 將選項放上選單元素
2. $選項陣列中的諸陣列元素的索引為後送值，諸陣列元素的值為提示。

$表單->addElement($選單元素,是否必填); // 之後才將$選單元素放入表單

$表單->display(); // 印出表單，此方法在 form.php 中定義

前後呼應

etable.php 中

/// 表單區
function addElements
…new XoopsFormTime(欄代名,'f[欄名]',15,欄值);
…form->addElement(上面生成的物件);

前面

// 主函式
function main
// 單筆資料前置處理，含插畢、刪一筆、編一筆
if(is_array($value)){
	if(isset($value['hour']) && isset($value['min'])){$value=$value['hour'].':'.$value['min'].':00';}
}
以上段落出現兩次