1
0
mirror of https://github.com/kremalicious/metamask-extension.git synced 2024-12-01 21:57:06 +01:00
metamask-extension/ui/components/component-library/avatar-account/README.mdx
George Marshall 5d5fa242c3
Updating AvatarAccount objects to enums (#17727)
* Updating object to enums

* lint fix

* Improving test coverage

* Updating filename to .types.ts
2023-03-10 12:12:55 -08:00

82 lines
2.2 KiB
Plaintext

import { Story, Canvas, ArgsTable } from '@storybook/addon-docs';
import { AvatarAccount } from './avatar-account';
import { AvatarBase } from '../';
# AvatarAccount
The `AvatarAccount` is a type of avatar reserved for representing accounts.
<Canvas>
<Story id="components-componentlibrary-avataraccount--default-story" />
</Canvas>
## Props
The `AvatarAccount` accepts all props below as well as all [Box](/docs/components-ui-box--default-story#props) component props
<ArgsTable of={AvatarAccount} />
`AvatarAccount` accepts all [AvatarBase](/docs/components-componentlibrary-avatarbase--default-story))
component props
<ArgsTable of={AvatarBase} />
### Size
Use the `size` prop and the `AvatarAccountSize` enum from `../../component-library` to change the size of `AvatarAccount`
Possible sizes include:
- `AvatarAccountSize.Xs` 16px
- `AvatarAccountSize.Sm` 24px
- `AvatarAccountSize.Md` 32px
- `AvatarAccountSize.Lg` 40px
- `AvatarAccountSize.Xl` 48px
Defaults to `AvatarAccountSize.MD`
<Canvas>
<Story id="components-componentlibrary-avataraccount--size" />
</Canvas>
```jsx
import { AvatarAccount, AvatarAccountSize } from '../ui/component-library';
<AvatarAccount size={AvatarAccountSize.Xs} />
<AvatarAccount size={AvatarAccountSize.Sm} />
<AvatarAccount size={AvatarAccountSize.Md} />
<AvatarAccount size={AvatarAccountSize.Lg} />
<AvatarAccount size={AvatarAccountSize.Xl} />
```
### Variant
Use the `variant` prop and the `AvatarAccountVariant` enum from `../../component-library` to change between jazzicon and blockies variants.
<Canvas>
<Story id="components-componentlibrary-avataraccount--variant" />
</Canvas>
```jsx
import { AvatarAccount, AvatarAccountVariant } from '../ui/component-library';
<AvatarAccount variant={AvatarAccountVariant.Jazzicon} />
<AvatarAccount variant={AvatarAccountVariant.Blockies} />
```
### Address
Use the required `address` for generating images
<Canvas>
<Story id="components-componentlibrary-avataraccount--address" />
</Canvas>
```jsx
import { AvatarAccount, AvatarAccountVariant } from '../ui/component-library';
<AvatarAccount variant={AvatarAccountVariant.Jazzicon} address="0x5CfE73b6021E818B776b421B1c4Db2474086a7e1" />
<AvatarAccount variant={AvatarAccountVariant.Blockies} address="0x0" />
```