Etable/form/addElements
出自六年制學程
addElements($i,$value) $i 代表 select 的第幾欄 $value 代表傳入欄值
$lc_name=$this->fields[$i]['lc_name'];
會將該欄的長欄名,如「住宿」,放入 $lc_name 。
$xoopsUser
- 是一個物件
- 專門給欄名為「uname」者使用
- 其方法 getVar('uname') 會取回註冊名
form.php
表單的抽象結構
諸屬性
- $_action:後送目的地
- $_method:後送方法
- $_name:表單名
- $_title:表單的抬頭
- $_elements:集合各表單元素構成的陣列
- $_extra:form 標籤內的額外訊息
- $_extra1:待定義
- $_extra2:表單後方的額外訊息
- $_required:必填各表單元素構成的陣列
諸方法
- 初始方法 XoopsForm($title, $name, $action, $method="post", $addtoken=false)
- 取傳入的 $title 為物件抬頭
- 若傳入的 $name 非為空字串即為物件名,不然物件名預設為 "xoops_form"
- 取傳入的 $action 為物件後送目的地
- 取傳入的 $method 為物件後送通導;此項未設,預設止 POST 通道
- 丁丁要忽略 XoopsFormHiddenToken
- $this->addElement(new XoopsFormHidden('skipValidationJS', 0));
- $this->setExtra('onsubmit="return xoopsFormValidate_'.$this->getName().'();"');
- getTitle():送物件抬頭
- getName():送物件名
- getAction():送物件目的地
- getMethod():送物件通道
- addElement(&$formElement, $required=false):$_elements 與 $_required 要不要加一元素
- &getElements($recurse = false):處理遞歸的表單元素
- getElementNames():取所有表單元素名構成陣列
- &getElementByName($name):依表單元素名送回表單元素物件
- setElementValue($name, $value):對表單元素以該元素的 setValue 方法派入 $value
- setElementValues($values):$values 為陣列,對眾表單元素扎批次派值
- &getElementValue($name):對表單元素以該元素的 getValue 方法取值
- &getElementValues():對表單所有元素以該元素的 getValue 方法取值,並構成值的陣列
- setExtra(額外字串,取代=false,$i=):設定額外資訊,預設為添附;也可以設為取代。
- getExtra($i=):送回額外資訊
- setRequired(&$formElement):設定某表單元素為必填欄位
- &getRequired():傳回所有表單的必填欄位
- insertBreak($extra = null):無內容
- render():無內容
- display():依 form 物件設定的 render() 表現內容
- renderValidationJS($withtags=true):造 javascript 驗證函式
- assign(&$tpl):樣版化各表單元素
themeform.php
表單實體化
諸方法
- insertBreak(…):未使用
- render():實體化
- 用 getName() 取表單名與表單 id
- 用 getAction() 取目的地
- 用 getMethod() 取後送通道
- 用 getExtra() 補上 form 標籤內額外字串
- 將 表單元素->isHidden() 者實體化
- 出 <table>
- 第一列跨兩欄,放 getTitle()
- 其餘各列:
- 第一欄出 表單元素->getCaption(),如是是必填欄位再加「*」
- 表單元素->getDescription() 非空字串,再加「換行換行加粗『表單元素->getDescription()』」
- 第二欄出 表單元素->render()
- 如果有必填欄位最後一列跨兩欄,放「* = 必填欄位,務請填寫。」
- 最後一行之後,</table>之前放 $_extra2 ,可以寫成跨兩欄,也可以寫成兩欄;可以寫 th 也可以寫 td
- 出 </table>
- 出 </form>
- 出 renderValidationJS( true )