* @link https://github.com/pradosoft/prado * @copyright Copyright © 2005-2016 The PRADO Group * @license https://github.com/pradosoft/prado/blob/master/COPYRIGHT * @package System.Web.UI.WebControls */ /** * 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}. * 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, * * * * * * 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 * control in the head section of your page to conform to the HTML standard. * If only CSS file URL is specified, you may place the control anywhere on your page * and the style element will be rendered in the right position. * * @author Wei Zhuo * @version : $ Tue Jul 4 04:38:16 EST 2006 $ * @package System.Web.UI.WebControls * @since 3.0.2 */ 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) { $this->setViewState('StyleSheetUrl', $value); } /** * @return string URL to the stylesheet file */ public function getStyleSheetUrl() { return $this->getViewState('StyleSheetUrl', ''); } /** * @return string media type of the CSS (such as 'print', 'screen', etc.). Defaults to empty, meaning the CSS applies to all media types. */ public function getMediaType() { return $this->getViewState('MediaType',''); } /** * @param string media type of the CSS (such as 'print', 'screen', etc.). If empty, it means the CSS applies to all media types. */ public function setMediaType($value) { $this->setViewState('MediaType',$value,''); } /** * Registers the stylesheet file and content to be rendered. * This method overrides the parent implementation and is invoked right before rendering. * @param mixed event parameter */ 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())!=='') $cs->registerStyleSheetFile($url,$url,$this->getMediaType()); } /** * Renders the control. * This method overrides the parent implementation and renders nothing. * @param ITextWriter writer */ public function render($writer) { if($this->getHasControls()) { $writer->write("\n"); } } }