Tekst źródłowy strony Dodawanie JavaScript

{{SpisPoPrawej}}
== Dodawanie kodu JavaScript ==
Aby do dokumentu dodać kod JavaScript, trzeba najpierw pozyskać obiekt dokumentu. Aby tego dokonać, należy użyć poniższego kodu:
<source lang="php">$dokument =& JFactory::getDocument();</source> 
a następnie wykonać metodę JDocument::addScript().

Na przykład:

Aby korzystać z biblioteki javascript '''/media/system/js/przyklad.js''' w swoim szablonie lub innym miejscu, należy napisać: 
<source lang="php">
<?php
$dokument = &JFactory::getDocument();
$dokument->addScript( 'media/system/js/przyklad.js' );
?>
</source>

Jeśli skrypt dodajemy w pliku index.php szablonu, tzn np. ''/templates/nasz_szablon/index.php'', możemy napisać po prostu:
<source lang="php">
<?php
$this->addScript( 'media/system/js/przyklad.js' );
?>
</source>

==== Objaśnienie ====

Dzięki zastosowaniu powyższego kodu, w wynikowej stronie HTML między znacznikami <head> ... </head> zostanie umieszczony znacznik <script> wskazujący dokument z kodem JavaScript:

<source lang="html4strict">
<script type="text/javascript" src="/media/system/js/sample.js"></script>
</source>

== Dodanie bezpośrednie kodu JavaScript ==
Możemy również umieścić kod Javascript bezpośrednio w znaczniku <script> wewnątrz znacznika <head> HTML. Zrobimy to za pomocą metody JDocument::addScriptDeclaration()

<source lang="php">
// definicja kodu JavaScript
$skrypt = "alert('Jakiś komunikat')";
// dodanie kodu do dokumentu
$dokument -> addScriptDeclaration($skrypt);
</source>

== Informacja dodatkowa ==
Metody JDocument::addScript() oraz JDocument::addScriptDeclaration() mogą przyjąć również drugi opcjonalny parametr.
Parametr ten określi nam typ MIME skryptu, który chcemy dodać do dokumentu. Standardowym typem jest '''text/javascript'''. Możemy także zadeklarować, czyli dodać do naszego dokumentu pliki w innych językach skryptowych, np. tcl (text/tcl) oraz VBScript (text/vbscript).

Przykład:<source lang="php">$dokument->addScript('http://przyklad.com/scrypt.vb','text/vbscript');</source>


<noinclude>
[[Kategoria:Szablony 1.5]]
[[Kategoria:Projektanci]]
[[Kategoria:Programowanie]]
[[Kategoria:Programowanie komponentów]]

</noinclude>