MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.

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

 

El método Element.getClientRects() devuelve una colección de objetos DOMRect que indican los rectángulos que delimitan el rectángulo de cada línea de texto en el navegador.

Sintaxis

var rectCollection = object.getClientRects();

Devuelve

El valor devuelto es una colección de objetos rectangulares DOMRect, uno para cada cuadro borde CSS asociado al elemento. Cada objeto DOMRect contiene las propiedades de sólo lectura: left, top, right y bottom, que describen la caja, en pixeles, con el valor top-left relativo al valor top-left del viewport. En el caso de tablas con subtítulos, el subtítulo es incluido aún cuado esté fuera del cuadro borde de la tabla. En caso de ser ejecutado en algún elemento SVG que no sea el <svg> externo, el "viewport" al cual los rectángulos de resultado serán relativos será el "viewport" que establece el <svg> externo (y serán transformados por las trasnformaciones del <svg> externo, si estas existen).

Nota sobre Firefox 3.5

Firefox 3.5 ha agregado las propiedades width y height al objeto TextRectangle.

La cantidad de desplazamiento que ha tenido el área del viewport (o cualquier otro elemento desplazable) se tiene en cuenta al calcular los rectángulos.

Los rectángulos devueltos no incluyen los márgenes de ningún elemento hijo que se haya podido haber desbordado.

Para los elementos de AREA en HTML, elementos SVG que no renderizen nada por si mismos, los elementos display:none, y generalmente cualquier elemento que no sea renderizado directamente, 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: edhzsz, fscholz, khalid32, HenryGR, Mgjbot
 Última actualización por: edhzsz,