CSS - offset Property

The CSS shorthand property offset makes it easier for an element to animate along a certain path.

  • It has many characteristics that together comprise an offset transform.

  • With this transform, a specified point inside the element (offset-anchor) is aligned to a certain path position (offset-position) at various points along the route (offset-distance).

  • It also allows the element to be optionally rotated (offset-rotate) to follow the path's direction.

Constituent Properties

The offset property is a shorthand for the following CSS properties:

Possible Values

The following list of values is accepted by offset shorthand property.

  • offset-anchor - Defines a point within the element that aligns with an offset position on the path.

  • offset-path - Defines the path along which the element is animated.

  • offset-distance - Defines how far along the path the element is placed.

  • offset-rotate - Optionally rotates the element to align with the direction of the path.

  • auto - All properties are reset to their default values.

Applies to

Transformable elements

Syntax

offset = [ <'offset-position'>? [ <'offset-path'> [ <'offset-distance'> || <'offset-rotate'> ]? ]? ]! [ / <'offset-anchor'> ]?

CSS offset - path value

The following example demonstrates the usage of offset shorthand property with path value.

       
<html>
<head>
<style>
    @keyframes slide {
        0% {
            offset-distance: 0%;
        }
        100% {
            offset-distance: 100%;
        }
    }
    .container {
        width: 400px;
        height: 200px;
        border: 2px solid #3498db;
        border-radius: 10px;
        position: relative;
        overflow: hidden;
        background-color: #f0f0f0;
        box-shadow: 0 10px 20px rgba(0, 0, 0, 0.5);
    }
    .text {
        position: absolute;
        font-size: 28px;
        color: #3954cc;
        animation: slide 6s ease-in-out infinite alternate;
        offset: path('M 10 100 Q 50 50 90 100 T 170 100 T 250 100');
        text-shadow: 1px 1px 2px rgba(0, 0, 0, 0.4);
    }
</style>
</head>
<body>
<div class="container">
    <div class="text">This is Sliding Text</div>
</div>
</body>
</html>

CSS offset - path and auto value

The following example demonstrates the usage of offset shorthand property with path and auto value.

<html>
<head>
<style>
    @keyframes orbit {
        0% {
            offset-distance: 0%;
            offset-rotate: 0deg;
        }
        100% {
            offset-distance: 100%;
            offset-rotate: 360deg;
        }
    }
    #planet {
        width: 60px;
        height: 60px;
        background-color: #0000A0;
        border-radius: 50%;
        position: absolute;
        animation: orbit 6s linear infinite;
        offset: path('M 200 200 m -100, 0 a 100,100 0 1,0 200,0 a 100,100 0 1,0 -200,0') auto;
    }
    #sun {
        width: 100px;
        height: 100px;
        background-color: #ffd700;
        border-radius: 50%;
        position: absolute;
        left: 28%;
        top: 33%;
        transform: translate(-50%, -50%);
    }
</style>
</head>
<body>
<div id="sun"></div>
<div id="planet"></div>
</body>
</html>

CSS Offset - Related Properties

Following table lists related properties to offset property:

Property Description
offset-anchor Specifies the position inside an element's box that acts as the offset path.
offset-distance Specifies where element should be positioned.
offset-path Specifies element's path inside its parent container.
offset-rotate Specifies the orientation or direction of an element as it moves along the specified offset-path.
offset-position Provide an element's starting location along a route.
Advertisements