Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The -webkit-mask-position-y CSS property sets the initial vertical position of a mask image.
/* Keyword values */ -webkit-mask-position-y: top; -webkit-mask-position-y: center; -webkit-mask-position-y: bottom; /* <percentage> values */ -webkit-mask-position-y: 100%; -webkit-mask-position-y: -50%; /* <length> values */ -webkit-mask-position-y: 50px; -webkit-mask-position-y: -1cm; /* Multiple values values */ -webkit-mask-position-y: 50px, 25%, -3em; /* Global values */ -webkit-mask-position-y: inherit; -webkit-mask-position-y: initial; -webkit-mask-position-y: unset;
| Initial value | 0% |
|---|---|
| Applies to | all elements |
| Inherited | no |
| Percentages | refer to the size of the box itself |
| Media | visual |
| Computed value | for <length> the absolute value, otherwise a percentage |
| Animation type | discrete |
| Canonical order | order of appearance in the formal grammar of the values |
Syntax
Values
<length-percentage>- A length indicating the position of the top side of the image relative to the box's top padding edge. Percentages are calculated against the vertical dimension of the box padding area. A value of
0%means the top edge of the image is aligned with the box's top padding edge and a value of100%means the bottom edge of the image is aligned with the box's bottom padding edge. top- Equivalent to
0%. bottom- Equivalent to
100%. center- Equivalent to
50%.
Formal syntax
[ <length-percentage> | top | center | bottom ]#where
<length-percentage> = <length> | <percentage>
Examples
.exampleOne {
-webkit-mask-image: url(mask.png);
-webkit-mask-position-y: bottom;
}
.exampleTwo {
-webkit-mask-image: url(mask.png);
-webkit-mask-position-y: 25%;
}
Specifications
Not part of any specification.
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | 1.0 | No support | No support | No support | 4.0 |
| Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | ? | No support | No support | No support | ? |
See also
-webkit-mask-position, -webkit-mask-position-x, -webkit-mask-origin, -webkit-mask-attachment
Document Tags and Contributors
Tags:
Contributors to this page:
wbamberg,
Sebastianz
Last updated by:
wbamberg,