embed | NN 3 IE 4 DOM nicht zutreffend | |||||||||
Das embed-Objekt spiegelt das embed-Element wider. Obwohl das embed-Objekt in neueren Browsergenerationen mehr und mehr durch das object-Element verdrängt wird, können Skripts in Browsern wie Navigator 3, Navigator 4 und IE 4/Windows Medienwiedergabegeräte steuern, die ausgelöst durch den Zeiger des embed-Elements, der auf eine Mediendatei auf dem Server weist, in eine Seite geladen werden. Die durch den Player offen gelegten Eigenschaften und Methoden werden durch das embed-Objekt weitergegeben, sodass Skripts das embed-Objekt so behandeln, als sei die Liste seiner skriptfähigen Funktionen erweitert worden. Die hier aufgeführten Eigenschaften werden vom Elementobjekt und nicht von einem externen Controller für die Skripts offen gelegt. |
||||||||||
Beachten Sie, dass IE 5 für Macintosh das embed-Objekt mehr wie das object-Objekt behandelt und Eigenschaften offen legt, die mehr zu einem object- oder applet- als zu einem embed-Objekt passen würden. Dies hat allerdings kaum Auswirkungen, da IE/Mac bis einschließlich Version 5.1 keine Kommunikation zwischen Skripts und externen Playern oder Controllern zulässt. |
||||||||||
HTML-Äquivalent | ||||||||||
<embed> |
||||||||||
Objektmodellreferenz | ||||||||||
[window.]document.getElementById("elementID")
[window.]document.embeds[i]
|
||||||||||
Objektspezifische Eigenschaften | ||||||||||
|
||||||||||
Objektspezifische Methoden | ||||||||||
Keine. |
||||||||||
Objektspezifische Ereignisbehandlungsroutineneigenschaften | ||||||||||
Keine. |
accessKey | NN nicht zutreffend IE 4 DOM 1 |
Lesen/Schreiben | |
Dies ist eine einzelne Buchstabentaste, durch die ein Element (in manchen Browsern) den Fokus erhält oder ein Formularsteuerelement bzw. eine Link-Aktion aktiviert wird. Der Browser und das Betriebssystem bestimmen, ob zusammen mit der Buchstabentaste eine Zusatztaste (wie Strg, Alt oder Befehl) gedrückt werden muss, damit der Link aktiviert wird. In IE für Windows ab Version 5 und Netscape 6 muss gleichzeitig die Alt-Taste gedrückt werden, und bei der Buchstabentaste wird nicht zwischen Groß- und Kleinschreibung unterschieden. In IE für den Macintosh ab Version 5 und der Macintosh-Version von Netscape 6 funktioniert die Zugriffstaste nur in Verbindung mit der Ctrl-Taste. |
|
Obwohl sie hier als gemeinsame Eigenschaft aufgeführt, wird sie streng genommen nicht in allen Implementierungen unterstützt. Netscape 6 (per W3C-DOM) erkennt diese Eigenschaft nur in Verbindung mit den folgenden Elementen: a, area, button, input, label, legend und textarea, IE 4 darüber hinaus für applet, body, div, embed, isindex, marquee, object, select, span, table und td (nicht jedoch für label und legend). IE 5 erkennt dieses Attribut in Verbindung mit allen darstellbaren Elementen, weist in diesem Zusammenhang jedoch eine Besonderheit auf: Außer bei input und anderen formularbezogenen Elementen müssen Sie einem Element für IE ab Version 5 außerdem ein tabindex-Attribut mit einem beliebigen Wert oder einen beliebigen tabIndex-Eigenschaftswert zuweisen, damit der Benutzer in der Lage ist, ihm mithilfe der Schnellzugriffstaste den Fokus zu übergeben. In Netscape 7 hat eine Änderung des Eigenschaftswerts in einem Skript bisher keine Auswirkung auf das Verhalten der Benutzeroberfläche. |
|
Beispiel | |
document.links[3].accessKey = "n"; |
|
Wert | |
Einzelnes alphanumerisches Zeichen (oder ein Satzzeichen). |
|
Standardwert | |
Leere Zeichenfolge. |
align | NN 6 IE 5(Mac) DOM nicht zutreffend |
Lesen/Schreiben | |
Definiert die Ausrichtung des Elements innerhalb seines umgebenden Containers. Informationen zu den verschiedenen Bedeutungen der einzelnen Werte für diese Eigenschaft finden Sie in Abschnitt 8.1.5 am Anfang von Kapitel 8. |
|
Beispiel | |
document.getElementById("audioPlayer").align = "center"; |
|
Wert | |
Eine der folgenden Ausrichtungskonstanten: absbottom | absmiddle | baseline | bottom | left | middle | right | texttop | top. |
|
Standardwert | |
left |
blur( ) | NN 2 IE 3 DOM 1 |
Entfernt den Fokus vom aktuellen Objekt und löst damit das onblur-Ereignis des Objekts aus. Beachten Sie, dass die Palette der Elemente, die Fokus und Blur (Ereignisse und Methoden) unterstützen, in allen Browsern mit Ausnahme der neuesten Versionen von IE eingeschränkt ist (weitere Informationen finden Sie in der Abhandlung des Attributs tabindex in Kapitel 8). Am zuverlässigsten im Hinblick auf die Rückwärtskompatibilität funktioniert die Methode blur( ) in Verbindung mit eindeutig fokusfähigen Elementen wie Text-input- und textarea-Elementen. Die Zuweisung des Attributs onfocus="this.blur( );" zu einem Text-input-Element ist beispielsweise eine simple, aber effektive und rückwärtskompatible Möglichkeit, ein Feld für Browser zu deaktivieren, die keine eigene Funktion zum Deaktivieren von Elementen aufweisen. |
|
Verwenden Sie die Methoden blur( ) und focus( ) vorsichtig in ein- und derselben Seite, da hierbei durch eingeblendete Warndialogfelder versehentlich Blur- und Fokus-Endlosschleifen ausgelöst werden können. Denken Sie außerdem daran, dass der Aufruf der Methode blur( ) eines Objekts bewirkt, dass ein anderes Objekt (möglicherweise das window-Objekt) ein onfocus-Ereignis empfängt. |
|
Parameter | |
Keine. |
|
Zurückgegebener Wert | |
Keiner. |
clientHeight, clientWidth | NN 7 IE 4 DOM nicht zutreffend |
Schreibgeschützt | |
Geben die Höhe und Breite des Elementinhalts zurück, jedoch mit geringfügigen Abweichungen hinsichtlich der Elementauffüllung bei den verschiedenen Betriebssystemversionen von IE und den verschiedenen von der DOCTYPE-Deklaration gesteuerten Kompatibilitätsmodi. In IE für Macintosh nicht für alle Elementtypen verfügbar. Bei Netscape 7 sind die Werte Null, es sei denn, der Inhalt eines Elements ragt über den sichtbaren Bereich hinaus, in welchem Fall die Werte die Abmessungen des sichtbaren Bereichs (beim Element document.body beispielsweise den Inhaltsbereich des Browserfensters) angeben. Weitere Informationen finden Sie in Abschnitt 9.2 am Anfang dieses Kapitels. |
|
Beispiel | |
var midHeight = document.body.clientHeight/2; |
|
Wert | |
Ein Pixelwert als ganze Zahl. |
|
Standardwert | |
0 |
clientLeft, clientTop | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Schreibgeschützt | |
Geben die linke und obere Koordinate des Elementinhalts innerhalb des Rechtecks bereit, das die Elementauffüllung enthält, jedoch mit geringfügigen Abweichungen bei den verschiedenen Betriebssystemversionen von IE. In IE für Macintosh nicht für alle Elementtypen verfügbar. Weitere Informationen finden Sie in Abschnitt 9.2 am Anfang dieses Kapitels. Hilfreichere Informationen zur Positionierung von Inline-Elementen lassen sich im Allgemeinen über die Eigenschaften offsetLeft und offsetTop ermitteln (einschließlich Netscape 6). Bei CSS-positionierten Elementen verwenden Sie style-Objekteigenschaften wie left und top sowie (nur in IE) pixelLeft und pixelTop (auch zum Ändern der Position eines Elements). |
|
Wert | |
Ein Pixelwert als ganze Zahl. |
|
Standardwert | |
0 |
focus( ) | NN 2 IE 3 DOM 1 |
Übergibt den Fokus an das aktuelle Objekt und löst damit das onfocus-Ereignis des Objekts aus. Beachten Sie, dass die Palette der Elemente, die Fokus und Blur (Ereignisse und Methoden) unterstützen, in allen Browsern mit Ausnahme der neuesten Versionen von IE eingeschränkt ist (weitere Informationen finden Sie in der Abhandlung des Attributs tabindex in Kapitel 8). Am zuverlässigsten im Hinblick auf die Rückwärtskompatibilität funktioniert die Methode focus( ) in Verbindung mit eindeutig fokusfähigen Elementen wie Text-input- und textarea-Elementen. |
|
Um einem Textfeld den Fokus zuzuweisen und zugleich den in diesem Feld enthaltenen Text zu markieren, wenden Sie die Methoden focus( ) und select( ) nacheinander auf das Element an. Wenn dies unmittelbar nach einer Veränderung im Fenster geschehen soll (z. B. nachdem ein Wardialogfeld geschlossen wurde), stellen Sie die beiden Methoden in eine separate Funktion und rufen Sie diese im Anschluss an die alert( )-Methode des Dialogfelds über die Methode setTimeout( ) auf. Auf diese Weise können Sie gewährleisten, dass IE/Windows die Anweisungen in der richtigen Reihenfolge ausführt. |
|
Parameter | |
Keine. |
|
Zurückgegebener Wert | |
Keiner. |
height, width | NN 6 IE 4 DOM nicht zutreffend |
Lesen/Schreiben | |
Stellt die Höhe und Breite des Elements in Pixel bereit, so wie es durch die Tag-Attribute definiert wurde. Änderungen an diesen Werten wirken sich nicht notwendigerweise auf die Größe des tatsächlichen rechteckigen Applet-Bereichs aus, wenn dieses bereits geladen wurde. |
|
Beispiel | |
var controllerHeight = document.embeds["audioPlayer"].height; |
|
Wert | |
Eine ganze Zahl. |
|
Standardwert | |
0 |
name | NN 6 IE 4 DOM nicht zutreffend |
Lesen/Schreiben (IE) | |
Spiegelt den Wert des name-Attributs eines Element-Tags wider. |
|
Beispiel | |
document.embeds["myEmbed"].name = "tunes"; |
|
Wert | |
Ein von der Groß-/Kleinschreibung abhängiger Bezeichner, der den Regeln der Bezeichnerbenennung folgt: Er darf keine Leerzeichen enthalten, nicht mit einer Ziffer beginnen und sollte keine Satzzeichen enthalten (mit Ausnahme des Unterstrichs). |
|
Standardwert | |
Keiner. |
palette | NN nicht zutreffend IE 4(Win) DOM nicht zutreffend |
Schreibgeschützt | |
Gibt die Einstellung des Attributs palette eines embed-Objekts zurück. |
|
Wert | |
Zeichenfolge. |
|
Standardwert | |
Keiner. |
pluginspage | NN nicht zutreffend IE 4(Win) DOM nicht zutreffend |
Schreibgeschützt | |
Gibt die URL für das Herunterladen und Installieren eines Plug-Ins an, das für das Ausführen der im aktuellen Objekt eingebetteten Daten erforderlich ist. |
|
Wert | |
Vollständige oder relative URL als Zeichenfolge. |
|
Standardwert | |
"None" wird zurückgegeben, aber Internet Explorer besitzt eine eigene Standard-URL für Plug-In-Informationen. |
readyState | NN nicht zutreffend IE 4 DOM nicht zutreffend |
Schreibgeschützt | |
Gibt den aktuellen Downloadstatus des Objektinhalts zurück. Falls ein Skript (insbesondere eines, das durch ein Benutzerereignis ausgelöst wurde) bestimmte Aktionen ausführen kann, während das Dokument noch geladen wird, aber andere Aktionen vermeiden muss, bis die gesamte Seite geladen ist, bietet diese Eigenschaft sofortige Informationen zum Ladeprozess. Sie sollten diesen Wert bei der Auswertung von Bedingungen verwenden. Der Wert dieser Eigenschaft ändert sich während des Ladens, wenn sich der Ladezustand ändert. Jede Änderung des Eigenschaftswerts löst ein onReadyStateChange-Ereignis aus, das nicht nach oben verbreitet wird. |
|
Als diese Eigenschaft in IE 4 eingeführt wurde, war sie nur für document-, embed-, img-, link-, object-, script- und style-Objekte verfügbar. In IE 5 wurde die Unterstützung für diese Eigenschaft auf alle HTML-Elementobjekte ausgeweitet. |
|
Beispiel | |
if (document.readyState == "loading") { //statements for alternate handling while loading } |
|
Wert | |
Bei allen Elementen mit Ausnahme des object-Elements einer der folgenden Werte (als Zeichenfolge): uninitialized | loading | loaded | interactive | complete. Einige Elemente erlauben es dem Benutzer, mit einem Teil des Inhalts zu interagieren. In diesem Fall kann die Eigenschaft interactive zurückgegeben werden, bis der Ladevorgang abgeschlossen ist. Nicht alle Elementtypen geben während des Ladevorgangs alle Werte nacheinander zurück. Das object-Element gibt diese fünf Zustände in Form numerischer Werte zwischen 0 (uninitialized) und 4 (complete) an. |
|
Standardwert | |
Keine. |
scrollHeight, scrollWidth | NN 7 IE 4 DOM nicht zutreffend |
Schreibgeschützt | |
Diese Eigenschaften wurden in IE 4 ursprünglich für Elemente implementiert, die entweder selbst einen Bildlauf ausführen oder den Bildlauf eines Elements beeinflussen (body, button, caption, div, fieldset, legend, marquee und textarea), und geben die Abmessungen eines Elements in Pixeln zurück, auch wenn dieses größer ist als der sichtbare Bereich des Browserfensters. Insofern unterscheiden sie sich von den Eigenschaften clientHeight und clientWidth für rollbare Elemente, die nur die Abmessungen sichtbarer Anteile des Elements zurückgeben. IE für den Macintosh interpretiert den Zweck der Bildlaufeigenschaften anders und gibt die Maße der sichtbaren Elementbereiche zurück. |
|
In IE für Windows weisen seit Version 5 alle HTML-Elemente diese Eigenschaften auf, und die Werte für nicht rollende Elemente sind mit denen der Eigenschaften offsetHigh und offsetWidth identisch. Netscape 7 implementiert diese Eigenschaften für alle Elemente und gibt die Höhe und Breite des Elements zurück, unabhängig davon, ob es sich innerhalb oder außerhalb des sichtbaren Bereichs befindet. Wichtig ist hier, dass für Schlüsselelemente, wie z. B. body, die Eigenschaften unterschiedliche Dinge bedeuten und den plattformübergreifenden Betrieb stören können. |
|
Beispiel | |
var midPoint = document.body.scrollHeight/2; |
|
Wert | |
Eine positive ganze Zahl oder Null. |
|
Standardwert | |
Keine. |
scrollLeft, scrollTop | NN 7 IE 4 DOM nicht zutreffend |
Lesen/Schreiben | |
Stellt den Abstand in Pixeln zwischen dem tatsächlichen linken oder oberen Rand des physischen Inhalts eines Elements und dem linken oder oberen Rand des sichtbaren Teils des Inhalts bereit. Durch Festlegen dieser Eigenschaften können Sie ein Skript verwenden, um den Bildlauf von Inhalten in einem rollbaren Container einstellen, z. B. einen Text in einem textarea-Element oder ein gesamtes Dokument in einem Browserfenster bzw. einem Frame. Können die Inhalte nicht gerollt werden, sind beide Werte Null. Wenn Sie die Eigenschaft scrollTop beispielsweise auf 15 setzen, rollt das Dokument um 15 Pixel im Fenster nach oben; die Eigenschaft scrollLeft wird nicht beeinflusst, soweit sie nicht ausdrücklich geändert wird. Die Eigenschaftswerte ändern sich, wenn der Benutzer die Bildlaufleisten anpasst. Dies ist für bestimmte ereignisgesteuerte Positionierungsaufgaben in IE für Windows von Bedeutung, da sich das Koordinatensystem für Ereignis-Offset-Messungen auf den sichtbaren Bereich einer Seite im Browserfenster bezieht. Sie müssen document.body-Bildlauffaktoren hinzufügen, um Ereigniskoordinaten an den Positionen der Body-Inhalte auszurichten (siehe das Beispiel zum Ziehen von Elementen in Kapitel 6). In IE für Windows ab Version 5 sind die Eigenschaften scrollLeft und scrollTop für alle HTML-Elementobjekte verfügbar, nicht rollbare Elemente weisen jedoch für beide Eigenschaften den Wert Null auf. |
|
Beispiel | |
document.body.scrollTop = 40; |
|
Wert | |
Eine positive ganze Zahl oder Null. |
|
Standardwert | |
0 |
src | NN nicht zutreffend IE 4(Win) DOM nicht zutreffend |
Lesen/Schreiben | |
Gibt die URL der externen Inhaltsdatei an, die dem Objekt zugewiesen ist. Obwohl manche Controller möglicherweise auf Änderungen dieses Attributs reagieren, ist es sicherer, eine andere Datei über ihre eigene Lademethode oder -eigenschaft in den Controller zu laden. |
|
Beispiel | |
document.embeds["myEmbed"].src = "tunes/dannyboy.wav"; |
|
Wert | |
Vollständige oder relative URL als Zeichenfolge. |
|
Standardwert | |
Keiner. |
tabIndex | NN 6 IE 4 DOM 1 |
Lesen/Schreiben | |
Dies ist eine Zahl, die die Position dieses Elements innerhalb der Tabulatorreihenfolge aller aktivierbaren Elemente im Dokument angibt. Für die Tabulatorreihenfolge gelten sehr strenge Regeln. Elemente, deren tabIndex-Eigenschaften Werte (nicht Null) zugewiesen wurden, befinden sich in der Reihenfolge an erster Stelle, wenn ein Benutzer die Tabulatortaste auf einer Seite verwendet. Der Fokus beginnt bei dem Element mit dem niedrigsten tabIndex-Wert und folgt der Reihenfolge bis zum höchsten Wert, unabhängig von der physischen Position eines Objekts auf der Seite oder in einem Dokument. Falls zwei Elemente die gleichen tabIndex-Werte aufweisen, erhält das Element, das zuerst im Dokument erscheint, auch zuerst den Fokus. Dann kommen alle Elemente, die entweder die Eigenschaft tabIndex nicht unterstützen oder deren Wert auf Null gesetzt ist. Diese Elemente werden in der Reihenfolge aktiviert, in der sie im Dokument angeordnet sind. |
|
Im W3C-DOM und in Netscape 6 ist die Eigenschaft tabIndex auf folgende Elementobjekte beschränkt: a, area, button, input, object, select und textarea. IE 4 unterstützt es darüber hinaus für die Elemente applet, body, div, embed, isindex, marquee, span, table und td. IE 5 erkennt dieses Attribut in Verbindung mit allen darstellbaren Elementen. Ein negativer Wert entfernt ein Element (nur in IE) vollständig aus der Tabulatorreihenfolge. |
|
Da Hyperlinks und Anker in der Mac-Version von IE 4 nicht über die Tabulatortaste zu erreichen sind, wird die Eigenschaft tabIndex bei a-Elementen in dieser Version ignoriert. |
|
Beispiel | |
document.getElementById("link3").tabIndex = 6; |
|
Wert | |
Eine ganze Zahl. |
|
Standardwert | |
0 |
type | NN 6 IE nicht zutreffend DOM nicht zutreffend |
Schreibgeschützt | |
Gibt den MIME-Typ der externen Daten an, die dem type-Attribut des Elements zugewiesen sind. |
|
Beispiel | |
var dataMIME = document.embeds["myEmbed"].type; |
|
Wert | |
Gültiger MIME-Typ als Zeichenfolge in Anführungszeichen, einschließlich Typ und Untertyp (durch einen Vorwärtsschrägstrich getrennt). |
|
Standardwert | |
Keiner. |
units | NN nicht zutreffend IE 4(Win) DOM nicht zutreffend |
Lesen/Schreiben | |
Gibt die Maßeinheit für die Höhe und Breite des Elements an. Internet Explorer scheint alle Einstellungen als Pixel zu behandeln. |
|
Beispiel | |
document.getElementById("myEmbed").units = "ems"; |
|
Wert | |
Eine der folgenden Konstanten in Form einer von der Groß-/Kleinschreibung unabhängige Zeichenfolge: pixels | px | em. |
|
Standardwert | |
pixels |
width | |
Siehe height. |