WebSVN – php-qbpwcf – Diff – /trunk/usr/lib64/qbpwcf/jquery.php

 <?php
 /*
 	QBPWCF, Quick Build PHP website Component base on Fedora Linux.
-    Copyright (C) 2015~2024 Min-Jhin,Chen
+    Copyright (C) 2014~2025 MIN ZHI, CHEN
     This file is part of QBPWCF.
     QBPWCF is free software: you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
 	#$arguments,陣列,為呼叫方法時所用的參數.
 	#參考資料:
 	#__call=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic
 	*/
 	public function __call($method,$arguments){
 		#取得當前執行的函式
 		$result["function"]=__FUNCTION__;
 		#設置執行不正常
 		$result["status"]="false";
 		#設置執行錯誤
 		$result["error"][]=__NAMESPACE__ ."/".$method."() 不存在!";
 		#設置所丟入的參數
 		$result["error"][]=$arguments;
 		#回傳結果
 		return $result;
 		}#function __call end
 	/*
 	#函式說明:
 	#當前類別被呼叫的靜態方法不存在時,將會執行該函數,回報該方法不存在.
 	#回傳結果:
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$arguments,陣列,為呼叫方法時所用的參數.
 	#參考資料:
 	#__call=>http://php.net/manual/en/language.oop5.overloading.php#object.callstatic
 	*/
 	public static function __callStatic($method,$arguments){
 		#取得當前執行的函式
 		$result["function"]=__FUNCTION__;
 		#設置執行不正常
 		$result["status"]="false";
 		#設置執行錯誤
 		$result["error"][]="欲呼叫的". __NAMESPACE__ ."/".$method."() 不存在!";
 		#設置所丟入的參數
 		$result["error"][]=$arguments;
 		#回傳結果
 		return $result;
 		}#function __callStatic end
 	/*
 	#涵式說明：
 	#透過id讓元素點一下就出現或消失的jquery涵式
 	#回傳的內容：
 	#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 	#$result["error"],錯誤訊息
 	#$result["content"],jquery語法
 	#$result["function"],當前執行的函數名稱
 	#必填的參數：
 	$conf["jqueryLocation"],字串,jquery套件的位置,可以為網址.
 	$conf["jqueryLocation"]="";
 	$conf["elementId"],字串,js的觸發對象要套用在哪個id的元素。
 	$conf["elementId"]="";
 	*/
 	function showOrHide($conf){
 		#初始化要回傳的內容
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#初始化要回傳的語法
 		$result["content"]="";
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明：
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#必填寫的參數：
 		#$conf["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("jqueryLocation","elementId","triggerElementId","triggerCondition","hideOrShow");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","string","string","string");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("mimeType","compressType","delFile");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,「null」代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array("null","base64","false");
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["arrayCountEqualCheck"][]=array();
 		$checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkResult["status"]=="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkResult["passed"]=="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#涵式說明：
 		#script 語法開始
 		#回傳的結果：
 		#必填的參數：
 		$conf["javaScript"]["start"]["include"]="true";#是否要匯入外部js庫。"true"爲要匯入；"false"爲沒有要匯入。
 		#可省略的參數：
 		$conf["javaScript"]["start"]["jsPosition"]=$conf["jqueryLocation"];#要匯入的js檔案位置。
 		$javaScriptStart=javaScript::start($conf["javaScript"]["start"]);
 		unset($conf["javaScript"]["start"]);
 		#如果js語法開始失敗
 		if($javaScriptStart["status"]=="false"){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置執行失敗訊息
 			$result["error"]=$javaScriptStart;
 			#回傳結果
 			return $result;
 			}#if end
 		#串接js開始的語法
 		$result["content"]=$result["content"].$javaScriptStart["content"];
 		#串接js結束的語法,因為JQuery要單獨匯入才能使用.
 		#涵式說明：
 		#script 語法結束
 		#script 語法開始
 		#回傳的結果：
 		#必填的參數：
 		$conf["javaScript"]["start"]["include"]="false";#是否要匯入外部js庫。"true"爲要匯入；"false"爲沒有要匯入。
 		#可省略的參數：
 		#$conf["javaScript"]["start"]["jsPosition"]=$conf["jqueryLocation"];#要匯入的js檔案位置。
 		$javaScriptStart=javaScript::start($conf["javaScript"]["start"]);
 		unset($conf["javaScript"]["start"]);
 		#如果js語法開始失敗
 		if($javaScriptStart["status"]=="false"){
 			#設置執行不正常
 			$result["status"]="false";
 			#設置執行失敗訊息
 			$result["error"]=$javaScriptStart;
 			#回傳結果
 			return $result;
 			}#if end
 		#串接js開始的語法
 		$result["content"]=$result["content"].$javaScriptStart["content"];
 		#如果效果的呈現不是在要套用到的元素
 		if($conf["triggerElementId"]!="this"){
 			$conf["triggerElementId"]="\"#".$conf["triggerElementId"]."\"";
 			}#if end
 		#點選該元素，會使該元素消失的消失的jquery涵式。
 		$result["content"]=$result["content"]."
 			$(document).ready(function(){
 				$(\"#".$conf["elementId"]."\").".$conf['triggerCondition']."(function(){
 					$(".$conf["triggerElementId"].").".$conf["hideOrShow"].";
 					});
 				});
 			";
 		#涵式說明：
 		$result["status"]="true";
 		#回傳語法
 		return $result;
 		}#function showOrHide end
 	/*
 	#函數說明:
 	#確認是否真的要執行點擊的動作,進而觸發表單,超連結.
 	#回傳結果:
 	#可省略參數:
 	#$conf["comment"],字串陣列,確認視窗的提示文字,每個元素代表一列內容.
 	#$conf["comment"]=array("");
 	*/
 	function confirmClick(&$conf){
 		#初始化要回傳的內容
 		$result=array();
 		#當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#初始化要回傳的語法
 		$result["content"]="";
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明：
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 		#$reuslt["error"],執行不正常結束的錯訊息陣列.
 		#必填寫的參數：
 		#$conf["variableCheck::checkArguments"]["varInput"],陣列變數,要檢查的陣列變數,請在要檢查的參數前面加上&，這樣變動的結果才能被套用。
 		$conf["variableCheck::checkArguments"]["varInput"]=&$conf;
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"],爲必填參數的變數名稱陣列，形態爲陣列變數，例如: $conf["mustBeFilledVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableName"]=array("jqueryPosition","triggerId");
 		#$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		$conf["variableCheck::checkArguments"]["canBeEmptyString"]="false";
 		#$conf["variableCheck::checkArguments"]["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("comment");
 		#$conf["variableCheck::checkArguments"]["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array");
 		#$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(array("確定執行?"));
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array();
 		$checkResult=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查失敗
 		if($checkResult["status"]=="false"){
 			#設置錯誤狀態
 			$result["status"]="false";
 			#設置錯誤提示
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查不通過
 		if($checkResult["passed"]=="false"){
 			#設置錯誤狀態
 			$result["status"]="false";
 			#設置錯誤提示
 			$result["error"]=$checkResult;
 			#回傳結果
 			return $result;
 			}#if end
 		#確認視窗的js語法
 		#函式說明:
 		#確認視窗,回傳的javaScript結果可在要觸發的元素裡面搭配「onclink=本函數回傳的內容」,來使連結或按鈕確定觸發或不觸發.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"為正常,"false"為不正常.
 		#$result["error"],錯誤訊息陣列
 		#$result["function"],當前執行的函數名稱
 		#$result["content"],javaScript語法
 		#必填的參數：
 		#$conf["alertSentenceArray"],字串陣列彈出式視窗的內容,每個元素代表每一列的內容.
 		$conf["javaScript::confirmWindow"]["alertSentenceArray"]=$conf["comment"];
 		$confirmWindow=javaScript::confirmWindow($conf["javaScript::confirmWindow"]);
 		unset($conf["javaScript::confirmWindow"]);
 		#如果建立確認視窗失敗
 		if($confirmWindow["status"]=="false"){
 			#設置錯誤狀態
 			$result["status"]="false";
 			#設置錯誤提示
 			$result["error"]=$confirmWindow;
 			#回傳結果
 			return $result;
 			}#if end
 		#JQuery 按下特定元素觸發確認視窗的語法
 		$jQuery="
 		//當文件讀取完成
 		$(document).ready(function(){
 			//當id為add的元素點擊時
 			$('#".$conf["triggerId"]."').click(function(){
 				//回傳確認視窗是按下 true(確認) 或 false(取消)
 				".$confirmWindow["content"]."
 				});//function end
 			});//funtion end
 		";
 		#函式說明:
 		#加上<script></script>標籤,並且可以指定要匯入的js檔案.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"為正常,"false"為不正常.
 		#$result["error"],錯誤訊息陣列
 		#可省略參數:
 		#$conf["jsPosition"],字串,要匯入的js檔案位置.
 		$conf["javaScript::addScriptTag"]["jsPosition"]=$conf["jqueryPosition"];
 		$addScriptTag=javaScript::addScriptTag($conf["javaScript::addScriptTag"]);
 		unset($conf["javaScript::addScriptTag"]);
 		#如果加上<script></script>標籤失敗
 		if($addScriptTag["status"]=="false"){
 			#設置錯誤狀態
 			$result["status"]="false";
 			#設置錯誤提示
 			$result["error"]=$addScriptTag;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得確認點擊視窗的語法
 		$result["content"]=$result["content"].$addScriptTag["content"];
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function confirmClick end
 	/*
 	#涵式說明:
 	#建立特定元素的jquery on click事件
 	#$result["importJS"],匯入js的語法,必定含有<script></script>標籤.
 	#必填參數:
 	#$conf["trigger"],字串,要設定click事件的目標(selector),可以為ID("#element_id"),class(".trigger"),tag("div"),tag&attr("div[data-action=nextPage]"),combine tag&class("div.flip").
 	$conf["trigger"]="";
 	#$conf["content"],字串,click事件觸發後,要做的事情.
 	$conf["content"]="";
 	#可省略參數:
 	#$conf["jqueryPath"],字串,jquery的位置,預設不指定.
 	#$conf["jqueryPath"]="";
 	#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑,請與參數"jqueryPath"一起設置,預設為當前檔案的位置.
 	#$conf["fileArgu"]=__FILE__;
 	#$conf["noScriptTag"]="false";
 	#參考資料:
 	#selector=>https://api.jquery.com/category/selectors/
 	*/
 	function onClick(&$conf){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#如果沒有參數
 		if(func_num_args()==0){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]="函數".$result["function"]."需要參數";
 			#回傳結果
 			return $result;
 			}#if end
 		#取得參數
 		$result["argu"]=$conf;
 		#如果 $conf 不為陣列
 		if(gettype($conf)!="array"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"][]="\$conf變數須為陣列形態";
 			#如果傳入的參數為 null
 			if($conf==null){
 				#設置執行錯誤訊息
 				$result["error"][]="\$conf變數不得為null,請檢查函數「".$result["function"]."」的參數設置有無正確!";
 				}#if end
 			#回傳結果
 			return $result;
 			}#if end
 		#檢查參數
 		#函式說明：
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$conf["canBeEmpty"]=array();
 		#$conf["skipableVariableCanNotBeEmpty"],字串陣列,哪些可省略參數不可以為空字串或空陣列.
 		#$conf["skipableVariableCanNotBeEmpty"]=array();
 		#$conf["skipableVariableName"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("jqueryPath","fileArgu","noScriptTag");
 		#$conf["skipableVariableType"],陣列字串,爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("string","string","string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null與代表不指定,若預設值是參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,__FILE__,"false");
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		#$conf["arrayCountEqualCheck"][]=array();
 		$checkArguments=variableCheck::checkArguments($conf["variableCheck::checkArguments"]);
 		unset($conf["variableCheck::checkArguments"]);
 		#如果檢查參數失敗
 		if($checkArguments["status"]==="false"){
 			#設置執行錯誤
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#如果檢查參數不通過
 		if($checkArguments["passed"]==="false"){
 			#設置執行錯誤
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$checkArguments;
 			#回傳結果
 			return $result;
 			}#if end
 		#建立 on click 事件
 		$onClickScript="
 			$('".$conf["trigger"]."').on('click',function()
+			{
 				".$conf["content"]."
 			});
 			";
 		#建立script
 		#函式說明:
 		#加上<script></script>標籤,並且可以指定要匯入的js檔案.
 		#回傳結果:
 		#$result["status"],執行是否正常,"true"為正常,"false"為不正常.
 		#$conf["jsProgramSection"],陣列字串,不含<script></script>標籤的javsScript程式碼,可以放多個script程式.
 		$conf["javaScript::addScriptTag"]["jsProgramSection"]=array($onClickScript);
 		#可省略參數:
 		#$conf["fileArgu"],字串,php變數__FILE__的內容,亦即該檔案在檔案系統的絕對路徑,請與參數"jsPosition"一起設置,預設為當前檔案的位置.
 		$conf["javaScript::addScriptTag"]["fileArgu"]=$conf["fileArgu"];
 		#如果有設置 $conf["jsPosition"]
 		if(isset($conf["jqueryPath"])){
 			#$conf["jsPosition"],字串,要匯入的js檔案位置.
 			$conf["javaScript::addScriptTag"]["jsPosition"]=$conf["jqueryPath"];
 			}#if end
 		#$conf["noScriptTag"],字串,是否不要用script tag包住回傳的內容($result["content"]),"true"代表不要用,"false"代表要用,預設為"false".
 		$conf["javaScript::addScriptTag"]["noScriptTag"]=$conf["noScriptTag"];
 		$addScriptTag=javaScript::addScriptTag($conf["javaScript::addScriptTag"]);
 		unset($conf["javaScript::addScriptTag"]);
 		#如果建立 script tag 失敗
 		if($addScriptTag["status"]==="false"){
 			#設置執行錯誤
 			$result["status"]="false";
 			#設置錯誤訊息
 			$result["error"]=$addScriptTag;
 			#回傳結果
 			return $result;
 			}#if end
 		#取得語法
 		$result["content"]=$addScriptTag["content"];
 		#如果存在要匯入js的語法
 		if(isset($addScriptTag["importJS"])){
 			#設置匯入js的語法
 			$result["importJS"]=$addScriptTag["importJS"];
 			}#if end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function onClick end
 	}#class jquery end
 ?>

Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/jquery.php – Rev 3 → 226