CContentDecorator
鍖 | system.web.widgets |
---|---|
缁ф壙 | class CContentDecorator » COutputProcessor » CFilterWidget » CWidget » CBaseController » CComponent |
瀹炵幇 | IFilter |
婧愯嚜 | 1.0 |
鐗堟湰 | $Id: CContentDecorator.php 3515 2011-12-28 12:29:24Z mdomba $ |
婧愮爜 | framework/web/widgets/CContentDecorator.php |
CContentDecorator 瑁呴グ鏀剧疆鍦ㄦ寚瀹氱殑view涓殑鍐呭銆
CContentDecorator 閫氬父鐢ㄤ簬瀹炵幇宓屽甯冨眬锛屼篃灏辨槸璇达紝涓涓竷灞 宓屽叆鍒板彟涓涓竷灞涔嬩腑銆CBaseController 瀹氫箟浜嗕竴瀵规柟 渚跨殑鏂规硶浠ヤ娇鐢–ContentDecorator锛
灞炴view鎸囧畾浜嗗皢鐢ㄤ簬瑁呴グ鍐呭鐨勮鍥剧殑鍚嶅瓧銆 鍦ㄨ鍥句腑锛岃瑁呴グ鐨勫唴瀹瑰彲浠ラ氳繃鍙橀噺
CContentDecorator 閫氬父鐢ㄤ簬瀹炵幇宓屽甯冨眬锛屼篃灏辨槸璇达紝涓涓竷灞 宓屽叆鍒板彟涓涓竷灞涔嬩腑銆CBaseController 瀹氫箟浜嗕竴瀵规柟 渚跨殑鏂规硶浠ヤ娇鐢–ContentDecorator锛
$this->beginContent('path/to/view'); // ... 闇瑕佽瑁呴グ鐨勫唴瀹 $this->endContent();
灞炴view鎸囧畾浜嗗皢鐢ㄤ簬瑁呴グ鍐呭鐨勮鍥剧殑鍚嶅瓧銆 鍦ㄨ鍥句腑锛岃瑁呴グ鐨勫唴瀹瑰彲浠ラ氳繃鍙橀噺
$content
杩涜璁块棶銆鍏叡灞炴
灞炴 | 绫诲瀷 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|---|
actionPrefix | string | actions鐨処D鐨勫墠缂銆 褰撳井浠跺湪CController::actions涓0鏄庝簡 鍔ㄤ綔鎻愪緵鑰咃紝鍙互涓哄叾鍔ㄤ綔鐨処D鎸囧畾鍓嶇紑浠ュ尯鍒 浜庡埆鐨勫井浠舵垨鎺у埗鍣ㄣ傚綋寰欢鐢ㄤ簬鎺у埗鍣 鐨勮鍥句腑鏃讹紝蹇呴』閰嶇疆鍚屾牱鐨勫墠缂銆 | CWidget |
controller | CController | 杩斿洖姝ゅ井浠舵墍灞炵殑鎺у埗鍣ㄣ | CWidget |
data | array | 琚彁鍙栧嚭鏉ヤ娇涔嬪彲浠ュ湪瑁呴グ鐨勮鍥句腑浣跨敤鐨勫彉閲忛泦 (name=>value)銆 | CContentDecorator |
id | string | 杩斿洖姝ゅ井浠剁殑ID銆傚鏋滈渶瑕佺殑璇濓紝灏嗙敓浜т竴涓柊鐨処D骞跺皢鍏惰繑鍥炪 | CWidget |
isFilter | boolean | 杩欎釜widget鏄惁浣滀负涓涓繃婊ゅ櫒浣跨敤銆 | CFilterWidget |
owner | CBaseController | 杩斿洖姝ゅ井浠剁殑鎵鏈夎呮垨鍒涘缓鑰呫 | CWidget |
skin | mixed | 寰欢浣跨敤鐨勭毊鑲ょ殑鍚嶇О銆傞粯璁や负鈥渄efault鈥濄 濡傛灉姝ゅ睘鎬ц缃负false锛屽井浠跺皢涓嶄細鏈夌毊鑲よ浣跨敤銆 | CWidget |
stopAction | boolean | 褰撹繖涓獁idget鐢ㄤ綔涓涓繃婊ゅ櫒鏃舵槸鍚﹀仠姝㈠姩浣滅殑鎵ц銆 姝ゅ睘鎬у簲褰撲粎鍦CWidget::init鏂规硶涓繘琛屾敼鍙樸 榛樿鍊兼槸false锛岃〃绀哄姩浣滃皢浼氳鎵ц銆 | CFilterWidget |
view | mixed | 鐢ㄤ簬瑁呴グ琚崟鑾风殑鍐呭鐨勮鍥剧殑鍚嶅瓧銆 濡傛灉姝ゅ睘鎬у间负null锛堥粯璁ゅ硷級锛岄偅涔堥粯璁ょ殑甯冨眬瑙嗗浘灏嗚浣跨敤銆 娉ㄦ剰锛氬鏋滃綋鍓嶆帶鍒跺櫒涓嶅睘浜庝换浣曟ā鍧楋紝榛樿甯冨眬鎸囧簲鐢ㄧ殑 default layout锛 濡傛灉褰撳墠鎺у埗鍣ㄥ睘浜庝竴涓ā鍧楋紝榛樿甯冨眬鎸囨墍灞炴ā鍧楃殑 default layout銆 | CContentDecorator |
viewPath | string | 杩斿洖鍖呭惈姝ゅ井浠舵墍闇鐨勮鍥炬枃浠剁殑璺緞銆 | CWidget |
鍏叡鏂规硶
鏂规硶 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|
__call() | 濡傛灉绫讳腑娌℃湁璋冪殑鏂规硶鍚嶏紝鍒欒皟鐢ㄨ繖涓柟娉曘 | CComponent |
__construct() | 鏋勯犲櫒銆 | CFilterWidget |
__get() | 杩斿洖涓涓睘鎬у笺佷竴涓簨浠跺鐞嗙▼搴忓垪琛ㄦ垨涓涓涓哄悕绉般 | CComponent |
__isset() | 妫鏌ヤ竴涓睘鎬ф槸鍚︿负null銆 | CComponent |
__set() | 璁剧疆涓涓粍浠剁殑灞炴у笺 | CComponent |
__unset() | 璁剧疆涓涓粍浠剁殑灞炴т负null銆 | CComponent |
actions() | 杩斿洖姝idget浣跨敤鐨勫姩浣滅殑鍒楄〃銆 | CWidget |
asa() | 杩斿洖杩欎釜鍚嶅瓧鐨勮涓哄璞° | CComponent |
attachBehavior() | 闄勫姞涓涓涓哄埌缁勪欢銆 | CComponent |
attachBehaviors() | 闄勫姞涓涓涓哄垪琛ㄥ埌缁勪欢銆 | CComponent |
attachEventHandler() | 涓轰簨浠堕檮鍔犱竴涓簨浠跺鐞嗙▼搴忋 | CComponent |
beginCache() | Begins fragment caching. | CBaseController |
beginClip() | Begins recording a clip. | CBaseController |
beginContent() | Begins the rendering of content that is to be decorated by the specified view. | CBaseController |
beginWidget() | Creates a widget and executes it. | CBaseController |
canGetProperty() | 纭畾灞炴ф槸鍚﹀彲璇汇 | CComponent |
canSetProperty() | 纭畾灞炴ф槸鍚﹀彲鍐欍 | CComponent |
createWidget() | Creates a widget and initializes it. | CBaseController |
detachBehavior() | 浠庣粍浠朵腑鍒嗙涓涓涓恒 | CComponent |
detachBehaviors() | 浠庣粍浠朵腑鍒嗙鎵鏈夎涓恒 | CComponent |
detachEventHandler() | 鍒嗙涓涓瓨鍦ㄧ殑浜嬩欢澶勭悊绋嬪簭銆 | CComponent |
disableBehavior() | 绂佺敤涓涓檮鍔犺涓恒 | CComponent |
disableBehaviors() | 绂佺敤缁勪欢闄勫姞鐨勬墍鏈夎涓恒 | CComponent |
enableBehavior() | 鍚敤涓涓檮鍔犺涓恒 | CComponent |
enableBehaviors() | 鍚敤缁勪欢闄勫姞鐨勬墍鏈夎涓恒 | CComponent |
endCache() | Ends fragment caching. | CBaseController |
endClip() | Ends recording a clip. | CBaseController |
endContent() | Ends the rendering of content. | CBaseController |
endWidget() | Ends the execution of the named widget. | CBaseController |
evaluateExpression() | 璁$畻涓涓狿HP琛ㄨ揪寮忥紝鎴栨牴鎹粍浠朵笂涓嬫枃鎵ц鍥炶皟銆 | CComponent |
filter() | 鎵ц杩囨护銆 | CFilterWidget |
getController() | 杩斿洖姝ゅ井浠舵墍灞炵殑鎺у埗鍣ㄣ | CWidget |
getEventHandlers() | 杩斿洖涓涓簨浠剁殑闄勫姞澶勭悊绋嬪簭鍒楄〃銆 | CComponent |
getId() | 杩斿洖姝ゅ井浠剁殑ID銆傚鏋滈渶瑕佺殑璇濓紝灏嗙敓浜т竴涓柊鐨処D骞跺皢鍏惰繑鍥炪 | CWidget |
getIsFilter() | 妫鏌ヨ繖涓獁idget鏄惁浣滀负涓涓繃婊ゅ櫒浣跨敤銆 | CFilterWidget |
getOwner() | 杩斿洖姝ゅ井浠剁殑鎵鏈夎呮垨鍒涘缓鑰呫 | CWidget |
getViewFile() | 鏍规嵁瑙嗗浘鍚嶆煡鎵捐鍥炬枃浠躲 | CWidget |
getViewPath() | 杩斿洖鍖呭惈姝ゅ井浠舵墍闇鐨勮鍥炬枃浠剁殑璺緞銆 | CWidget |
hasEvent() | 纭畾涓涓簨浠舵槸鍚﹀畾涔夈 | CComponent |
hasEventHandler() | 妫鏌ヤ簨浠舵槸鍚︽湁闄勫姞鐨勫鐞嗙▼搴忋 | CComponent |
hasProperty() | 纭畾灞炴ф槸鍚﹁瀹氫箟銆 | CComponent |
init() | 鍒濆鍖栨灏忕墿浠躲 | COutputProcessor |
onProcessOutput() | 褰撹幏鍙栧埌杈撳嚭鏃舵縺鍙戙 | COutputProcessor |
processOutput() | 澶勭悊宸叉崟鑾风殑杈撳嚭銆 | CContentDecorator |
raiseEvent() | 鍙戣捣涓涓簨浠躲 | CComponent |
render() | 娓叉煋涓涓鍥俱 | CWidget |
renderFile() | Renders a view file. | CBaseController |
renderInternal() | Renders a view file. | CBaseController |
run() | 杩愯姝ゅ皬鐗╀欢銆 | COutputProcessor |
setId() | 璁剧疆姝ゅ井浠剁殑ID銆 | CWidget |
widget() | Creates a widget and executes it. | CBaseController |
灞炴ц缁
data
灞炴
public array $data;
琚彁鍙栧嚭鏉ヤ娇涔嬪彲浠ュ湪瑁呴グ鐨勮鍥句腑浣跨敤鐨勫彉閲忛泦 (name=>value)銆
view
灞炴
public mixed $view;
鐢ㄤ簬瑁呴グ琚崟鑾风殑鍐呭鐨勮鍥剧殑鍚嶅瓧銆 濡傛灉姝ゅ睘鎬у间负null锛堥粯璁ゅ硷級锛岄偅涔堥粯璁ょ殑甯冨眬瑙嗗浘灏嗚浣跨敤銆 娉ㄦ剰锛氬鏋滃綋鍓嶆帶鍒跺櫒涓嶅睘浜庝换浣曟ā鍧楋紝榛樿甯冨眬鎸囧簲鐢ㄧ殑 default layout锛 濡傛灉褰撳墠鎺у埗鍣ㄥ睘浜庝竴涓ā鍧楋紝榛樿甯冨眬鎸囨墍灞炴ā鍧楃殑 default layout銆
鏂规硶璇︾粏
decorate()
鏂规硶
protected string decorate(string $content)
| ||
$content | string | 闇瑕佽瑁呴グ鐨勫唴瀹 |
{return} | string | 宸茶楗拌繃鐨勫唴瀹 |
婧愮爜锛 framework/web/widgets/CContentDecorator.php#66 (鏄剧ず)
protected function decorate($content)
{
$owner=$this->getOwner();
if($this->view===null)
$viewFile=Yii::app()->getController()->getLayoutFile(null);
else
$viewFile=$owner->getViewFile($this->view);
if($viewFile!==false)
{
$data=$this->data;
$data['content']=$content;
return $owner->renderFile($viewFile,$data,true);
}
else
return $content;
}
閫氳繃娓叉煋涓涓鍥撅紝骞跺皢鍐呭宓屽叆鍏朵腑鏉ヨ楗板唴瀹广
宓屽叆鐨勫唴瀹瑰彲浠ュ湪瑙嗗浘涓氳繃鍙橀噺$content
杩涜璁块棶銆
琚楗扮殑鍐呭灏嗙洿鎺ユ樉绀哄嚭鏉ャ
processOutput()
鏂规硶
public void processOutput(string $output)
| ||
$output | string | 闇瑕佽澶勭悊鐨勬崟鑾峰埌鐨勮緭鍑恒 |
婧愮爜锛 framework/web/widgets/CContentDecorator.php#53 (鏄剧ず)
public function processOutput($output)
{
$output=$this->decorate($output);
parent::processOutput($output);
}
澶勭悊宸叉崟鑾风殑杈撳嚭銆 姝ゆ柟娉曚娇鐢ㄦ寚瀹氱殑view鏉ヨ楗拌緭鍑恒