getComputedElementStyle

[ Funktion ]

public static getComputedElementStyle(
    element: Jquery<Element> | readonly Element[] | NodeListOf<Element> | HTMLCollectionOf<Element> | Element | undefined, 
    propertyNames: string[]
): Dictionary<string>;

Gibt mehrere aktive CSS-Eigenschaften eines HTML-Elements zurück. Dies berücksichtigt auch Eigenschaften, welche von CSS-Dateien wirken. Enthält das übergebene Objekt mehrere Elemente (wie bei einer jQuery Collection), so wird das erste Element genutzt.

Parameter

Name

Typ

Beschreibung

element

Info: Typ Element unterstützt ab Version 1.10
Info: Typen Element[] | NodeListOf<Element> | HTMLCollectionOf<Element> ab Version 1.10.1171.21

JQuery<Element>, readonly Element[], NodeListOf<Element>, HTMLCollectionOf<Element>, Element, undefined

  • jQuery Collection mit dem zu prüfenden Element
  • beliebige Array-ähnliche Element-Liste (auch beispielsweise aus document.querySelectorAll() oder document.getElementsByClassName())
  • einzelnes Element, also beispielsweise HTML- oder SVG-Element.

propertyNames

string[]

String Vektor der Namen der CSS-Eigenschaften

Rückgabewert

Typ

Beschreibung

Dictionary<string>

Objekt mit den CSS-Eigenschaften des ersten Elements in der jQuery Collection. Ist eine angeforderte Eigenschaft nicht (mehr) gesetzt, so wird dieser Eintrag im Objekt nicht gesetzt.

Gibt im Fehlerfall ein leeres Objekt zurück.

getComputedElementStyle 1:

Verfügbar ab Version 1.10

Beispiel - JavaScript

var control = TcHmi.Controls.get('TcHmiButton');
if(control === undefined){ 
    return; 
}
var cntrlElem = control.getElement();
var someStyles = TcHmi.StyleProvider.getComputedElementStyle(cntrlElem, 
     ['border-width', 'height', 'does-not-exist']
);
/* returns:
{
    'border-width': '0px',
    'height': '50px'
}
*/
TcHmi.Log.debug('Border Width is: '+ someStyles['border-width']);