DEV Community

Stephanie Eckles
Stephanie Eckles

Posted on

How to Create an Animated SVG Face With CSS

Learn how to create an animated SVG face using CSS animations, transforms, and an optional pinch of JavaScript.

This is an isolated demo of the animations in use for, my web app where you can learn about accessible button contrast then generate your own accessible button color palette.

Here's a preview of the demo that allows you to change Buddy's emotions:

A button with a face SVG and 3 radio button options for "Excited" (checked), "Happy" and "Sad". Selecting a radio button changes the face to the corresponding emotion. The face periodically also winks its left eye.

Create the SVG Face

We can achieve a basic face using two SVG elements:

  • two ellipse for the eyes
  • one path for the mouth

But first we need our base SVG element, for which we'll include the viewBox attribute which acts like a window into the SVG and provides hints at the SVG aspect ratio:

<svg viewBox="0 0 100 60"></svg>
Enter fullscreen mode Exit fullscreen mode

Next, we'll add the eyes. These will be nearly identical except for the cx attribute, which moves the position of the ellipse along the x-axis.

<svg viewBox="0 0 100 60">
  <ellipse cx="15" cy="12" rx="8" ry="9" class="eye right-eye" fill="currentColor" />
  <ellipse cx="80" cy="12" rx="8" ry="9" class="eye left-eye" fill="currentColor" />
Enter fullscreen mode Exit fullscreen mode

We add fill="currentColor" so that the color defaults to the text color of the SVG's nearest ancestor.

You can review the MDN docs on ellipse for more info on the other attributes.

Finally, we add a path for the smile:

<svg viewBox="0 0 100 60">
  <!-- (ellipses) -->
    d="M30 40 c0 20, 40 20, 40 0" 
    fill="currentColor" stroke="currentColor" />
Enter fullscreen mode Exit fullscreen mode

Let's break down the attributes:

  • stroke-linecap="round" - this changes the default "end" of the path stroke from square to provide a softer end. This will be most obvious for the "happy" and "sad" emotions.
  • fill and stroke - we again use currentColor as described for the ellipses. Using it for fill creates the appearance of an open-mouth smile for our default emotion of "Excited".
  • d - this is what draws the path.
    1. M30 40 positions the starting point (left point of the smile) at position 30 on the x-axis and position 40 on the y-axis. This is relative to our viewBox.
    2. Next we create a curve - c - by creating x y pairs. Every two numbers are a pair, so 0 20 means 0x 20y. These are relative to the M values, and create control points for the SVG to draw Bézier curves as described in the MDN docs.

Here's the face with the Bézier curve control points visualized:

The SVG face with four red dots over and around the mouth, one in the top left, one 30% across and ~5% below, one 60% across and ~5% below, and the last in the top right

Styling the Emotions

Our first emotion, "Excited", is the default state as mentioned.

For both "Happy" and "Sad", we want to remove the fill on path to change the mouth appearance to a closed-mouth smile. We'll also increase the stroke-width:

svg.happy path,
svg.sad path {
  fill: transparent;
  stroke-width: 6px;
Enter fullscreen mode Exit fullscreen mode

The full demo shows how to use clamp for a more dynamically sized stroke-width and button font-size.

For sad, we need to flip the smile upside down, and we can quickly accomplish this with a CSS transform:

svg.sad path {
  transform: scaleY(-1);
  transform-origin: 50% 80%;
Enter fullscreen mode Exit fullscreen mode

Where scaleY(-1) horizontally flips the element. Since we have multiple elements within the SVG, we had to also use transform-origin to make sure the transform of the path was relative to it's original location. TBH, this took a little trial and error to find these values :)

In the demo, you'll also see a transition added to enable smoothly moving from one emotion to the next. Altogether, these properties allow simple but effective animations without the need to pull in an animation framework.

Animating the Wink

The wink also uses a transform but within an animation setup with @keyframes. We alternate between a "squint", which is achieved by flattening the eye ellipse, and fully open to produce the wink effect:

@keyframes wink {
  70% {
    transform: scale(1.5, 0.25);

  100% {
    transform: scale(1);
Enter fullscreen mode Exit fullscreen mode

The squint uses a classic animation trick similar to a ball squish that simultaneously slightly widens the element (1.5) while also reducing it's height (0.25) within the scale function. Those numbers are proportions of the computed element size. So to bring it back to the original size, we update the values both to 1 (since it's the same for both, we can define it with a single number).

To apply the wink animation uses the following CSS rule:

svg.wink .eye:last-of-type {
  /* Ensure the default element is at normal scale */
  transform: scale(1);
  transform-origin: 90% 20%;
  animation: wink 480ms ease-in-out 1;
Enter fullscreen mode Exit fullscreen mode

Again we had to adjust the transform-origin for the same reasons as discussed for the smile path.

We applied the animation with a duration of 480ms, an easing function of ease-in-out, and play it 1 time.

But you may have noticed in the preview gif at the beginning (or if you skipped to the demo) that the wink repeats every so often. For this, we need to add in a bit of JavaScript to re-trigger the animation.

The very minimal Javascript finds the SVG element, then uses setInterval to add the wink class every 5000 milliseconds (5 seconds).

Importantly, we add an event listener attached to animationend to remove the wink class. Adding and removing the wink class allows restarting the animation at the interval.

const buddy = document.querySelector(".buddy svg");

setInterval(() => {
}, 5000);

// Remove the wink class to reset the animation after it ends
buddy.addEventListener("animationend", () => {
Enter fullscreen mode Exit fullscreen mode

The demo includes an extra check to only allow adding the wink class if Buddy isn't "Sad".


You can review the full demo in this CodePen, and then check out to create your own accessible button color palette!

If you enjoyed this tutorial and ButtonBuddy, check out my other CSS resources at and consider buying me a coffee.

Top comments (6)

jwp profile image
John Peters

Excellent Stephanie, any tips on how to debug ViewBox issues, I always have trouble with that part.

jh3y profile image
Jhey Tompkins

If you set a solid background color to the SVG and then set the overflow to visible. You can see more clearly which parts of the SVG the viewBox is showing 👍

svg {
  background-color: red;
  overflow: visible;
Enter fullscreen mode Exit fullscreen mode
5t3ph profile image
Stephanie Eckles

I am actually pretty novice when it comes to SVG - I learned a lot myself trying to do this face, which is why I wanted to share it as reference :) For viewbox specifically, check out this amazing interactive explainer:

chinedu profile image
chinedu | ddevguys

Wow. Such creativity. Love it absolutely! This article is worth sharing!

harshhhdev profile image
Harsh Singh

Yours posts are awesome. I have learned so much from them, keep it up!

5t3ph profile image
Stephanie Eckles

Thanks, I'm glad to hear that! 💫