Actions

Difference between revisions of "JDocument/addStyleSheet"

From Joomla! Documentation

(Added example of adding a stylesheet from within a template.)
m (See also: Framework => Platform)
 
(One intermediate revision by one user not shown)
Line 44: Line 44:
 
From a template, you can add a link to a style sheet using a relative URL, like this:
 
From a template, you can add a link to a style sheet using a relative URL, like this:
 
<source lang="php">
 
<source lang="php">
$doc =& JFactory::getDocument();
+
$this->addStyleSheet( 'templates/' . $this->template . '/css/mystylesheet.css' );
$doc->addStyleSheet( 'templates/' . $this->template . '/css/mystylesheet.css' );
+
 
</source>
 
</source>
 
The <code>$this</code> object will be an object of type [[JDocumentHTML]] when called from within a template.
 
The <code>$this</code> object will be an object of type [[JDocumentHTML]] when called from within a template.
 
===See also===
 
===See also===
* [http://api.joomla.org/Joomla-Framework/Document/JDocument.html#addStyleSheet JDocument->addStyleSheet on api.joomla.org]
+
* [http://api.joomla.org/Joomla-Platform/Document/JDocument.html#addStyleSheet JDocument->addStyleSheet on api.joomla.org]
 
* [[JDocument/addStyleDeclaration|JDocument->addStyleDeclaration]]
 
* [[JDocument/addStyleDeclaration|JDocument->addStyleDeclaration]]
 
* [http://www.w3.org/TR/REC-CSS2/media.html CSS2 Media Types]
 
* [http://www.w3.org/TR/REC-CSS2/media.html CSS2 Media Types]
 
<noinclude>[[Category:Development]][[Category:Framework]][[Category:JDocument]]</noinclude>
 
<noinclude>[[Category:Development]][[Category:Framework]][[Category:JDocument]]</noinclude>

Latest revision as of 03:24, 25 September 2013

Adds the definition of a linked external stylesheet to the document. Duplicates are ignored.

Contents

Syntax

void addStyleSheet( $url, $type, $media, $attribs )

where:

Argument Data type Description Default
$url string URL of stylesheet.
$type string MIME type of script. 'text/css'
$media string Media type that the stylesheet applies to. null
$attribs array Array of attributes.

Example 1

To add a link to some style sheet at a specific URL, you could use:

$doc =& JFactory::getDocument();
$doc->addStyleSheet( 'http://www.example.com/css/mystylesheet.css' );

How this is rendered depends on the document type. If the document type is HTML then this code will produce following link in the HTML HEAD section:

<link rel="stylesheet" href="http://www.example.com/css/mystylesheet.css" type="text/css" />

Example 2

From a template, you can add a link to a style sheet using a relative URL, like this:

$this->addStyleSheet( 'templates/' . $this->template . '/css/mystylesheet.css' );

The $this object will be an object of type JDocumentHTML when called from within a template.

See also