CKTIS / JavaScript
CSSStyleDeclaration: grosores de borde y transform
Ajusta el grosor de cada lado del borde y una transformación CSS mediante `element.style`. Distingue las declaraciones en línea de los valores que el navegador resuelve tras aplicar la cascada.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
const style = element.style;
style.borderStyle = "solid";
style.borderWidth = "2px 4px 6px 8px";
style.borderTopWidth = "3px";
style.borderRightWidth = "4px";
style.borderBottomWidth = "6px";
style.borderLeftWidth = "8px";
style.transform = "translateX(12px)";
style.setProperty("border-top-width", "3px");
style.getPropertyValue("border-top-width");
getComputedStyle(element).borderTopWidth;element.style da acceso a un objeto que se actualiza automáticamente y cuyas propiedades permiten leer y modificar las declaraciones del atributo style de un elemento. En el CSSOM actual es un objeto CSSStyleProperties, que hereda de CSSStyleDeclaration; la documentación antigua puede nombrar la interfaz base. Esta API del navegador no forma parte de ECMAScript 2024.
borderWidth es la abreviatura CSS border-width. Un valor se aplica a todos los lados; dos se aplican arriba/abajo y derecha/izquierda; tres, arriba, derecha/izquierda y abajo; cuatro, arriba, derecha, abajo e izquierda. Para cambiar un solo lado, usa borderTopWidth, borderRightWidth, borderBottomWidth o borderLeftWidth. Usa cadenas con valores CSS como "3px", "0" o "thin"; el número 3 no significa tres píxeles. El grosor por sí solo no hace visible el borde: con un estilo none o hidden, el grosor se resuelve a cero. Define, por ejemplo, borderStyle = "solid".
style.transform = "translateX(12px)" sustituye toda la declaración en línea transform. Si el elemento admite transformaciones y esta declaración prevalece en la cascada, su representación se desplaza 12 píxeles CSS a la derecha sin cambiar el espacio que ocupa en el flujo normal. Una declaración !important de una hoja de estilos del autor que se aplique al elemento puede prevalecer sobre la declaración en línea. Para combinar varias funciones, escríbelas en una cadena separadas por espacios; el orden importa.
setProperty("border-top-width", "3px") y getPropertyValue("border-top-width") usan el nombre CSS con guiones, a diferencia de style.borderTopWidth. Si no hay una declaración en línea para ese lado, style.borderTopWidth devuelve "". Para leer el valor resuelto tras la cascada de un elemento en el documento, usa getComputedStyle(element); el resultado se actualiza automáticamente, pero es de solo lectura.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Border widths and transform</title>
</head>
<body>
<script>
{
const box = document.createElement("div");
const style = box.style;
style.borderStyle = "solid";
style.borderWidth = "2px 4px 6px 8px";
style.setProperty("border-top-width", "3px");
style.transform = "translateX(12px)";
console.log([
style.borderTopWidth,
style.borderRightWidth,
style.borderBottomWidth,
style.borderLeftWidth,
].join(" "));
console.log(style.getPropertyValue("border-top-width"));
console.log(style.transform);
}
</script>
</body>
</html>Resultado
3px 4px 6px 8px 3px translateX(12px)
Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta la consola de desarrollo. La abreviatura fija los cuatro grosores y `setProperty()` solo cambia el superior. El elemento no se añade al documento, así que la salida muestra declaraciones en línea, no el resultado visual.
Lecciones relacionadas
- JavaScript · Lección 35 · Intermedio · Versión: 3