element.getBoundingClientRect

 

Imagen:traduccion-pendiente.png Esta página está traduciéndose a partir del artículo DOM:element.getBoundingClientRect, razón por la cual puede haber algunos errores sintácticos o partes sin traducir. Puedes colaborar continuando con la traducción


Resumen

Devuelve un rectángulo de texto que encierra un grupo de rectángulos de texto.

Sintaxis

rectObject = object.getBoundingClientRect();

Devuelve

El valor devuelto es un objeto TextRectangle que es la unión de los rectángulos devueltos por getClientRects() para el elemento, por ejemplo, las cajas de bordes CSS con el elemento.

Las cajas de bordes vacías son completamente ignoradas. Si todas las cajas de bordes del elemento estan vacías, entonces se devuelve un rectángulo con un alto y ancho de cero y donde top y left coinciden con top-left de la caja de bordes del primer elemento CSS (en orden de contenido).

La cantidad de desplazamiento sufrido por la ventana del navegador, se tiene en cuenta en el cálculo de las coordenadas.

Ejemplo

// rect es un objeto DOMRect con ocho propiedades: left, top, right, bottom, x, y, width, height
var rect = obj.getBoundingClientRect();

Especificaciones

No forma parte de ninguna especificación W3C.

Notas

getBoundingClientRect() apareció por primera vez en el modelo de objetos de MS IE DHTML.

Referencias

 

 

 

 

Etiquetas y colaboradores del documento

 Colaboradores en esta página: jzatarain, fscholz, jsx, HenryGR, Mgjbot
 Última actualización por: jzatarain,