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:
- offset-anchor
- offset-distance
- offset-path
- offset-position
- offset-rotate
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.
Open Compiler
<html><head><style></style></head><body><div class="container"><div class="text">This is Sliding Text</div></div></body></html>@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); }
CSS offset – path and auto value
The following example demonstrates the usage of offset shorthand property with path and auto value.
Open Compiler
<html><head><style></style></head><body><div id="sun"></div><div id="planet"></div></body></html>@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%); }
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. |
Leave a Reply