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-x
CSS property sets the initial horizontal position of a mask image.
/* Keyword values */ -webkit-mask-position-x: left; -webkit-mask-position-x: center; -webkit-mask-position-x: right; /* <percentage> values */ -webkit-mask-position-x: 100%; -webkit-mask-position-x: -50%; /* <length> values */ -webkit-mask-position-x: 50px; -webkit-mask-position-x: -1cm; /* Multiple values values */ -webkit-mask-position-x: 50px, 25%, -3em; /* Global values */ -webkit-mask-position-x: inherit; -webkit-mask-position-x: initial; -webkit-mask-position-x: unset;
Initial value | 0% |
---|---|
Applies to | all elements |
Inherited | no |
Percentages | refer to the size of the box itself |
Computed value | for <length> the absolute value, otherwise a percentage |
Animation type | discrete |
Syntax
Values
<length-percentage>
- A length indicating the position of the left edge of the image relative to the box's left padding edge. Percentages are calculated against the horizontal dimension of the box padding area. That means, a value of
0%
means the left edge of the image is aligned with the box's left padding edge and a value of100%
means the right edge of the image is aligned with the box's right padding edge. left
- Equivalent to
0%
. center
- Equivalent to
50%
. right
- Equivalent to
100%
.
Formal definition
Initial value | 0% |
---|---|
Applies to | all elements |
Inherited | no |
Percentages | refer to the size of the box itself |
Computed value | for <length> the absolute value, otherwise a percentage |
Animation type | discrete |
Formal syntax
[ <length-percentage> | left | center | right ]#where
<length-percentage> = <length> | <percentage>
Examples
Horizontally positioning a mask image
.exampleOne { -webkit-mask-image: url(mask.png); -webkit-mask-position-x: right; } .exampleTwo { -webkit-mask-image: url(mask.png); -webkit-mask-position-x: 25%; }
Specifications
Not part of any standard.
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
-webkit-mask-position-x | Chrome Full support 1 | Edge Full support 18 | Firefox Full support 49 | IE No support No | Opera Full support 15 | Safari Full support 3.2 | WebView Android Full support 2 | Chrome Android Full support 18 | Firefox Android Full support 49 | Opera Android Full support 14 | Safari iOS Full support 3.2 | Samsung Internet Android Full support 1.0 |
Legend
- Full support
- Full support
- No support
- No support
- Non-standard. Expect poor cross-browser support.
- Non-standard. Expect poor cross-browser support.
See also
-webkit-mask-position
, -webkit-mask-position-y
, -webkit-mask-origin
, -webkit-mask-attachment