rick@tillitsdone.com

+66824564755

Scroll to discover

CSS Mask-Repeat Controlling Mask Image Repetition

Discover how to use the CSS mask-repeat property to control the repetition of mask images.

Learn about the various options available for horizontal, vertical, and no-repeat behavior.

Introduction

The mask-repeat CSS property controls how mask images are repeated within an element. It lets you decide if the image repeats along the horizontal axis, vertical axis, both, or not at all. By default, images are clipped to fit the element’s size, but you can also scale or distribute them evenly.

This feature became available in December 2023 and works well on the latest devices and browsers, though it might not function on older ones.

Description

The mask-repeat property controls how mask images repeat within an element. You can specify repetition along the horizontal axis, vertical axis, both, or none at all. By default, images are clipped to fit the element, but you can scale them or distribute them evenly.

Syntax

The mask-repeat property accepts one or more <repeat-style> values, separated by commas.

/* One-value syntax */
mask-repeat: repeat-x;
mask-repeat: repeat-y;
mask-repeat: repeat;
mask-repeat: space;
mask-repeat: round;
mask-repeat: no-repeat;

/* Two-value syntax: horizontal | vertical */
mask-repeat: repeat space;
mask-repeat: repeat repeat;
mask-repeat: round space;
mask-repeat: no-repeat round;

/* Multiple values */
mask-repeat:
  space round,
  no-repeat;
mask-repeat:
  round repeat,
  space,
  repeat-x;

/* Global values */
mask-repeat: inherit;
mask-repeat: initial;
mask-repeat: revert;
mask-repeat: revert-layer;
mask-repeat: unset;

One-value Syntax

repeat-x: Equivalent to repeat no-repeat
repeat-y: Equivalent to no-repeat repeat
repeat: Equivalent to repeat repeat
space: Equivalent to space space
round: Equivalent to round round
no-repeat: Equivalent to no-repeat no-repeat

Two-value Syntax

The first value is for horizontal repetition, and the second is for vertical repetition.

Multiple Values

You can set different <repeat-style> values for multiple mask images by separating them with commas.

Global Values

The property also accepts global values like inherit, initial, revert, revert-layer, and unset.

Values

The mask-repeat property accepts several values to control repetition:

One-value Syntax

Value	Description
`repeat-x`	The image repeats horizontally but not vertically.
`repeat-y`	The image repeats vertically but not horizontally.
`repeat`	The image repeats both horizontally and vertically.
`space`	The image repeats without clipping, with whitespace evenly distributed.
`round`	The image is stretched or compressed to fit the space without gaps.
`no-repeat`	The image does not repeat.

Two-value Syntax

Value	Horizontal Behavior	Vertical Behavior
`repeat`	The image repeats as much as needed to cover the width. The last image may be clipped if it doesn’t fit.	The image repeats as much as needed to cover the height. The last image may be clipped if it doesn’t fit.
`space`	The image repeats without clipping, with whitespace evenly distributed.	The image repeats without clipping, with whitespace evenly distributed.
`round`	The image is stretched or compressed to fit the space without gaps.	The image is stretched or compressed to fit the space without gaps.
`no-repeat`	The image does not repeat.	The image does not repeat.

Examples

Setting Repeat for a Single Mask

Example 1: Using repeat-x

Repeats a mask image horizontally.

<!DOCTYPE html>
<html>
<head>
    <style>
        .example-one {
            width: 40%;
            height: 80px;
            background: green;
            -webkit-mask-image: url("image.svg");
            mask-repeat: repeat-x;
        }
    </style>
</head>
<body>
    <div class="example-one"></div>
</body>
</html>

Example 2: Using space repeat

Repeats the mask image horizontally with evenly distributed whitespace and vertically as much as needed.

<!DOCTYPE html>
<html>
<head>
    <style>
        .example-two {
            width: 40%;
            height: 80px;
            background: green;
            -webkit-mask-image: url("image.svg");
            mask-repeat: space repeat;
        }
    </style>
</head>
<body>
    <div class="example-two"></div>
</body>
</html>

Multiple Mask Image Support

Example 3: Using Multiple Mask Images

Sets different repeat styles for multiple mask images.

<!DOCTYPE html>
<html>
<head>
    <style>
        .example-three {
            width: 40%;
            height: 80px;
            background: green;
            -webkit-mask-image: url("mask1.png"), url("mask2.png");
            mask-repeat: repeat-x, repeat-y;
        }
    </style>
