grayscale()
{{CSSRef}}
The grayscale()
CSS function converts the input image to grayscale. Its result is a {{cssxref("<filter-function>")}}
.
{{EmbedInteractiveExample("pages/css/function-grayscale.html")}}
Syntax
grayscale(amount)
Parameters
amount
- : Amount of the input image that is converted to grayscale. It is specified as a
{{cssxref("<number>")}}
or a{{cssxref("<percentage>")}}
. A value of100%
changes the input completely to grayscale, while a value of0%
leaves the input unchanged. Values between0%
and100%
have linear multipliers on the effect. If thegrayscale()
filter is present with no parameter, the default value is1
. The initial value used for{{Glossary("interpolation")}}
is0
.
- : Amount of the input image that is converted to grayscale. It is specified as a
Formal syntax
{{CSSSyntax}}
Examples
Examples of correct values for grayscale()
grayscale(0) /* No effect */
grayscale(.7) /* 70% grayscale */
grayscale(100%) /* Completely grayscale */
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
The other {{cssxref("<filter-function>")}}
functions available to be used in values of the {{cssxref("filter")}}
and {{cssxref("backdrop-filter")}}
properties include:
{{cssxref("filter-function/blur", "blur()")}}
{{cssxref("filter-function/brightness", "brightness()")}}
{{cssxref("filter-function/contrast", "contrast()")}}
{{cssxref("filter-function/drop-shadow", "drop-shadow()")}}
{{cssxref("filter-function/hue-rotate", "hue-rotate()")}}
{{cssxref("filter-function/invert", "invert()")}}
{{cssxref("filter-function/opacity", "opacity()")}}
{{cssxref("filter-function/saturate", "saturate()")}}
{{cssxref("filter-function/sepia", "sepia()")}}