rick@tillitsdone.com

+66824564755

Scroll to discover

CSS mask-position Precise Mask Image Control

The CSS mask-position property allows precise control over mask image positioning.

Use keywords like 'top', 'bottom', 'left', 'right', 'center' or numerical values like percentages or lengths.

Enhance your web designs with flexible and dynamic positioning.

Introduction

The mask-position CSS property allows you to control where mask images are placed. It’s a great tool for web developers, introduced in December 2023, and works well with modern devices and browsers.

With mask-position, you can align masks to specific edges or use percentages for more dynamic positioning. This property helps you create unique designs by controlling mask images easily.

Specification

The mask-position property is part of the CSS Masking Module Level 1. This module helps you create complex visual effects by defining how mask images interact with elements on a web page.

You can find the specification for mask-position in the CSS Masking Module Level 1. Understanding this specification is important for using masking effectively in your projects.

Syntax

The mask-position property uses various values for flexible control over mask image positioning. Here’s the basic syntax:

mask-position: <position>;

Keyword Values

You can use predefined keywords:

mask-position: top;
mask-position: bottom;
mask-position: left;
mask-position: right;
mask-position: center;

Numerical Values

You can also use numerical values:

mask-position: 25% 75%;
mask-position: 0px 0px;
mask-position: 10% 8em;

Multiple Values

To apply multiple positions, separate them with commas:

mask-position: top right;
mask-position: 1rem 1rem, center;

Global Values

Global values provide additional control:

mask-position: inherit;
mask-position: initial;
mask-position: revert;
mask-position: revert-layer;
mask-position: unset;

Values

The mask-position property supports various values to specify the position of mask images.

`<position>`

The <position> value represents a 2D position. It can be keywords or numerical values.

Keywords: top, bottom, left, right, center
Numerical Values: Percentages (25%, 75%) or lengths (0px, 10em)

Multiple Values

You can specify multiple positions by separating them with commas:

mask-position: top right;
mask-position: 1rem 1rem, center;

Global Values

Global values include:

inherit: Inherits from the parent element.
initial: Sets the property to its initial value (0% 0%).
revert: Reverts to the user agent’s default.
revert-layer: Reverts to the value for that layer.
unset: Resets the property to its natural value.

mask-position: inherit;
mask-position: initial;
mask-position: revert;
mask-position: revert-layer;
mask-position: unset;

Formal Definition

The mask-position property is formally defined by its initial value, applicable elements, inheritance behavior, and how percentages and computed values are handled.

Initial Value

The initial value is 0% 0%, positioning the mask image at the top-left corner.

Applies To

Applies to all elements, except <defs> in SVG.

Inherited

Not inherited.

Percentages

Percentages refer to the mask painting area minus the mask layer image size.

Computed Value

Consists of two keywords and two offsets, given as absolute lengths or percentages.

Animation Type

The animation type is a repeatable list.

Formal Syntax

