trNN 6 IE 4 DOM 1

Das tr-Objekt spiegelt das tr-Element wider. Aufgrund einer unvollständigen Implementierung ermöglicht IE 4 für den Macintosh keinen uneingeschränkten Skriptzugriff auf diese Elemente.

 
HTML-Äquivalent
 
<tr>
 
Objektmodellreferenz
 
[window.]document.getElementById("elementID")
[window.]document.getElementById("tableID").rows[i]
 
Objektspezifische Eigenschaften
 
alignbgColorborderColorborderColorDark
borderColorLightcells[ ]chchOff
heightrowIndexsectionRowIndexvAlign
 
Objektspezifische Methoden
 
deleteCell( )insertCell( )
 
Objektspezifische Ereignisbehandlungsroutineneigenschaften

Keine.

alignNN 6 IE 4 DOM 1

Lesen/Schreiben

Definiert die horizontale Ausrichtung von Inhalten in allen Zellen einer Zeile.

 
Beispiel
 
document.getElementById("myTR").align = "center";
 
Wert

Eine der drei folgenden horizontalen Ausrichtungskonstanten: center | left | right.

 
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.

bgColorNN 6 IE 4 DOM 1

Lesen/Schreiben

Legt die Hintergrundfarbe der Tabellenzellen in der aktuellen Zeile fest. Diese Farbeinstellung wird nicht von der backgroundColor-Eigenschaft des Stylesheets widergespiegelt. Auch wenn für das bgcolor-Attribut oder die bgColor-Eigenschaft ein unverschlüsselter Farbname angegeben wurde, ist der zurückgegebene Wert immer ein hexadezimales Triplett.

 
Beispiel
 
document.getElementById("myTR").bgColor = "yellow";
 
Wert

Ein hexadezimales Triplett oder ein unverschlüsselter Farbname. Einzelheiten zu den gültigen unverschlüsselten Farbnamen finden Sie in Anhang A.

 
Standardwert

Hängt vom Browser und dem Betriebssystem ab.

borderColorNN nicht zutreffend IE 4 DOM nicht zutreffend

Lesen/Schreiben

Legt die Farbe des Elementrahmens fest. Internet Explorer wendet die Farbe für alle vier Linien an, aus denen der innere Rahmen einer Zelle besteht. Daher gibt es keine Konflikte zwischen den Farben aneinander grenzender Zellen.

 
Beispiel
 
document.getElementById("myTR").borderColor = "salmon";
 
Wert

Ein hexadezimales Triplett oder ein unverschlüsselter Farbname. Eine Einstellung ohne Wert wird als "#000000" (Schwarz) interpretiert. Einzelheiten zu den gültigen unverschlüsselten Farbnamen finden Sie in Anhang A.

 
Standardwert

Variiert je nach Betriebssystem.

borderColorDark, borderColorLightNN nicht zutreffend IE 4 DOM nicht zutreffend

Lesen/Schreiben

Der dreidimensionale Effekt der Tabellenrahmen in Internet Explorer wird durch das sorgfältige Positionieren von hellen und dunklen Linien um den Seitenhintergrund oder die Standardfarbe erzeugt. Sie können die für helle und dunkle Linien verwendeten Farben unabhängig steuern, indem Sie den Eigenschaften borderColorDark (linke und obere Seite der Zelle) und borderColorLight (rechte und untere Seite) Werte zuweisen.

 

In der Regel werden dem Eigenschaftenpaar Komplementärfarben zugewiesen. Es gibt jedoch keine Regel, die besagt, Sie müssen der Eigenschaft borderColorDark eine dunkle Farbe zuweisen. Die Attribute steuern lediglich einen definierten Liniensatz, so dass Sie vorhersagen können, welche Seite eines Rahmens sich mit welchem Attribut ändert.

 
Beispiel
 
document.getElementById("myTR").borderColorDark = "blue";
document.getElementById("myTR").borderColorLight = "cornflowerblue";
 
Wert

Ein hexadezimales Triplett oder ein unverschlüsselter Farbname. Eine Einstellung ohne Wert wird als "#000000" (Schwarz) interpretiert. Einzelheiten zu den gültigen unverschlüsselten Farbnamen finden Sie in Anhang A.

 
Standardwert

Variiert je nach Betriebssystem.

cells[ ]NN 6 IE 4 DOM 1

Schreibgeschützt

Gibt eine Sammlung aller td- oder th-Elemente zurück, die in der Tabellenzeile verschachtelt sind. Die Elemente in dieser Sammlung sind in der Quellcodereihenfolge aufgeführt.

 
Beispiel
 
var allRowCells = document.getElementById("myTR").cells;
 
Wert

Referenz auf ein cells-Sammlungsobjekt.

 
Standardwert

Array mit der Länge Null.

chNN 6 IE 5(Mac)/6(Win) DOM 1

Lesen/Schreiben