</head>
<body>
    <div class="example-three"></div>
</body>
</html>

Formal Definition

Initial Value: repeat
Applies To: All elements
Inherited: No
Computed Value: Two keywords (horizontal and vertical)
Animation Type: Discrete

Formal Syntax

mask-repeat = <repeat-style>[#]

<repeat-style> = repeat-x | repeat-y | [repeat | space | round | no-repeat]{1,2}

Browsers Supported

Chrome 1
Firefox 53
Safari 15.4
Opera 15
Edge 79
Internet Explorer (Not Supported)

By understanding these examples, you can effectively control the repetition of mask images, enhancing the visual appeal of your web pages.

Latest Blogs

Discover our top articles, selected to support the growth of your business.

https://imgproxy-landing-page.tillitsdone.com/sig/rs:fit:1200:630/plain/https%3A%2F%2Fcms-r2.tillitsdone.com%2Fwp-content-prod%2Fuploads%2F2025%2F10%2FTill-its-done_SEO_R43_Sep_1440x697.jpg@webp

สร้างเว็บไซต์ 1 เว็บ ต้องใช้งบเท่าไหร่? เจาะลึกทุกองค์ประกอบ website development cost อยากสร้างเว็บไซต์แต่ไม่มั่นใจในเรื่องของงบประมาณ อ่านสรุปเจาะลึกตั้งแต่ดีไซน์, ฟังก์ชัน และการดูแล พร้อมตัวอย่างงบจริงจาก Till it’s done ที่แผนชัด งบไม่บานปลายแน่นอน

Next.js สอน 14 ขั้นตอนเบื้องต้น: สร้างโปรเจกต์แรกใน 30 นาที เริ่มต้นกับ Next.js ใน 14 ขั้นตอนเพียงแค่ 30 นาที พร้อม SSR/SSG และ API Routes ด้วยตัวอย่างโค้ดง่าย ๆ อ่านต่อเพื่อสร้างโปรเจ็กต์แรกได้ทันทีที่นี่

วิธีสมัคร Apple Developer Account เพื่อนำแอปขึ้น App Store ทีละขั้นตอน อยากปล่อยแอปบน App Store ระดับโลก มาอ่านคู่มือสมัคร Apple Developer Account พร้อมเคล็ดลับ TestFlight และวิธีอัปโหลดที่ง่ายในบทความเดียวนี้ได้เลย

TypeScript Interface คืออะไร? อธิบายพร้อมวิธีใช้และข้อแตกต่างจาก Type เรียนรู้วิธีใช้ TypeScript Interface เพื่อสร้างโครงสร้างข้อมูลที่ปลอดภัยและเข้าใจง่าย พร้อมเปรียบเทียบข้อดีข้อแตกต่างกับ Type ที่คุณต้องรู้ ถูกรวมเอาไว้ในบทความนี้แล้ว

Material-UI (MUI) คืออะไร อยากสร้าง UI สวยงามและเป็นมืออาชีพในเวลาอันรวดเร็วใช่ไหม มาทำความรู้จักกับ Material-UI (MUI) ที่ช่วยให้คุณพัฒนาแอปพลิเคชันบน React ได้ง่ายและดูดีในทุกอุปกรณ์

เปรียบเทียบ 3 วิธีติดตั้ง install node js บน Ubuntu: NVM vs NodeSource vs Official Repo แบบไหนดีที่สุด? เรียนรู้วิธีติดตั้ง Node.js บน Ubuntu ด้วย NVM, NodeSource หรือ Official Repo เลือกวิธีที่เหมาะกับความต้องการของคุณ พร้อมเปรียบเทียบ เพื่อการพัฒนาที่มีประสิทธิภาพ!

View all 1242 blogs

พูดคุยกับซีอีโอ

พร้อมที่จะสร้างเว็บ/แอปของคุณให้มีชีวิตชีวาหรือเสริมทีมของคุณด้วยนักพัฒนาชาวไทยผู้เชี่ยวชาญหรือไม่?

ติดต่อเราวันนี้เพื่อหารือเกี่ยวกับความต้องการของคุณ แล้วมาสร้างโซลูชันที่ปรับแต่งเพื่อบรรลุเป้าหมายของคุณกัน เรายินดีช่วยเหลือทุกขั้นตอน!

🖐️ Contact us

Explore our best articles, cover a wide variety of technologies

Our knowledge base