getComputedElementStyle

[ Funktion ]

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

Gibt alle aktiven 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.

Rückgabewert

Typ

Beschreibung

Dictionary<string>

Objekt mit allen CSS-Eigenschaften des ersten Elements in der jQuery Collection.

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 allStyles = TcHmi.StyleProvider.getComputedElementStyle(cntrlElem);
/* returns:
{
    'animation-delay': '0s',
    'animation-direction': 'normal', 
    'animation-duration': '0s', 
    'animation-fill-mode': 'none', 
    … many many more
}*/
TcHmi.Log.debug('Border Width is: '+ allStyles['border-width']);