> [Site index](https://perfectvector.com/llms.txt) — available pages and descriptions.

# SVG shape-rendering crispEdges: ¿cuándo ayuda?

> Descubre cuándo crispEdges ayuda a diseños sobre una cuadrícula de píxeles, cuándo puede empeorar las curvas y por qué conviene probarlo en el navegador a dos tamaños.

Source: https://perfectvector.com/es/blog/svg-shape-rendering-crispedges

Language: es
Author: Irene Kim
Published: 2026-09-28T08:00:00+09:00
Updated: 2026-09-28T08:00:00+09:00

Utiliza `shape-rendering="crispEdges"` cuando un SVG tenga bordes deliberadamente duros y principalmente rectos y una prueba al tamaño final de visualización mejore con ese ajuste. Mantén el valor predeterminado `auto` cuando la diferencia sea insignificante. En diseños curvos, la indicación puede hacer que un borde parezca más irregular. Cambia cómo un renderizador **dibuja** las formas existentes, no las formas en sí. La [especificación SVG 2](https://www.w3.org/TR/SVG2/painting.html#ShapeRendering) lo define como una indicación y permite al renderizador reducir el suavizado de bordes o alinear algunos bordes con los píxeles del dispositivo.

Esa distinción importa si un icono diminuto parece borroso o un logotipo tiene bordes dentados después de exportarlo. `crispEdges` no puede convertir un PNG incrustado en trazados, reparar un contorno roto ni garantizar los mismos píxeles en todos los navegadores. Antes de cambiar todo el archivo, compara una forma representativa con `auto`, `crispEdges` y `geometricPrecision` en los tamaños en que realmente se verá.

> **Elige según el borde que necesitas**
>
> * **Diseño rectangular sobre cuadrícula de píxeles:** prueba `crispEdges` en las formas pertinentes y comprueba tanto tamaños pequeños como grandes.
> * **Curvas o letras redondas:** empieza por `auto`; prueba `geometricPrecision` si el renderizador produce una diferencia visible.
> * **Un hueco entre formas adyacentes:** inspecciona primero la geometría. Una indicación de renderizado no puede cerrar un hueco real.
> * **Un PNG escalado dentro de SVG:** utiliza controles de escalado rasterizado o reconstruye el diseño como trazados si el objetivo es poder editarlo.

## Qué pide `crispEdges` al renderizador

SVG tiene cuatro valores de `shape-rendering`. Son prioridades, no cuatro formatos de exportación. El valor predeterminado `auto` deja que el renderizador equilibre la velocidad, el contraste de los bordes y la precisión geométrica. `crispEdges` favorece un contraste fuerte en los bordes y puede suprimir el suavizado; `geometricPrecision` favorece la fidelidad geométrica. La [referencia de atributos SVG de MDN](https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Attribute/shape-rendering) explica que un renderizador *podría* tratar de forma diferente todos los bordes o solo los casi horizontales y casi verticales. No se exige ningún filtro de enfoque.

| Valor                | Qué solicita                              | Primera prueba útil                                     |
| -------------------- | ----------------------------------------- | ------------------------------------------------------- |
| `auto`               | El renderizador elige el equilibrio       | Referencia inicial para cualquier SVG                   |
| `crispEdges`         | Más contraste en los bordes de las formas | Marcas cuadradas o detalles de cuadrícula               |
| `geometricPrecision` | Posición geométrica más fiel              | Curvas, diagonales y contornos finos                    |
| `optimizeSpeed`      | Prioridad a la velocidad de renderizado   | Contextos especializados; no supongas una mejora visual |

Las formas hijas pueden heredar un atributo del SVG padre, por lo que aplicarlo en la raíz puede afectar a un círculo que debería mantenerse suave. Puedes dirigirte a un único rectángulo o trazado. Si se aplican tanto el atributo de presentación SVG como una declaración CSS de `shape-rendering`, [la propiedad CSS tiene prioridad](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/shape-rendering).

## Comparamos las mismas formas a dos tamaños

Creamos una marca de cuadrícula rectangular y un contorno curvo como formas SVG originales. El marcado, los rellenos y el `viewBox` eran idénticos en las tres columnas; solo cambiaba el valor de `shape-rendering`. Cada forma se renderizó a 63 y 111 píxeles CSS en Chromium con el zoom del navegador al 100%. La figura es una captura del navegador de esa prueba local, no una ilustración de un resultado imaginado.

**La misma geometría SVG, tres indicaciones y dos tamaños**

![Captura de Chromium que compara la misma marca SVG rectangular y un contorno curvo con auto, crispEdges y geometricPrecision a tamaños de visualización de 63 y 111 píxeles](https://perfectvector.com/blog/svg-shape-rendering-crispedges/render-test.webp)

*Captura original de Chromium con el zoom del navegador al 100%. La diferencia visual es pequeña aquí; la indicación cambia el tratamiento de los píxeles, no los trazados. Prueba tu renderizador y tamaño final.*

Ningún modo cambia los trazados. En esta captura, las diferencias son demasiado pequeñas para declarar un ajuste ganador en general. El nombre parece el de una herramienta de reparación, pero el efecto puede ser leve para una forma, un tamaño y un renderizador concretos. Inspecciona el destino real antes de conservar el atributo adicional.

Esto fue un renderizado de Chromium, no un estudio de compatibilidad entre navegadores. Un visor PDF, un editor de diseño o un navegador con otra escala de dispositivo puede rasterizar los mismos trazados de forma diferente. La [definición de SVG 2](https://www.w3.org/TR/SVG2/painting.html#ShapeRendering) deja deliberadamente abiertas las decisiones de implementación.

## Pruébalo en una forma antes de aplicarlo a todo

Guarda una copia del SVG y después coloca la indicación en una forma representativa. Por ejemplo, aplícala a la parte rectangular de un icono mientras mantienes el detalle curvo en `auto`:

```xml
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
  <rect x="4" y="4" width="16" height="8" fill="#154b67"
        shape-rendering="crispEdges" />
  <path d="M5 18 Q12 11 19 18" fill="none" stroke="#23a6a1"
        stroke-width="2" shape-rendering="auto" />
</svg>
```

Abre el archivo en el visor previsto a un tamaño pequeño de icono y a otro mayor. Compáralo con el original guardado, incluidas las diagonales y las curvas. Si estás dando estilo a un SVG en línea mediante CSS, comprueba si una regla sustituye tu atributo. Quita la indicación cuando no produzca una mejora significativa; una propiedad innecesaria dificulta diagnosticar diferencias de visualización posteriores.

## Ajusta la solución al síntoma real

| Síntoma                                                   | Comprueba primero                                             | Mejor siguiente paso                                                                                                                             |
| --------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Una marca cuadrada parece poco nítida a un tamaño         | Compara `auto` y `crispEdges` a ese tamaño                    | Conserva la indicación solo si mejora el resultado previsto                                                                                      |
| Un círculo o una diagonal parece dentado                  | Comprueba si `crispEdges` se hereda o se exporta en esa forma | Quítalo o compara `auto` con `geometricPrecision`                                                                                                |
| Aparece una línea fina entre rellenos que se tocan        | Compara el zoom, el fondo y los límites de los trazados       | Utiliza el [diagnóstico de juntas SVG](https://perfectvector.com/es/blog/svg-gaps-between-shapes); repara la geometría solo si el hueco es real  |
| El archivo sigue mostrando píxeles cuadrados al ampliarlo | Busca una imagen rasterizada incrustada                       | Utiliza la [lista de comprobación de SVG pixelados](https://perfectvector.com/es/blog/svg-looks-pixelated) en lugar de cambiar `shape-rendering` |

Para un sprite PNG cuya cuadrícula exacta de píxeles sea el diseño, conservar la imagen rasterizada puede ser la opción más limpia. CSS [`image-rendering: pixelated`](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/image-rendering) controla cómo se muestrea una imagen escalada; es una propiedad diferente de `shape-rendering` de SVG. La [guía de conversión de pixel art](https://perfectvector.com/es/blog/pixel-art-to-vector) explica cuándo conservar la cuadrícula, crear mosaicos vectoriales o suavizar deliberadamente el contorno.

## Cuándo encaja PerfectVector

Si tu único original es un PNG pequeño y aplanado y necesitas **trazados editables**, una indicación de renderizado no puede proporcionarlos. PerfectVector resulta útil en ese paso anterior: convierte el PNG en una alternativa SVG y después inspecciona las formas al tamaño necesario. Comprueba el contorno, los huecos interiores y los detalles pequeños antes de probar una indicación de visualización en determinados trazados. Un calco puede reinterpretar píxeles como geometría; no puede decidir si un escalón de pixel art debe convertirse en una curva suave.

Conserva el PNG cuando la cuadrícula original sea el diseño final. Si ya tienes un SVG limpio y solo su visualización en el navegador parece extraña, corrige directamente la visualización o la geometría. Cuando un PNG aplanado necesite realmente contornos editables, [crea una alternativa SVG con PerfectVector](https://perfectvector.com/es/convert-png-to-svg), inspecciona sus trazados y compara el renderizado del navegador al tamaño final antes de añadir `crispEdges`.

## Preguntas frecuentes

**¿Elimina `crispEdges` el suavizado de todas las formas SVG?**
No. Pide al renderizador que favorezca el contraste de los bordes. La especificación permite distintas implementaciones, incluidas las que solo cambian algunos bordes casi verticales o casi horizontales. Prueba el resultado en el visor que utilizarás.

**¿Debo poner `shape-rendering="crispEdges"` en todo el SVG?**
Solo si beneficia a todas las formas hijas. Una indicación en la raíz también puede afectar a los elementos curvos. Aplicar el atributo a una forma rectangular es más fácil de evaluar y tiene menos probabilidades de hacer irregular una curva.

**¿Arreglará `crispEdges` las juntas blancas o un PNG borroso dentro de un SVG?**
No puede cerrar un hueco real ni sustituir los píxeles rasterizados por trazados vectoriales. Diagnostica primero la geometría de la junta. Para un PNG escalado, utiliza un método adecuado de escalado rasterizado o crea trazados vectoriales editables si esa es la necesidad real.

## Fuentes

1. [W3C — Propiedad shape-rendering de SVG 2](https://www.w3.org/TR/SVG2/painting.html#ShapeRendering) — define los cuatro valores como indicaciones para el renderizador y explica los compromisos permitidos.
2. [MDN — Atributo shape-rendering de SVG](https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Attribute/shape-rendering) — documenta las formas SVG aplicables, la herencia y la prioridad de CSS.
3. [MDN — Propiedad shape-rendering de CSS](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/shape-rendering) — describe el comportamiento de la propiedad y por qué puede variar el renderizado de curvas.
4. [MDN — Propiedad image-rendering de CSS](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/image-rendering) — distingue el escalado de píxeles rasterizados del renderizado de bordes de formas vectoriales.

## Explore

- [Read the HTML article](https://perfectvector.com/es/blog/svg-shape-rendering-crispedges)
- [Convertir a vector en Scratch: por qué sigue viéndose pixelado](https://perfectvector.com/es/blog/scratch-convert-bitmap-to-vector.md)
- [¿No funciona z-index en SVG? Corrige el orden de los trazados](https://perfectvector.com/es/blog/svg-z-index-order.md)
- [Product facts](https://perfectvector.com/product-facts.md)
- [FAQ](https://perfectvector.com/faq.md)
- [Pricing and credits](https://perfectvector.com/pricing.md)
