|
|
@@ -1,56 +1,89 @@
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
-<!-- EN-Revision: 19432 -->
|
|
|
+<!-- EN-Revision: 19437 -->
|
|
|
<!-- Reviewed: no -->
|
|
|
<sect3 id="zend.view.helpers.initial.headscript">
|
|
|
<title>HeadScript Helfer</title>
|
|
|
|
|
|
<para>
|
|
|
- Das HTML <code><script></code> Element wird verwendet um entweder Clientseitige
|
|
|
- Skriptelemente Inline zu ermöglichen oder um eine entfernte Ressource zu verlinken die
|
|
|
- Clientseitigen Skriptcode enthält. Der <code>HeadScript</code> Helfer erlaubt es beides zu
|
|
|
- Managen.
|
|
|
+ Das HTML <emphasis><script></emphasis> Element wird verwendet um entweder
|
|
|
+ Clientseitige Skriptelemente Inline zu ermöglichen oder um eine entfernte Ressource zu
|
|
|
+ verlinken die Clientseitigen Skriptcode enthält. Der <classname>HeadScript</classname>
|
|
|
+ Helfer erlaubt es beides zu Managen.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Der <code>HeadScript</code> Helfer unterstützt die folgenden Methoden für das Setzen und
|
|
|
- Hinzufügen von Skripten:
|
|
|
+ Der <classname>HeadScript</classname> Helfer unterstützt die folgenden Methoden für das
|
|
|
+ Setzen und Hinzufügen von Skripten:
|
|
|
</para>
|
|
|
|
|
|
<itemizedlist>
|
|
|
- <listitem><para><code>appendFile($src, $type = 'text/javascript',
|
|
|
- $attrs = array())</code></para></listitem>
|
|
|
- <listitem><para><code>offsetSetFile($index, $src, $type = 'text/javascript',
|
|
|
- $attrs = array())</code></para></listitem>
|
|
|
- <listitem><para><code>prependFile($src, $type = 'text/javascript',
|
|
|
- $attrs = array())</code></para></listitem>
|
|
|
- <listitem><para><code>setFile($src, $type = 'text/javascript',
|
|
|
- $attrs = array())</code></para></listitem>
|
|
|
- <listitem><para><code>appendScript($script, $type = 'text/javascript',
|
|
|
- $attrs = array())</code></para></listitem>
|
|
|
- <listitem><para><code>offsetSetScript($index, $script, $type = 'text/javascript',
|
|
|
- $attrs = array())</code></para></listitem>
|
|
|
- <listitem><para><code>prependScript($script, $type = 'text/javascript',
|
|
|
- $attrs = array())</code></para></listitem>
|
|
|
- <listitem><para><code>setScript($script, $type = 'text/javascript',
|
|
|
- $attrs = array())</code></para></listitem>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>appendFile($src, $type = 'text/javascript', $attrs = array())</code>
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>offsetSetFile($index, $src, $type = 'text/javascript', $attrs =
|
|
|
+ array())</code>
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>prependFile($src, $type = 'text/javascript', $attrs = array())</code>
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>setFile($src, $type = 'text/javascript', $attrs = array())</code>
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>appendScript($script, $type = 'text/javascript', $attrs = array())</code>
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>offsetSetScript($index, $script, $type = 'text/javascript', $attrs =
|
|
|
+ array())</code>
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>prependScript($script, $type = 'text/javascript', $attrs = array())</code>
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ <code>setScript($script, $type = 'text/javascript', $attrs = array())</code>
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
</itemizedlist>
|
|
|
|
|
|
<para>
|
|
|
- Im Falle der <code>*File()</code> Methoden ist <varname>$src</varname> der entfernte Ort des
|
|
|
- Skriptes das geladen werden soll; das ist üblicherweise in der Form einer
|
|
|
- <acronym>URL</acronym> oder eines Pfades. Für die <code>*Script()</code> Methoden sind
|
|
|
- <varname>$script</varname> die clientseitigen Skript Direktiven die in diesem Element
|
|
|
- verwendet werden sollen.
|
|
|
+ Im Falle der *<methodname>File()</methodname> Methoden ist <varname>$src</varname> der
|
|
|
+ entfernte Ort des Skriptes das geladen werden soll; das ist üblicherweise in der Form einer
|
|
|
+ <acronym>URL</acronym> oder eines Pfades. Für die *<methodname>Script()</methodname>
|
|
|
+ Methoden sind <varname>$script</varname> die clientseitigen Skript Direktiven die in diesem
|
|
|
+ Element verwendet werden sollen.
|
|
|
</para>
|
|
|
|
|
|
<note>
|
|
|
<title>Abhängige Kommentare setzen</title>
|
|
|
|
|
|
<para>
|
|
|
- <code>HeadScript</code> erlaubt es ein Script Tag in abhängige Kommentare zu setzen, das
|
|
|
- es erlaubt es vor speziellen Browsern zu verstecken. Um abhängige Tags zu setzen, muß
|
|
|
- der abhängige Wert als Teil des <varname>$attrs</varname> Parameters im Methodenaufruf
|
|
|
- übergeben werden.
|
|
|
+ <classname>HeadScript</classname> erlaubt es ein Script Tag in abhängige Kommentare zu
|
|
|
+ setzen, das es erlaubt es vor speziellen Browsern zu verstecken. Um abhängige Tags zu
|
|
|
+ setzen, muß der abhängige Wert als Teil des <varname>$attrs</varname> Parameters im
|
|
|
+ Methodenaufruf übergeben werden.
|
|
|
</para>
|
|
|
|
|
|
<example id="zend.view.helpers.initial.headscript.conditional">
|
|
|
@@ -68,9 +101,9 @@ $this->headScript()->appendFile(
|
|
|
</note>
|
|
|
|
|
|
<para>
|
|
|
- <code>HeadScript</code> erlaubt auch das Erfassen von Skripten; das kann nützlich sein wenn
|
|
|
- man ein Clientseitiges Skript programmtechnisch erstellen und es dann woanders platzieren
|
|
|
- will. Seine Verwendung wird in einem Beispiel anbei gezeigt.
|
|
|
+ <classname>HeadScript</classname> erlaubt auch das Erfassen von Skripten; das kann nützlich
|
|
|
+ sein wenn man ein Clientseitiges Skript programmtechnisch erstellen und es dann woanders
|
|
|
+ platzieren will. Seine Verwendung wird in einem Beispiel anbei gezeigt.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -83,17 +116,17 @@ $this->headScript()->appendFile(
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- <code>HeadScript</code> überschreibt <methodname>append()</methodname>,
|
|
|
+ <classname>HeadScript</classname> überschreibt <methodname>append()</methodname>,
|
|
|
<methodname>offsetSet()</methodname>, <methodname>prepend()</methodname>, und
|
|
|
<methodname>set()</methodname> um um die Verwendung der speziellen Methoden wie vorher
|
|
|
- gezeigt zu erzwingen. Intern wird jedes Element als <code>stdClass</code> Token gespeichert,
|
|
|
- welches später mit Hilfe der <methodname>itemToString()</methodname> Methode serialisiert
|
|
|
- wird. Das erlaubt es Prüfungen an den Elementen im Stack vorzunehmen, und diese Elemente
|
|
|
- optional zu ändern, einfach durch das Modifizieren des zurückgegebenen Objektes.
|
|
|
+ gezeigt zu erzwingen. Intern wird jedes Element als <property>stdClass</property> Token
|
|
|
+ gespeichert, welches später mit Hilfe der <methodname>itemToString()</methodname> Methode
|
|
|
+ serialisiert wird. Das erlaubt es Prüfungen an den Elementen im Stack vorzunehmen, und diese
|
|
|
+ Elemente optional zu ändern, einfach durch das Modifizieren des zurückgegebenen Objektes.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Der <code>HeadScript</code> Helfer ist eine konkrete Implementation des
|
|
|
+ Der <classname>HeadScript</classname> Helfer ist eine konkrete Implementation des
|
|
|
<link linkend="zend.view.helpers.initial.placeholder">Platzhalter Helfers</link>.
|
|
|
</para>
|
|
|
|
|
|
@@ -101,10 +134,10 @@ $this->headScript()->appendFile(
|
|
|
<title>InlineScript für HTML Body Skripte verwenden</title>
|
|
|
|
|
|
<para>
|
|
|
- <code>HeadScript</code>'s Schwester Helfer,
|
|
|
+ <classname>HeadScript</classname>'s Schwester Helfer,
|
|
|
<link linkend="zend.view.helpers.initial.inlinescript">InlineScript</link>, sollte
|
|
|
- verwendet werden wenn man Inline Skripte im HTML <code>body</code> inkludieren will. Die
|
|
|
- Platzierung von Skripten am Ende des Dokuments ist eine gängige Praxis für die
|
|
|
+ verwendet werden wenn man Inline Skripte im HTML <emphasis>body</emphasis> inkludieren
|
|
|
+ will. Die Platzierung von Skripten am Ende des Dokuments ist eine gängige Praxis für die
|
|
|
schnellere Auslieferung von Seiten, speziell wenn 3rd Party Analyse Skripte verwendet
|
|
|
werden.
|
|
|
</para>
|
|
|
@@ -114,10 +147,11 @@ $this->headScript()->appendFile(
|
|
|
<title>Andere Attribute werden stanadrdmäßig ausgeschaltet</title>
|
|
|
|
|
|
<para>
|
|
|
- Standardmäßig wird <code>HeadScript</code> nur <code><script></code> Attribute
|
|
|
- darstellen die von W3C abgesegnet sind. Diese beinhalten 'type', 'charset', 'defer',
|
|
|
- 'language', und 'src'. Trotzdem, verwenden einige Javascript Frameworks, vorallem
|
|
|
- <ulink url="http://www.dojotoolkit.org/">Dojo</ulink>, eigene Attribute um Verhalten
|
|
|
+ Standardmäßig wird <classname>HeadScript</classname> nur
|
|
|
+ <emphasis><script></emphasis> Attribute darstellen die von W3C abgesegnet sind.
|
|
|
+ Diese beinhalten 'type', 'charset', 'defer', 'language', und 'src'. Trotzdem, verwenden
|
|
|
+ einige Javascript Frameworks, vorallem <ulink
|
|
|
+ url="http://www.dojotoolkit.org/">Dojo</ulink>, eigene Attribute um Verhalten
|
|
|
zu ändern. Um solche Attribute zu erlauben, können diese über die
|
|
|
<methodname>setAllowArbitraryAttributes()</methodname> Methode eingeschaltet werden:
|
|
|
</para>
|
|
|
@@ -179,7 +213,7 @@ $this->headScript()->prependFile('/js/prototype.js');
|
|
|
Manchmal mit ein Clientseitiges Skript programmtechnisch erstellt werden. Wärend man
|
|
|
Strings zusammenhängen, Heredocs und ähnliches verwenden könnte, ist es oft einfacher
|
|
|
nur das Skript zu erstellen und in <acronym>PHP</acronym> Tags einzubetten.
|
|
|
- <code>HeadScript</code> lässt das zu, und erfasst es in den Stack:
|
|
|
+ <classname>HeadScript</classname> lässt das zu, und erfasst es in den Stack:
|
|
|
</para>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
@@ -212,9 +246,10 @@ $('foo_form').action = action;
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- Wenn irgendwelche zusätzlichen Attribute für das <code><script></code> Tag
|
|
|
- spezifiziert werden sollen, müssen diese in einem Array als drittes Argument an
|
|
|
- <methodname>captureStart()</methodname> übergeben werden.
|
|
|
+ Wenn irgendwelche zusätzlichen Attribute für das
|
|
|
+ <emphasis><script></emphasis> Tag spezifiziert werden sollen, müssen diese
|
|
|
+ in einem Array als drittes Argument an <methodname>captureStart()</methodname>
|
|
|
+ übergeben werden.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|