feat: implement avatar component

src/static/icons/index.ts

@@ -11,3 +11,4 @@ export { default as IconPlus } from './plus.svg';
 export { default as IconSearch } from './search.svg';
 export { default as IconFilledUnchecked } from './check-filled-unchecked.svg';
 export { default as IconSpinner } from './spinner.svg';
+export { default as IconProfile } from './profile.svg';

src/ui/atoms/avatar/index.tsx

@@ -0,0 +1,43 @@
+import React from 'react';
+import styled from 'styled-components';
+import { IconProfile } from 'static/icons';
+
+import { useImageLoad } from './use-image-load';
+
+const AvatarContainer = styled.div`
+  --local-size: calc((var(--woly-component-level) + 2) * 2 * var(--woly-const-m));
+
+  width: var(--local-size);
+  height: var(--local-size);
+
+  & > * {
+    width: 100%;
+    height: 100%;
+
+    border-radius: 50%;
+  }
+`;
+
+interface AvatarProps {
+  alt?: string;
+  src?: string;
+  srcSet?: string;
+  children?: React.ReactNode;
+}
+
+export const Avatar: React.FC<AvatarProps> = ({ alt, src, srcSet, children: childrenProp }) => {
+  const loadFailed = useImageLoad({ src, srcSet });
+  const hasImg = src || srcSet;
+  let children = null;
+
+  if (hasImg && !loadFailed) {
+    children = <img alt={alt} src={src} srcSet={srcSet} />;
+  } else if (childrenProp) {
+    children = childrenProp;
+  } else {
+    // render fallback if image loading failed or no src attributes / children provided
+    children = <IconProfile />;
+  }
+
+  return <AvatarContainer>{children}</AvatarContainer>;
+};

src/ui/atoms/avatar/usage.mdx

@@ -0,0 +1,73 @@
+---
+name: avatar
+category: atoms
+package: woly
+---
+
+import {Avatar} from 'ui'
+import {Playground, block} from 'lib/playground'
+
+`Avatar` shows user avatar
+
+### Example
+
+<Playground>
+  <Avatar src="https://image.flaticon.com/icons/png/512/168/168726.png" />
+</Playground>
+
+### Sizes
+
+<Playground>
+  <block.N>
+    <Avatar src="https://image.flaticon.com/icons/png/512/168/168726.png" />
+  </block.N>
+  <block.S>
+    <Avatar src="https://image.flaticon.com/icons/png/512/168/168726.png" />
+  </block.S>
+  <block.M>
+    <Avatar src="https://image.flaticon.com/icons/png/512/168/168726.png" />
+  </block.M>
+  <block.L>
+    <Avatar src="https://image.flaticon.com/icons/png/512/168/168726.png" />
+  </block.L>
+  <block.XL>
+    <Avatar src="https://image.flaticon.com/icons/png/512/168/168726.png" />
+  </block.XL>
+  <block.H>
+    <Avatar src="https://image.flaticon.com/icons/png/512/168/168726.png" />
+  </block.H>
+</Playground>
+
+### Fallback
+
+<Playground>
+  <Avatar src="http://broken.url/image" />
+</Playground>
+
+### Custom child component
+
+<Playground>
+  <Avatar>
+    <div
+      style={{
+        display: 'flex',
+        justifyContent: 'center',
+        alignItems: 'center',
+        backgroundColor: 'black',
+        color: 'white',
+        fontSize: '20px',
+      }}
+    >
+      RC
+    </div>
+  </Avatar>
+</Playground>
+
+### Props
+
+| Name       | Type              | Default     | Description                              |
+| ---------- | ----------------- | ----------- | ---------------------------------------- |
+| `alt`      | `string`          | `''`        | text description of the image            |
+| `children` | `React.ReactNode` | `undefined` | use if no src attributes provided        |
+| `src`      | `string`          | `''`        | avatar src                               |
+| `srcSet`   | `string`          | `''`        | avatar src set for multiple screen sizes |

src/ui/atoms/avatar/use-image-load.ts

@@ -0,0 +1,35 @@
+import { useEffect, useState } from 'react';
+
+export function useImageLoad({ src, srcSet }: { src?: string; srcSet?: string }) {
+  const [failed, setFailed] = useState(false);
+
+  useEffect(() => {
+    if (!src && !srcSet) {
+      return;
+    }
+
+    setFailed(false);
+
+    const image = new Image();
+    image.src = src ?? '';
+    image.srcset = srcSet ?? '';
+
+    const onLoad = () => {
+      setFailed(false);
+    };
+
+    const onError = () => {
+      setFailed(true);
+    };
+
+    image.addEventListener('load', onLoad);
+    image.addEventListener('error', onError);
+
+    return () => {
+      image.removeEventListener('load', onLoad);
+      image.removeEventListener('error', onError);
+    };
+  }, [src, srcSet]);
+
+  return failed;
+}

src/ui/atoms/index.ts

@@ -16,3 +16,4 @@ export { Text } from './text';
 export { TextArea } from './text-area';
 export { Tooltip } from './tooltip';
 export { UploadArea } from './upload-area';
+export { Avatar } from './avatar';