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
Resumen
Devuelve una colección de rectangulos que delimitan el rectángulo de cada línea de texto en el navegador.
Sintaxis
varrectCollection = 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