:::
9. 刪除資料（30分鐘）
10. XOOPS的表單物件（40分鐘）
一、 新增與修改
- 新增和修改都需要一個編輯用的表單界面
- 我們可以在樣板多個新增的按鈕：
<a href="main.php?op=add_form" class="btn btn-primary">新增詞彙</a>
- 在流程多一組對應：
case "add_form": add_form(); break;
- 然後多一個add_form()函數：
//編輯詞彙表單 function add_form(){ global $xoopsTpl; } - 接著，我們要在這個函數中，利用XOOPS的表單物件來建立一個編輯表單。
二、 物件的基本動作及概念
- PHP 的 Class（類）是一個物件藍圖
- 要讓 Class 有作用需要經過實體化（new）的動作：
$物件 = new 某物件Class();
- 物件會有所謂的方法（method）其實就是函數，讓您對此物件進行設、取值或執行特定物件功能：
$物件->方法();
- XOOPS的表單物件設定完，最後都需要進行$物件->render();以產生程式碼。
- 詳細的XOOPS Class請參考：http://dev.xoofoo.org/dev_xoops_255/inherits.html
三、 XOOPS內建表單Class
- 要使用內建表單需先引入此行：
include_once(XOOPS_ROOT_PATH."/class/xoopsformloader.php");
- 建立一個表單：
$form = new XoopsThemeForm('表單標題', 'name', 'action.php', 'post', '使用token' , '摘要'); //例如： $form = new XoopsThemeForm('編輯詞彙', '', 'main.php', 'post', true); - 標籤元件：
$元件變數 =new XoopsFormLabel('標題', '內容'); - 文字輸入：
$元件變數 =new XoopsFormText('標題', 'name', 大小 , 最大長度 , '值'); //例如： $input_eng =new XoopsFormText('英文', 'eng', 20 , 255 , $eng); - 隱藏欄位：
$元件變數 =new XoopsFormHidden('name', '值'); //例如： $hidden_op =new XoopsFormHidden('op', 'insert'); - 安全檢查：
$元件變數=new XoopsFormHiddenToken('XOOPS_TOKEN_REQUEST',360); - 上傳欄位：
$form->setExtra("enctype='multipart/form-data'"); $元件變數 =new XoopsFormFile('標題', 'name', '2048'); - 密碼欄位：
$元件變數=new XoopsFormPassword('標題', 'name', 大小, 最大長度, '值'); - 大量文字：
$元件變數=new XoopsFormTextArea('標題', 'name', '值' , 欄寬 , 列高 , 'id'); - XOOPS編輯器：
$元件變數=new XoopsFormDhtmlTextArea('標題' , 'name', '值' , 欄寬 , 列高); - 複選方塊：
$元件變數 = new XoopsFormCheckBox('標題', 'name', '值','id'); //加入選項方法一： $元件變數->setValue($多重預設值陣列); //加入選項方法二： $元件變數->addOption('選單值1', '顯示值1', false); //加入選項方法三： $options['選單值2']='顯示值2'; $options['選單值3']='顯示值3'; $元件變數->addOptionArray($options); - 單選鈕：（選項及預設值設法同複選）
$元件變數 = new XoopsFormRadio('標題', 'name', '值'); - 是否單選：
$元件變數=new XoopsFormRadioYN('標題', 'name', '值'); - 下拉選單：（選項及預設值設法同複選，多選預設false）
$元件變數=new XoopsFormSelect('標題', 'name', '預設值', 大小, 多選); - 群組核選：（多選預設false）
$元件變數=new XoopsFormSelectCheckGroup('標題', 'name', '值', 大小 ,多選); - 國家選單：（值：TW）
$元件變數=new XoopsFormSelectCountry('標題', 'name', '值', 大小); - 編輯器選單：（使用HTML預設false ）
$元件變數=new XoopsFormSelectEditor(&$form, 'name', '值', 使用HTML , 可選編輯器陣列);
- 群組選單：（含訪客預設false，多選預設false）
$元件變數=new XoopsFormSelectGroup('標題', 'name', 含訪客, '值', 大小 ,多選); - 語系選單：（值tchinese_utf8，多選預設false）
$元件變數=new XoopsFormSelectLang('標題', 'name', '值', 大小); - 比對選單：
$元件變數=new XoopsFormSelectMatchOption('標題', 'name', '值', 大小); - 佈景選單：
$元件變數=new XoopsFormSelectTheme('標題', 'name', '值', 大小); - 時區選單：
$元件變數=new XoopsFormSelectTimezone('標題', 'name', '值', 大小); - 使用者選單：（含訪客預設false，多選預設false）
$元件變數=new XoopsFormSelectUser('標題', 'name', 含訪客, '值', 大小 ,多選); - 按鈕：（類型：submit或reset）
$元件變數 =new XoopsFormButton('標題', 'name', '值', '類型'); //例如： $submit_btn =new XoopsFormButton('', '', '儲存', 'submit'); - 把元件加入表單中：
$form->addElement($元件變數); //例如： $form->addElement($input_eng); $form->addElement($input_cht); $form->addElement($hidden_op); $form->addElement($submit_btn);
- 把幾個元件組合在一起，並放到表單中：
$Tray1=new XoopsFormElementTray('標題', ' ', 'name'); $Tray1->addElement(new XoopsFormButton('', 'name', '送出', 'submit')); $Tray1->addElement(new XoopsFormButton('', 'name', '清除', 'reset')); $form->addElement($Tray1); - 產生表單程式碼：
$f=$form->render();
三、 完整範例
- 寫成函數看起來如下：
//編輯詞彙表單 function add_form(){ global $xoopsTpl; include_once(XOOPS_ROOT_PATH."/class/xoopsformloader.php"); $form = new XoopsThemeForm('編輯詞彙', '', 'main.php', 'post', true); $input_eng =new XoopsFormText('英文', 'eng', 20 , 255 , $eng); $input_cht =new XoopsFormText('中文解釋', 'cht', 20 , 255 , $cht); $hidden_op =new XoopsFormHidden('op', 'insert'); $submit_btn =new XoopsFormButton('', '', '儲存', 'submit'); $form->addElement($input_eng); $form->addElement($input_cht); $form->addElement($hidden_op); $form->addElement($submit_btn); $f=$form->render(); $xoopsTpl->assign("form" ,$f); } - 利用 $xoopsTpl->assign('form',$f) 將產生的表單語法，套用到樣板中的<{$form}>標籤裡。
- 請在樣板中加入 <{$form}> 標籤，如：
<{if $form}> <{$form}> <{else}> <h1>字典管理</h1> ....略.... <{$bar}> <{/if}>