mask-position = <position>[#]

<position> =
  [left | center | right | top | bottom | <length-percentage>]
  [left | center | right] && [top | center | bottom]
  [left | center | right | <length-percentage>] [top | center | bottom | <length-percentage>]
  [left | right] [top | bottom] <length-percentage>

<length-percentage> = <length> | <percentage>

Examples

Using Keyword Values

<!DOCTYPE html>
<html>
<head>
  <style>
    .container {
      border: 3px solid black;
      background-color: rgb(136, 255, 0);
      width: 30%;
      height: 30vh;
    }
    .masked-element {
      width: 30%;
      height: 200px;
      background: green;
      border: 10px solid red;
      -webkit-mask-image: url("image.svg");
      -webkit-mask-repeat: no-repeat;
      mask-position: top;
    }
  </style>
</head>
<body>
  <div class="container">
    <div class="masked-element"></div>
  </div>
</body>
</html>

Using Numerical Values

<!DOCTYPE html>
<html>
<head>
  <style>
    .container {
      border: 3px solid black;
      background-color: rgb(136, 255, 0);
      width: 30%;
      height: 30vh;
    }
    .masked-element {
      width: 30%;
      height: 200px;
      background: green;
      border: 10px solid red;
      -webkit-mask-image: url("image.svg");
      -webkit-mask-repeat: no-repeat;
      mask-position: 0.2rem 30%;
    }
  </style>
</head>
<body>
  <div class="container">
    <div class="masked-element"></div>
  </div>
</body>
</html>

Using Multiple Values

<!DOCTYPE html>
<html>
<head>
  <style>
    .container {
      border: 3px solid black;
      background-color: rgb(136, 255, 0);
      width: 30%;
      height: 30vh;
    }
    .masked-element {
      width: 30%;
      height: 200px;
      background: green;
      border: 10px solid red;
      -webkit-mask-image: url("image1.svg"), url("image2.svg");
      -webkit-mask-repeat: no-repeat, no-repeat;
      mask-position: top right, 1rem 1rem;
    }
  </style>
</head>
<body>
  <div class="container">
    <div class="masked-element"></div>
  </div>
</body>
</html>

Browser Compatibility

The mask-position property is widely supported across modern browsers:

Chrome: Supported from version 1.
Safari: Supported from version 15.4.
Edge: Supported from version 79.
Firefox: Supported from version 53.
Opera: Supported from version 15.
Internet Explorer: Not supported.

Test your pages in multiple browsers and devices to ensure compatibility. Use feature detection techniques to provide fallback solutions for unsupported browsers.

Talk with CEO

Ready to bring your web/app to life or boost your team with expert Thai developers?

Contact us today to discuss your needs, and let’s create tailored solutions to achieve your goals. We’re here to help at every step!

🖐️ Contact us

Explore our best articles, cover a wide variety of technologies

Our knowledge base

UI toolkit for building natively compiled applications for mobile, web, and desktop from a single codebase.

150 Articles

Explore

Nodejs

JavaScript runtime for building scalable, high-performance server-side applications.

60 Articles

Explore

Nextjs

React framework enabling server-side rendering and static site generation for optimized performance.

40 Articles

Explore

Typescript

Superset of JavaScript adding static types for improved code quality and maintainability.

39 Articles

Explore

TailwindCSS

Utility-first CSS framework for rapid UI development.

130 Articles

Explore

Golang

Programming language known for its simplicity, concurrency model, and performance.

70 Articles

Explore

AstroJs

Astro is an all-in-one web framework. It includes everything you need to create a website, built-in.

40 Articles

Explore

Jest

Versatile testing framework for JavaScript applications supporting various test types.

337 Articles

Explore

CSS

CSS3 is the latest version of Cascading Style Sheets, offering advanced styling features like animations, transitions, shadows, gradients, and responsive design.

Let's keep in Touch

Thank you for your interest in Tillitsdone! Whether you have a question about our services, want to discuss a potential project, or simply want to say hello, we're here and ready to assist you.
We'll be right here with you every step of the way.

Contact Information

rick@tillitsdone.com+66824564755

Find All the Ways to Get in Touch with Tillitsdone - We're Just a Click, Call, or Message Away. We'll Be Right Here, Ready to Respond and Start a Conversation About Your Needs.

Address

9 Phahonyothin Rd, Khlong Nueng, Khlong Luang District, Pathum Thani, Bangkok Thailand

Visit Tillitsdone at Our Physical Location - We'd Love to Welcome You to Our Creative Space. We'll Be Right Here, Ready to Show You Around and Discuss Your Ideas in Person.

Social media

Facebook Instagram LinkedIn

Connect with Tillitsdone on Various Social Platforms - Stay Updated and Engage with Our Latest Projects and Insights. We'll Be Right Here, Sharing Our Journey and Ready to Interact with You.

We anticipate your communication and look forward to discussing how we can contribute to your business's success.
We'll be here, prepared to commence this promising collaboration.

DesignRush
web design companies

Goodfirms

CSS mask-position Precise Mask Image Control

Introduction

Specification

Syntax

Keyword Values

Numerical Values

Multiple Values

Global Values

Values

<position>

Multiple Values

Global Values

Formal Definition

Initial Value

Applies To

Inherited

Percentages

Computed Value

Animation Type

Formal Syntax

Examples

Using Keyword Values

Using Numerical Values

Using Multiple Values

Browser Compatibility

See Also

Talk with CEO

`<position>`