Definiert das Textzeichen, das als Ausrichtungspunkt für die Textzellen der Zeile verwendet wird. Diese Eigenschaft ist normalerweise nur sinnvoll, wenn das align-Attribut auf "char" gesetzt ist. In der Praxis haben diese Eigenschaften weder in IE noch in Navigator irgendwelche Auswirkungen.

 
Beispiel
 
document.getElementById("myTR").ch = ".";
 
Wert

Aus einem einzelnen Zeichen bestehende Zeichenfolge.

 
Standardwert

Keiner.

chOffNN 6 IE 5(Mac)/6(Win) DOM 1

Lesen/Schreiben

Definiert den Offset-Punkt, an dem das durch das char-Attribut angegebene Zeichen in einer Zelle erscheinen soll. In der Praxis haben diese Eigenschaften weder in IE noch in Navigator irgendwelche Auswirkungen.

 
Beispiel
 
document.getElementById("myTR").chOff = "80%";
 
Wert

Anzahl der Pixel oder in Prozent angegebene relative Position (innerhalb der Zelle) in Form einer Zeichenfolge.

 
Standardwert

Keiner.

clientHeight, clientWidthNN 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

heightNN nicht zutreffend IE 5 DOM nicht zutreffend

Lesen/Schreiben

Legt die Höhe der Zeile in Pixel oder Prozent fest. Wenn Sie die Höhe einer Zeile dynamisch ändern möchten, sollten Sie anstelle der Eigenschaft height den style.height-Wert des Elements anpassen.

 
Wert

Anzahl von Pixel oder Prozentwert (innerhalb der Zeile) als Zeichenfolge.

 
Standardwert

Keiner.

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.

rowIndexNN 6 IE 4 DOM 1

Schreibgeschützt

Gibt eine auf Null basierende ganze Zahl zurück, mit der die Position der aktuellen Zeile unter allen anderen tr-Elementen in der gesamten Tabelle angegeben wird. Diese Zählung basiert auf der Quellcodereihenfolge der tr-Elemente.

 
Beispiel
 
var whichRow = document.getElementById("myTR").rowIndex;
 
Wert

Eine ganze Zahl.

 
Standardwert

Keiner.

sectionRowIndexNN 6 IE 4 DOM 1

Schreibgeschützt

Gibt eine auf Null basierende ganze Zahl zurück, mit der die Position der aktuellen Zeile unter allen anderen tr-Elementen in der Zeilengruppe angegeben wird. Bei einer Zeilengruppe kann es sich um eines der folgenden Elemente handeln: thead, tbody, tfoot. Diese Zählung basiert auf der Quellcodereihenfolge der tr-Elemente.

 
Beispiel
 
var whichRow = document.getElementById("myTR").sectionRowIndex;
 
Wert

Eine ganze Zahl.

 
Standardwert

Keiner.

vAlignNN 6 IE 4 DOM 1

Lesen/Schreiben

Gibt die vertikale Ausrichtung des Textes innerhalb der Zellen der aktuellen Zeile an.

 
Beispiel
 
document.getElementById("myTR").vAlign = "baseline";
 
Wert

Von der Groß-/Kleinschreibung unabhängige Konstante (als Zeichenfolge): baseline | bottom | middle | top.

 
Standardwert

middle

deleteCell( )NN 6 IE 4 DOM 1

deleteCell(index)

Entfernt ein im aktuellen tr-Element verschachteltes td- oder th-Element. Der ganzzahlige Parameter verweist auf den auf Null basierenden Eintrag in der cells-Sammlung der Zeile.

 
Parameter
 
  • Auf Null basierende ganze Zahl, die dem numerierten td-Element in der Quellcodereihenfolge (verschachtelt im aktuellen Element) entspricht.
 
Zurückgegebener Wert

Keiner.

insertCell( )NN 6 IE 4(Win) DOM 1

insertCell(index)

Fügt ein im aktuellen tr-Element verschachteltes td-Element ein. Der ganzzahlige Parameter verweist auf die auf Null basierende Indexposition in der cells-Sammlung, an der die neue Zelle eingefügt werden soll; in IE können Sie jedoch auch den Kurzschrift-Wert -1 verwenden, um die Zelle an das Ende der Sammlung anzuhängen. Beim Einfügen der Zelle wird ein leeres Element erzeugt, dem Sie mithilfe der verschiedenen Verfahren zur Modifizierung des Dokumentbaums Inhalte hinzufügen. Leider funktioniert das skriptgesteuerte Hinzufügen von Tabellenzeilen und -zellen in IE für den Macintosh (einschließlich Version 5.1) nur sehr fehlerhaft und erzeugt übermäßig große Zeilen und Zellen. Bei nicht verschachtelten Tabellen können Sie anstelle der an sich praktischeren Tabellenabschnitts-Objektmethoden unter Umständen auf die regulären Verfahren zum Erstellen und Einfügen von Nodes in den Dokumentbaum zurückgreifen.

 
Parameter
 
  • Auf Null basierende ganze Zahl, die einer Zeile in der cells-Sammlung entspricht, vor der die neue Zelle eingefügt werden soll.
 
Zurückgegebener Wert

Referenz auf die neu eingefügte Zelle.

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.