element.getClientRects

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


« Referencia DOM

Resumen

Devuelve una colección de rectangulos que delimitan el rectángulo de cada línea de texto en el navegador.

Sintaxis

var rectCollection = object.getClientRects();

Devuelve

ERl valor devuelto es una colección de objetos rectangulares TextRectangle, uno para cada elemento de l caja CSS asociada al elemento al que se refiere. Cada objeto TextRectangle contiene las propiedades de sólo lectura: left, top, right y bottom, que describen la caja, en pixel, con el valor top-left relativo al valor top-left del contenedor CSS, a no ser que el elemnto forme parte de un elemento SVG, en cuyo caso top-left es relativo al más próximo foreignobject y al sistema de coordenadas de éste.

La cantidad de desplazamiento que ha tenido la ventana, se tiene en cuenta al calcular los rectángulos.

Los rectángulos devueltos no incluyes ls márgenes de algún elemento hijo que haya podido desbordarse.

Para los elemntod se AREA en HTML, los elementos SVG que no se especifiquen a sí mismos, como los elementos display:none, y generalmente cualquier elemento que no se auto defina, se devuelve una lista vacia.

Aún si la caja CSS tiene bordes vacios, se devuelven las coordenadas. Las coordenadas left, top, right y bottom pueden aún tener significado.

Es posible que los valores de desplazamiento, sean fracciones de pixel.

Ejemplo

var rects = obj.getClientRects();
var numLines = rects.length;

Especificación

No forma parte de ninguna especificación W3C.

Notas

getClientRects() apareció por primera vez en el modelo de objeto de MS IE DHTML.

Referencias


Etiquetas y colaboradores del documento

Colaboradores de esta página: HenryGR, Mgjbot
Última actualización por: HenryGR,