Please note, this is a STATIC archive of website developer.mozilla.org from November 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

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


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

 

 

 

Etiquetas y colaboradores del documento

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