Merge pull request #579 from pradosoft/fix_562

Added TClientStyleSheet::PradoStyles

2 files changed, 125 insertions, 3 deletions

diff --git a/framework/Web/UI/TClientScriptManager.php b/framework/Web/UI/TClientScriptManager.php
index 5c4d9388..d5335b37 100644
--- a/framework/Web/UI/TClientScriptManager.php
+++ b/framework/Web/UI/TClientScriptManager.php
@@ -31,6 +31,10 @@ class TClientScriptManager extends TApplicationComponent
 	 */
 	const PACKAGES_FILE='Web/Javascripts/packages.php';
 	/**
+	 * file containing css packages and their cross dependencies
+	 */
+	const CSS_PACKAGES_FILE='Web/Javascripts/css-packages.php';
+	/**
 	 * @var TPage page who owns this manager
 	 */
 	private $_page;
@@ -80,12 +84,27 @@ class TClientScriptManager extends TApplicationComponent
 	 * @var array
 	 */
 	private static $_pradoPackages;
+	/**
+	 * @var array registered PRADO style libraries
+	 */
+	private $_registeredPradoStyles=array();
+	/**
+	 * Client-side style library dependencies, loads from PACKAGES_FILE;
+	 * @var array
+	 */
+	private static $_pradoStyles;
+	/**
+	 * Client-side style library packages, loads from CSS_PACKAGES_FILE;
+	 * @var array
+	 */
+	private static $_pradoStylePackages;
 
 	private $_renderedHiddenFields;
 
 	private $_renderedScriptFiles=array();
 
 	private $_expandedPradoScripts;
+	private $_expandedPradoStyles;
 
 	/**
 	 * Constructor.
@@ -214,7 +233,7 @@ class TClientScriptManager extends TApplicationComponent
 	}
 
 	/**
-	 * @param string javascript package path.
+	 * @param string javascript or css package path.
 	 * @return array tuple($path,$url).
 	 */
 	protected function getPackagePathUrl($base)
@@ -348,6 +367,67 @@ class TClientScriptManager extends TApplicationComponent
 	}
 
 	/**
+	 * Registers Prado style by library name. See "Web/Javascripts/packages.php"
+	 * for library names.
+	 * @param string style library name.
+	 */
+	public function registerPradoStyle($name)
+	{
+		$this->registerPradoStyleInternal($name);
+		$params=func_get_args();
+		$this->_page->registerCachingAction('Page.ClientScript','registerPradoStyle',$params);
+	}
+
+	/**
+	 * Registers a Prado style library to be loaded.
+	 */
+	protected function registerPradoStyleInternal($name)
+	{
+		// $this->checkIfNotInRender();
+		if(!isset($this->_registeredPradoStyles[$name]))
+		{
+			$base = $this->getPradoScriptAssetUrl();
+
+			if(self::$_pradoStyles === null)
+			{
+				$packageFile = Prado::getFrameworkPath().DIRECTORY_SEPARATOR.self::CSS_PACKAGES_FILE;
+				list($packages,$deps)= include($packageFile);
+				self::$_pradoStyles = $deps;
+				self::$_pradoStylePackages = $packages;
+			}
+
+			if (isset(self::$_pradoStyles[$name]))
+				$this->_registeredPradoStyles[$name]=true;
+			else
+				throw new TInvalidOperationException('csmanager_pradostyle_invalid',$name);
+
+			if(($packages=array_keys($this->_registeredPradoStyles))!==array())
+			{
+				$base = Prado::getFrameworkPath().DIRECTORY_SEPARATOR.self::SCRIPT_PATH;
+				list($path,$baseUrl)=$this->getPackagePathUrl($base);
+				$packagesUrl=array();
+				$isDebug=$this->getApplication()->getMode()===TApplicationMode::Debug;
+				foreach ($packages as $p)
+				{
+					foreach (self::$_pradoStyles[$p] as $dep)
+					{
+						foreach (self::$_pradoStylePackages[$dep] as $style)
+						if (!isset($this->_expandedPradoStyles[$style]))
+						{
+							$this->_expandedPradoStyles[$style] = true;
+							// TODO minify css?
+							if (!in_array($url=$baseUrl.'/'.$style,$packagesUrl))
+								$packagesUrl[]=$url;
+						}
+					}
+				}
+				foreach($packagesUrl as $url)
+					$this->registerStyleSheetFile($url,$url);
+			}
+		}
+	}
+
+	/**
 	 * Registers a CSS file to be rendered in the page head
 	 *
 	 * The CSS files in themes are registered in {@link OnPreRenderComplete onPreRenderComplete} if you want to override
diff --git a/framework/Web/UI/WebControls/TStyleSheet.php b/framework/Web/UI/WebControls/TStyleSheet.php
index 1964610f..021b9117 100644
--- a/framework/Web/UI/WebControls/TStyleSheet.php
+++ b/framework/Web/UI/WebControls/TStyleSheet.php
@@ -13,7 +13,17 @@
  * TStyleSheet class.
  *
  * TStyleSheet represents the link to a stylesheet file and/or a piece of
- * stylesheet code. To specify the link to a CSS file, set {@link setStyleSheetUrl StyleSheetUrl}.
+ * stylesheet code. To specify the link to a CSS file, set {@link setStyleSheetUrl
+ * StyleSheetUrl}.
+ * Since Prado 3.3.1, it' possible to import css libraries bundled with
+ * Prado from template via the {@link setPradoStyles PradoStyles} property.
+ * Multiple Prado libraries can be specified using comma delimited string of the
+ * css library to include on the page. For example,
+ *
+ * <code>
+ * <com:TStyleSheet PradoStyles="bootstrap, jquery.ui.progressbar" />
+ * </code>
+ *
  * The child rendering result of TStyleSheet is treated as CSS code and
  * is rendered within an appropriate style HTML element.
  * Therefore, if the child content is not empty, you should place the TStyleSheet
@@ -29,6 +39,29 @@
 class TStyleSheet extends TControl
 {
 	/**
+	 * @return string comma delimited list of css libraries to include
+	 * on the page.
+	 * @since 3.3.1
+	 */
+	public function getPradoStyles()
+	{
+		return $this->getViewState('PradoStyles', '');
+	}
+
+	/**
+	 * Include css library to the current page. The current supported
+	 * libraries are: "jquery-ui", "bootstrap" and all the split
+	 * jquery.ui.componentname libraries. 
+	 *
+	 * @param string comma delimited list of css libraries to include.
+	 * @since 3.3.1
+	 */
+	public function setPradoStyles($value)
+	{
+		$this->setViewState('PradoStyles', $value, '');
+	}
+
+	/**
 	 * @param string URL to the stylesheet file
 	 */
 	public function setStyleSheetUrl($value)
@@ -67,8 +100,17 @@ class TStyleSheet extends TControl
 	 */
 	public function onPreRender($param)
 	{
+		$cs = $this->getPage()->getClientScript();
+
+		$styles = preg_split('/,|\s+/', $this->getPradoStyles());
+		foreach($styles as $style)
+		{
+			if(($style = trim($style))!=='')
+				$cs->registerPradoStyle($style);
+		}
+
 		if(($url=$this->getStyleSheetUrl())!=='')
-			$this->getPage()->getClientScript()->registerStyleSheetFile($url,$url,$this->getMediaType());
+			$cs->registerStyleSheetFile($url,$url,$this->getMediaType());
 	}
 
 	/**