Etable/formType/末端指示元素：修訂版本之間的差異

2024年5月15日 (三) 16:53的修訂版本

補充說明欄位含意(M,數據模型)：

end($this->formType["$lc_name"])['elementSeparator']

• 用於複選核取方塊
• 相關諸方法
  1. 函式 fieldValue2sqlStr 中：決定欄值中諸選項的分隔符號
  2. 函式 colValue(欄序,原始欄值,$row)：將複選核取方塊諸項，由值轉成提示
  3. 函式 addElements($i,$value)：製造「插、編」表單諸複選欄中，哪些欄值被預選
• 範例程式：
  1. http://gogopublic.net/ggp/OSJA/OSJAhelper.php，施采邑，兩者都不選，應住入空白，但注入 0

補充說明如何輸入欄值(C,使用者控制)：

1. end($this->formType["$lc_name"])['showColExplain']
   • 用於 formType 為 auto 或 text 之欄；或
   • 相關諸方法

   函式 addElements($i,$value)：製造「插、編」表單，

   • auto 或 text 欄中，增加欄位的注入說明
   • 隱藏欄的末端指示元素，同時設'formType'為 'auto' ，'showColExplain' 為欄位注入補充說明

   • 範例程式：
     1. 看議程人員有沒有要申請社群聚會時段
     2. http://quality-learning.net/2023/agenda/editAgenda.php 不可用，缺表 2023AgendaMaker
2. end($this->formType["$lc_name"])['formType']
   • 用於隱藏欄非以預設函式賦值時(由使用者賦值)，指定的表單元件型態。目前只定義了 auto 一種。
   • 相關諸方法

   函式 addElements($i,$value)：製造「插、編」表單，隱藏欄的末端指示元素，同時設'formType'為 'auto' ，'showColExplain' 為欄位注入補充說明

   • 範例程式：
     1. http://gogopublic.net/ggp/DEC/trigger1.php

指示欄值顯示函式(V,view)：

end($this->formType["$lc_name"])['showColValueGuide']須為字串，為自訂函式名稱

• 用於所有欄位
• 相關諸方法

函式 colValue(欄序,原始欄值,$row)：按自定函數表現欄值
函式的引數為陣列，形式如：
函式名(array('colOrder'=>欄序,'value'=>原始欄值,'row'=>$row))

• 範例程式：
  1. http://urclass.net/AL/course.php?workControl%5Bcid%5D=197，
     searchSelect 型的欄可以指示 showColValueGuide
     • 修改 formsome.php 中的 function XoopsFormSearchSelect(…) ，依指示生成 $valuePrompt ，且 $j->addOptionArray 時可以送 $value=>$valuePrompt
  2. http://gogopublic.net/ggp/DEC/trigger.php
  3. http://gogopublic.net/ggp/DEC/trigger0.php
  4. http://quality-learning.net/2022/agenda/person.php 的交通車欄
  5. http://quality-learning.net/2022/agenda/personAM.php