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

 <?php
 /*
 	QBPWCF, Quick Build PHP website Component base on Fedora Linux.
-    Copyright (C) 2015~2025 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
 	/*
 	#函式說明:
 	#建立一個 iframe 框架
 	#$conf["br"],字串,爲放置完該iframe後是否要換行,"true"爲要換行；"flase"爲不要換行。
 	$conf["br"]="true";
 	#可省略參數:
 	#$conf["class"],字串陣列,爲該 iframe 要套用的css樣式類別名稱.
 	#$conf["class"]=array("");
 	#$conf["scrolling"],字串,是否要取消滾軸功能,"false"代表取消滾軸功能.
 	#$conf["scrolling"]="";
 	#$conf["width"],字串,iframe的寬度.
 	#$conf["width"]="";
 	#$conf["height"],字串,iframe的高度.
 	#$conf["height"]="";
 	#https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe#sandbox
 	#備註:
 	#無.
 	*/
 	public static function createIframe(&$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
 		#檢查參數
 		#函式說明：
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$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("webPage","name","br");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string","string","string");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="true";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("class","scrolling","width","height","minWidth","maxWidth","minHeight","maxHeight","soucreId","sandbox","extraAttrAndValue","frameExtraAttrAndValue");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","string","string","string","string","string","string","string","string","string","array","array");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,"true",null,null,null,null,null,null,null,"false",null,null);
 		#$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
 		#如果$conf["class"]不存在
 		if(!isset($conf["class"])){
 			#不設定要套用的類別樣式
 			$conf["frameCssStyle"]="";
 			}#if end
 			#取得class字串
 			#涵式說明:
 			#建立class屬性字串,亦即套用多個class樣式的設定字串.
 			#回傳結果:
 			#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 			#$result["function"],當前執行的函數
 			#$result["error"],錯誤訊息陣列
 			#$result["content"],class屬性字串的內容
 			#必填參數:
 			#$conf["class"],字串陣列,要套用的類別樣式名稱.
 			$conf["css::classStr"]["class"]=$conf["class"];
 			$classStr=css::classStr($conf["css::classStr"]);
 			unset($conf["css::classStr"]);
 			#如果建立class類別字串失敗
 			if($classStr["status"]=="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$classStr;
 				#回傳結果
 				return $result;
 				}#if end
 			#取得類別樣式字串
 			$conf["frameCssStyle"]=$classStr["content"];
 			}#else end
 		#如果 $conf["scrolling"] 有設置
 		if(isset($conf["scrolling"])){
 			#如果 $conf["scrolling"] 等於 "false"
 			if($conf["scrolling"]=="false"){
 				#設定關閉滾軸
 				$conf["scrolling"]=" scrolling=no ";
 				}#if end
 			#反之
 			else{
 				#不做設定
 				$conf["scrolling"]="";
 				}#else end
 			}#if end
 		#反之
 		else{
 			#不做設定
 			$conf["scrolling"]="";
 			}#else end
 		#初始化 style 字串
 		$conf["styleStr"]="";
 		#如果有設定寬度或高度
 		if(isset($conf["width"]) || isset($conf["height"])){
 			#如果有設定寬度
 			if(isset($conf["width"])){
 				#設定寬度
 				$conf["css::styleStr"]["styleName"][]="width";
 				$conf["css::styleStr"]["styleValue"][]=$conf["width"];
 				}#if end
 			#如果有設定高度
 			if(isset($conf["height"])){
 				#設定高度
 				$conf["css::styleStr"]["styleName"][]="height";
 				$conf["css::styleStr"]["styleValue"][]=$conf["height"];
 				}#if end
 			#如果有設定最小寬度
 			if(isset($conf["minWidth"])){
 				#設定寬度
 				$conf["css::styleStr"]["styleName"][]="min-width";
 				$conf["css::styleStr"]["styleValue"][]=$conf["minWidth"];
 				}#if end
 			#如果有設定最大寬度
 			if(isset($conf["maxWidth"])){
 				#設定寬度
 				$conf["css::styleStr"]["styleName"][]="max-width";
 				$conf["css::styleStr"]["styleValue"][]=$conf["maxWidth"];
 				}#if end
 			#如果有設定最小高度
 			if(isset($conf["minHeight"])){
 				#設定寬度
 				$conf["css::styleStr"]["styleName"][]="min-height";
 				$conf["css::styleStr"]["styleValue"][]=$conf["minHeight"];
 				}#if end
 			#如果有設定最大高度
 			if(isset($conf["maxHeight"])){
 				#設定寬度
 				$conf["css::styleStr"]["styleName"][]="max-height";
 				$conf["css::styleStr"]["styleValue"][]=$conf["maxHeight"];
 				}#if end
 			#函式說明:
 			#建立給與html標籤使用的style屬性字串.
 			#回傳的結果：
 			#$result["status"],執行是否正常,"true"代表正常,"false"代表不正常.
 			#$result["function"],當前執行的函數
 			#$result["error"],錯誤訊息陣列
 			#$result["content"],css設定內容
 			#必填參數:
 			#$conf["css::styleStr"]["styleName"]=array("");#為屬性名稱，須為陣列值
 			#$conf["css::styleStr"]["styleValue"]=array("");#為屬性值，須為陣列值
 			$styleStr=css::styleStr($conf["css::styleStr"]);
 			unset($conf["css::styleStr"]);
 			#如果建立 style 字串失敗
 			if($styleStr["status"]=="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$styleStr;
 				#回傳結果
 				return $result;
 				}#if end
 			#取得 style 字串
 			$conf["styleStr"]=$styleStr["content"];
 			}#if end
 		#iframe語法,frameborder = 0 可以讓IE9看起來不會有外框
 		#$result["content"]="<iframe src = ".$conf["webPage"]." name = ".$conf["name"].$conf["scrolling"]." id = ".$conf["name"]." frameborder = 0 ".$conf["frameCssStyle"]." ".$conf["styleStr"]." ></iframe>";
 		#初始化儲存div或span其餘的屬性與數值
 		$extraAttrAndValue="";
 		#如果有設置 $conf["extraAttrAndValue"]
 		if(isset($conf["extraAttrAndValue"])){
 			#針對每個屬性與數值
 			foreach($conf["extraAttrAndValue"] as $attr=>$val ){
 				#串接每個屬性與數值
 				$extraAttrAndValue=$extraAttrAndValue." ".$attr."=\"".$val."\"";
 				}#foreach end
 			}#if end
 		#初始化儲存frame其餘的屬性與數值
 		$frameExtraAttrAndValue="";
 		#如果有設置 $conf["frameExtraAttrAndValue"]
 		if(isset($conf["frameExtraAttrAndValue"])){
 			#如果要用 sandbox 參數
 			if($conf["sandbox"]==="true"){
 				#增加 sandbox 參數與屬性
 				$conf["frameExtraAttrAndValue"][]=array("sandbox"=>"allow-popups allow-scripts allow-modals allow-forms allow-downloads");
 				}#if end
 			#針對每個屬性與數值
 			foreach($conf["frameExtraAttrAndValue"] as $attr=>$val ){
 				#串接每個屬性與數值
 				$frameExtraAttrAndValue=$frameExtraAttrAndValue." ".$attr."=\"".$val."\"";
 				}#foreach end
 			}#if end
 		#反之沒有設置 $conf["frameExtraAttrAndValue"]
 		else{
 			#設置 sandbox 參數與屬性
 			$frameExtraAttrAndValue="sandbox=\"allow-popups allow-scripts allow-modals allow-forms allow-downloads\"";
 			}#else end
 		#如果 $conf["br"] 爲 "true"
 		if($conf["br"]==="true"){
 			#用div包起來,寬高的style與class套用在div上面.
 			$result["content"]="<div ".$extraAttrAndValue." ".$conf["frameCssStyle"]." ".$conf["styleStr"].">"."<iframe ".$frameExtraAttrAndValue." style=\"width:100%;height:100%;\" src=\"".$conf["webPage"]."\" name=\"".$conf["name"]."\" ".$conf["scrolling"]." id = \"".$conf["name"]."\" frameborder=0></iframe></div>";
 			#如果存在 $conf["soucreId"]
 			if(isset($conf["soucreId"])){
 				#函式說明:
 				#將要執行的script語法透過該函式執行(會在程式外層用<script></script>包起來).
 				#回傳結果:
 				#$result["status"],執行是否正常,"true"為正常,"false"為不正常.
 				#$result["error"],錯誤訊息陣列
 					window.changeFrameEleHeightToFullLessSource.changeSizeFrameId='".$conf["name"]."';
 					window.changeFrameEleHeightToFullLessSource.fixedSizeFrameId='".$conf["soucreId"]."';
 				";
 				#可省略參數:
 				#$conf["onReady"],字串,是否要在網頁完全載入後再執行,"false"為不等載入完就先執行,預設為"true"要等載入完再執行.
 				$conf["javascript::toScript"]["onReady"]="false";
 				#$conf["globalJs"],字串陣列,為要放入<script>標籤的js全域變數.
 				#$conf["globalJs"]=array();
 				#$conf["jsFunciton"],字串陣列,為要放入<script>標籤的js函數.
 				#$conf["jsFunciton"]=array();
 				#參考資料:
 				#http://stackoverflow.com/questions/9899372/pure-javascript-equivalent-to-jquerys-ready-how-to-call-a-function-when-the
 				$toScript=javascript::toScript($conf["javascript::toScript"]);
 				unset($conf["javascript::toScript"]);
 				#如果建立script失敗
 				if($toScript["status"]==="false"){
 					#設置執行不正常
 					$result["status"]="false";
 					#設置錯誤訊息
 					$result["error"]=$toScript;
 					#回傳結果
 					return $result;
 					}#if end
 				#串接語法
 				$result["content"]=$result["content"].$toScript["content"];
 				}#if end
 			}#if end
 		#改用span將iframe包起來
 		else{
 			#用span包起來,寬高的style與class套用在iframe上面.
 			$result["content"]="<span ".$extraAttrAndValue.">"."<iframe ".$frameExtraAttrAndValue." ".$conf["frameCssStyle"]." ".$conf["styleStr"]." src=\"".$conf["webPage"]."\" name=\"".$conf["name"]."\" ".$conf["scrolling"]." id = \"".$conf["name"]."\" frameborder=0></iframe></span>";
 			}#else end
 		#執行到這邊，代表執行成功
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function createIframe end
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function createMultiIframe(&$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
 		#初始化要回傳的語法
 		$result["content"]="";
 		#檢查參數
 		#函式說明：
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$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("webPage","name","br");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array","array","array");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="true";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("class","scrolling","width","height","minWidth","maxWidth","minHeight","maxHeight","soucreId");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","array","array","array","array","array","array","array","array");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,null,null,null,null,null,null,null,null);
 		#$conf["arrayCountEqualCheck"],字串陣列,為檢查哪些陣列參數的元素數量要一樣,$conf["arrayCountEqualCheck"][$i]=array()為第$i組key為哪些的變數其元素數量要相等.
 		$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("webPage","name","br");
 		$conf["variableCheck::checkArguments"]["arrayCountEqualCheck"][]=array("br","class","scrolling","width","height","minWidth","maxWidth","minHeight","maxHeight","soucreId");
 		$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
 		#針對每個 $conf["webPage"]
 		foreach($conf["webPage"] as $index=>$url){
 			#初始化參數
 			$each=array();
 			#取得參數 "webPage"
 			$each["webPage"]=$url;
 			#取得參數 "name"
 			$each["name"]=$conf["name"][$index];
 			#取得參數 "br"
 			$each["br"]=$conf["br"][$index];
 			#如果有設置 $conf["class"][$index] 參數
 			if(isset($conf["class"][$index])){
 				#如果不是 null
 				if($conf["class"][$index]!==null){
 					#取得 "class" 參數
 					$each["class"]=$conf["class"][$index];
 					}#if end
 				}#if end
 			#如果有設置 $conf["scrolling"] 參數
 			if(isset($conf["scrolling"][$index])){
 				#如果不是 null
 				if($conf["scrolling"][$index]!==null){
 					#取得 "scrolling" 參數
 					$each["scrolling"]=$conf["scrolling"][$index];
 					}#if end
 				}#if end
 			#如果有設置 $conf["width"] 參數
 			if(isset($conf["width"][$index])){
 				#如果不是 null
 				if($conf["width"][$index]!==null){
 					#取得 "width" 參數
 					$each["width"]=$conf["width"][$index];
 					}#if end
 				}#if end
 			#如果有設置 $conf["height"] 參數
 			if(isset($conf["height"][$index])){
 				#如果不是 null
 				if($conf["height"][$index]!==null){
 					#取得 "height" 參數
 					$each["height"]=$conf["height"][$index];
 					}#if end
 				}#if end
 			#如果有設置 $conf["minWidth"] 參數
 			if(isset($conf["minWidth"][$index])){
 				#如果不是 null
 				if($conf["minWidth"][$index]!==null){
 					#取得 "minWidth" 參數
 					$each["minWidth"]=$conf["minWidth"][$index];
 					}#if end
 				}#if end
 			#如果有設置 $conf["maxWidth"] 參數
 			if(isset($conf["maxWidth"][$index])){
 				#如果不是 null
 				if($conf["maxWidth"][$index]!==null){
 					#取得 "maxWidth" 參數
 					$each["maxWidth"]=$conf["maxWidth"][$index];
 					}#if end
 				}#if end
 			#如果有設置 $conf["minHeight"] 參數
 			if(isset($conf["minHeight"][$index])){
 				#如果不是 null
 				if($conf["minHeight"][$index]!==null){
 					#取得 "minHeight" 參數
 					$each["minHeight"]=$conf["minHeight"][$index];
 					}#if end
 				}#if end
 			#如果有設置 $conf["maxHeight"] 參數
 			if(isset($conf["maxHeight"][$index])){
 				#如果不是 null
 				if($conf["maxHeight"][$index]!==null){
 					#取得 "maxHeight" 參數
 					$each["maxHeight"]=$conf["maxHeight"][$index];
 					}#if end
 				}#if end
 			#如果有設置 $conf["soucreId"] 參數
 			if(isset($conf["soucreId"][$index])){
 				#如果不是 null
 				if($conf["soucreId"][$index]!==null){
 					#取得 "soucreId" 參數
 					$each["soucreId"]=$conf["soucreId"][$index];
 					}#if end
 				}#if end
 			#函式說明:
 			#建立一個 iframe 框架
 			#回傳的結果：
 			#$result["status"],執行成功或失敗，成功為"true"；"false"為失敗。
 			#$result["functin"],字串,當前函數的名稱.
 			#$conf["name"],爲該 iframe 的名稱.
 			$conf["frame::createIframe"]["name"]=$each["name"];
 			#$conf["br"],字串,爲放置完該iframe後是否要換行,"true"爲要換行；"flase"爲不要換行。
 			$conf["frame::createIframe"]["br"]=$each["br"];
 			#可省略參數:
 			#如果存在 $each["class"]
 			if(isset($each["class"])){
 				#設置參數
 				#$conf["class"],字串陣列,爲該 iframe 要套用的css樣式類別名稱.
 				$conf["frame::createIframe"]["class"]=$each["class"];
 				}#if end
 			#如果存在 $each["scrolling"]
 			if(isset($each["scrolling"])){
 				#設置參數
 				#$conf["scrolling"],字串,是否要取消滾軸功能,"false"代表取消滾軸功能.
 				$conf["frame::createIframe"]["scrolling"]=$each["scrolling"];
 				}#if end
 			#如果存在 $each["width"]
 			if(isset($each["width"])){
 				#設置參數
 				#$conf["width"],字串,iframe的寬度.
 				$conf["frame::createIframe"]["width"]=$each["width"];
 				}#if end
 			#如果存在 $each["height"]
 			if(isset($each["height"])){
 				#設置參數
 				#$conf["height"],字串,iframe的寬度.
 				$conf["frame::createIframe"]["height"]=$each["height"];
 				}#if end
 			#如果存在 $each["minWidth"]
 			if(isset($each["minWidth"])){
 				#$conf["minWidth"],字串,最小的寬度.
 				$conf["frame::createIframe"]["minWidth"]=$each["minWidth"];
 				}#if end
 			#如果存在 $each["maxWidth"]
 			if(isset($each["maxWidth"])){
 				#$conf["maxWidth"],字串,最大寬度.
 				$conf["frame::createIframe"]["maxWidth"]=$each["minWidth"];
 				}#if end
 			#如果存在 $each["maxWidth"]
 			if(isset($each["maxWidth"])){
 				#$conf["minHeight"],字串,最小的高度.
 				$conf["frame::createIframe"]["minHeight"]=$each["minHeight"];
 				}#if end
 			#如果存在 $each["maxHeight"]
 			if(isset($each["maxHeight"])){
 				#$conf["maxHeight"],字串,最大的高度.
 				$conf["frame::createIframe"]["maxHeight"]=$each["maxHeight"];
 				}#if end
 			#如果存在 $each["soucreId"]
 			if(isset($each["soucreId"])){
 				#$conf["soucreId"],字串,如果要跟該function建立出來的ifame來動態調整高度為用戶看到的高度減去其高度,請給予來源iframe的id，此參數僅在$conf["br"]為"true"時生效.
 				$conf["frame::createIframe"]["soucreId"]=$each["soucreId"];
 				}#if end
 			$createIframe=frame::createIframe($conf["frame::createIframe"]);
 			unset($conf["frame::createIframe"]);
 			#如果建立失敗
 			if($createIframe["status"]==="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$checkResult;
 				#回傳結果
 				return $result;
 				}#if end
 			#串接iframe語法
 			$result["content"]=$result["content"].$createIframe["content"];
 			}#foreach end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function createMultiIframe end
 	/*
 	#函式說明:
 	#用div做成的frame.
 	#回傳結果:
 	#$result["status"],執行成功或失敗，成功為"true"；"false"為失敗.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function div(&$conf=array()){
 		#初始化要回傳的結果
 		$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
 		#檢查參數
 		#函式說明：
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$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("id");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("string");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="true";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("content","oneScreenSize","height");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","string","string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(array(),"false",null);
 		#$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
 		#涵式說明:
 		#<div>區塊,裡面可以指定css的class樣式,可以指定提示文字.
 		#$result["status"],字串,執行否正常,"true"代表正常,"false"代表不正常.
 		#$result["functin"],字串,當前函數的名稱.
 		#$result["error"],陣列,錯訊訊息.
 		$conf["css::divSection"]["id"]=$conf["id"];
 		#$conf["styleAttr"],字串陣列,給div區段要套用的style樣式屬性.
 		$conf["css::divSection"]["styleAttr"]=array("overflow-y");
 		#$conf["styleVal"],字串陣列,給div區段要套用的style樣式數值.
 		$conf["css::divSection"]["styleVal"]=array("auto");
 			#如果 "oneScreenSize" 為 "false"
 			if($conf["oneScreenSize"]==="false"){
 				#如果有設置 "height"
 				if(isset($conf["height"])){
 					#設置高度屬性
 					$conf["css::divSection"]["styleAttr"][]="height";
 					#設置高度屬性數值
 					$conf["css::divSection"]["styleVal"][]=$conf["height"];
 					}#if end
 				}#if end
 		#$conf["class"],字串,div區段要套用的css樣式.
 		#$conf["class"]="";
 		#$conf["title"],陣列,滑鼠移到上面時要顯示的內容,每個元素代表一列內容.
 		#$conf["title"]=array();
 		#$conf["oneScreenSize"],字串,div區塊是否要占一個螢幕的大小,預設為"false"不設定,"true"為設定成一個螢幕的大小.
 		$conf["css::divSection"]["oneScreenSize"]=$conf["oneScreenSize"];
 		#$conf["textAlignCenter"],字串,div區塊是否要置中,預設為$conf["oneScreenSize"]的值,"false"為不置中,"true"代表要置中.
 		#$conf["textAlignCenter"]="";
 		$divSection=css::divSection($conf["css::divSection"]);
 		unset($conf["css::divSection"]);
 		#如果建立div frame失敗
 		if($divSection["status"]==="false"){
 			#設置執行失敗
 			$result["status"]="false";
 			#設置執行錯誤訊息
 			$result["error"]=$divSection;
 			#回傳結果
 			return $result;
 			}#if end
 		#設置要回傳的語法
 		$result["content"]=$divSection["content"];
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function div end
 	/*
 	#函式說明:
 	#建立多個用div做成的frame.
 	#回傳結果:
 	#$result["status"],執行成功或失敗，成功為"true"；"false"為失敗.
 	#無.
 	#備註:
 	#無.
 	*/
 	public static function multiDiv(&$conf=array()){
 		#初始化要回傳的結果
 		$result=array();
 		#取得當前執行的函數名稱
 		$result["function"]=__FUNCTION__;
 		#初始化語法
 		$result["content"]="";
 		#如果沒有參數
 		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
 		#檢查參數
 		#函式說明：
 		#檢查必填與可省略的參數，可省略參數可指定預設要給與什麼數值內容。
 		#$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("id");
 		#$conf["mustBeFilledVariableType"],爲必填參數的變數陣列應該爲何種變數形態，形態爲陣列 例如: $conf["mustBeFilledVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["mustBeFilledVariableType"]=array("array");
 		#$conf["variableCheck::checkArguments"]["referenceVarKey"],字串,$conf參數後面的key值,用於移除不要的參考陣列.
 		$conf["variableCheck::checkArguments"]["referenceVarKey"]="variableCheck::checkArguments";
 		#可以省略的參數：
 		#$conf["canBeEmptyString"],必填變數內容如果是空字串就不能算是有設置的話，請設為"false",預設爲"true"。
 		#$conf["variableCheck::checkArguments"]["canBeEmptyString"]="true";
 		#$conf["skipableVariableName"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableName"] = array("id","account","password");
 		$conf["variableCheck::checkArguments"]["skipableVariableName"]=array("content","oneScreenSize","height","div2heightIsSeeHeightLessDiv1height");
 		#$conf["skipableVariableType"],爲可省略參數的變數名稱陣列，形態爲陣列變數，例如: $conf["skipableVariableType"] = array("string",integer,"double");
 		$conf["variableCheck::checkArguments"]["skipableVariableType"]=array("array","array","array","string");
 		#$conf["skipableVarDefaultValue"],字串陣列,每個不存在的可省略變數要初始化為什麼,null代表不指定,若預設值是必填參數之一，請將$conf["mustBeFilledVar"]改成"\$conf["\mustBeFilledVar\"]".
 		$conf["variableCheck::checkArguments"]["skipableVarDefaultValue"]=array(null,null,null,"false");
 		#$conf["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
 		#有幾個 $conf["id"] 就執行幾次
 		for($i=0;$i<count($conf["id"]);$i++){
 			#函式說明:
 			#用div做成的frame.
 			#回傳結果:
 			#$result["status"],執行成功或失敗，成功為"true"；"false"為失敗.
 			#$result["functin"],字串,當前函數的名稱.
 			#必填參數:
 			#$conf["id"],字串,div frame的id.
 			$conf["frame::div"]["id"]=$conf["id"][$i];
 			#可省略參數:
 			#$conf["content"],字串陣列,要放入到frame的內容,預設不使用.
 				#如果存在 "content"
 				if(isset($conf["content"])){
 					#如果存在 ["content"][$i]
 					if(isset($conf["content"][$i])){
 						#如果不為
 						if($conf["content"][$i]!==null){
 							#設置frame的內容
 							$conf["frame::div"]["content"]=$conf["content"][$i];
 							#var_dump($conf["frame::div"]["content"][$i]);
 							}#if end
 						}#if end
 					}#if end
 			#$conf["oneScreenSize"],字串,是否要為視窗的高度,"true"代表要;"false"代表不要。裡面的div元素也會變成跟視窗一樣高.內部的div要使用line-height:normal樣式來取消效果.
 				#如果存在 oneScreenSize
 				if(isset($conf["oneScreenSize"])){
 					#如果存在 ["oneScreenSize"][$i]
 					if(isset($conf["oneScreenSize"][$i])){
 						#如果不為
 						if($conf["oneScreenSize"][$i]!==null){
 							#設置frame的內容
 							$conf["frame::div"]["oneScreenSize"]=$conf["oneScreenSize"][$i];
 							}#if end
 						}#if end
 					}#if end
 			#$conf["height"],字串,frame的高度,若 "oneScreenSize" 設置為 "true",則忽略本參數.
 				#如果存在 height
 				if(isset($conf["height"])){
 					#如果存在 ["height"][$i]
 					if(isset($conf["height"][$i])){
 						#如果不為
 						if($conf["height"][$i]!==null){
 							#設置frame的內容
 							$conf["frame::div"]["height"]=$conf["height"][$i];
 							}#if end
 						}#if end
 					}#if end
 			$div=frame::div($conf["frame::div"]);
 			unset($conf["frame::div"]);
 			#如果建立失敗
 			if($div["status"]==="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$div;
 				#回傳結果
 				return $result;
 				}#if end
 			#串接 div frame
 			$result["content"]=$result["content"].$div["content"];
 			}#for end
 		#如果剛好有兩個div frame
 		if(count($conf["id"])===2 && $conf["div2heightIsSeeHeightLessDiv1height"]==="true"){
 			#函式說明:
 			#將要執行的script語法透過該函式執行(會在程式外層用<script></script>包起來).
 			#回傳結果:
 			#$result["status"],執行是否正常,"true"為正常,"false"為不正常.
 			#$result["error"],錯誤訊息陣列
 				window.changeDivFrameEleHeightToFullLessSource.changeSizeFrameId='".$conf["id"][0]."';
 				window.changeDivFrameEleHeightToFullLessSource.fixedSizeFrameId='".$conf["id"][1]."';
 			";
 			#可省略參數:
 			#$conf["onReady"],字串,是否要在網頁完全載入後再執行,"false"為不等載入完就先執行,預設為"true"要等載入完再執行.
 			$conf["javascript::toScript"]["onReady"]="false";
 			#$conf["globalJs"],字串陣列,為要放入<script>標籤的js全域變數.
 			#$conf["globalJs"]=array();
 			#$conf["jsFunciton"],字串陣列,為要放入<script>標籤的js函數.
 			#$conf["jsFunciton"]=array();
 			#參考資料:
 			#http://stackoverflow.com/questions/9899372/pure-javascript-equivalent-to-jquerys-ready-how-to-call-a-function-when-the
 			$toScript=javascript::toScript($conf["javascript::toScript"]);
 			unset($conf["javascript::toScript"]);
 			#如果建立script失敗
 			if($toScript["status"]==="false"){
 				#設置執行不正常
 				$result["status"]="false";
 				#設置錯誤訊息
 				$result["error"]=$toScript;
 				#回傳結果
 				return $result;
 				}#if end
 			#串接語法
 			$result["content"]=$result["content"].$toScript["content"];
 			}#if end
 		#設置執行正常
 		$result["status"]="true";
 		#回傳結果
 		return $result;
 		}#function multiDiv end
 	/*
 	#函式說明:
 	#透過javaScript建立iframe獲得更多控制權限.
 	#回傳結果:
 	#$result["status"],執行正常與否.
 	#無.
 	#備註:
 	#建構中...
 	*/
 	public static function js(&$conf){
 		}#fucntion js end
 	}#class frame end
 ?>

Subversion Repositories php-qbpwcf

(root)/trunk/usr/lib64/qbpwcf/frame.php – Rev 30 → 226