4.22.3 • Published 2 years ago

@uiw/react-avatar v4.22.3

Weekly downloads
222
License
MIT
Repository
github
Last release
2 years ago

Avatar 头像

Buy me a coffee Open in unpkg NPM Downloads npm version

用来代表用户或事物,支持图片、图标或字符展示。

import { Avatar } from 'uiw';
// or
import Avatar from '@uiw/react-avatar';

基本用法

头像有四种尺寸,两种形状可选。

import React from 'react';
import { Avatar, Icon } from 'uiw';

export default function Demo() {
  return (
    <div>
      <div style={{ paddingBottom: 20 }}>
        <Avatar size="large" icon={<Icon type="user"/>} />
        <Avatar icon="user" />
        <Avatar size="small" icon="user" />
        <Avatar size="mini" icon={<Icon type="user"/>} />
      </div>
      <div>
        <Avatar shape="square" size="large" icon="user" />
        <Avatar shape="square" icon="user" />
        <Avatar shape="square" size="small" icon="user" />
        <Avatar shape="square" size="mini" icon="user" />
      </div>
    </div>
  )
}

其它类型

支持三种类型:Icon 以及字符,其中 Icon 和字符型可以自定义图标颜色及背景色。

import React from 'react';
import { Avatar, Icon } from 'uiw';

export default function Demo() {
  return (
    <div>
      <Avatar icon={<Icon type="user"/>} />
      <Avatar>U</Avatar>
      <Avatar src="https://avatars2.githubusercontent.com/u/1680273?s=40&v=4" />
      <Avatar style={{ color: '#f56a00', backgroundColor: '#fde3cf' }}>U</Avatar>
      <Avatar style={{ backgroundColor: '#87d068' }} icon="user" />
    </div>
  )
}

图片支持

在组件上使用onError事件,处理显示错误的图片。

import React from 'react';
import { Avatar, Icon } from 'uiw';

const App = () => {
  const [src, setSrc] = React.useState('https://avatars2.githubusercontent.com/ua/1680273?s=40&v=4')
  return (
    <div>
      <Avatar
        src='https://avatars2.githubusercontent.com/ua/1680273?s=40&v=4'
        onError={(e) => {
          if (e) {
            e.target.src = 'https://avatars2.githubusercontent.com/u/1680275?s=40&v=4'
          }
          return false;
        }}
      />
      <Avatar
        src={src}
        onError={(e) => {
          if (e) {
            setSrc('https://avatars2.githubusercontent.com/u/1680275?s=40&v=4');
          }
        }}
      />
    </div>
  )
}

export default App;

带徽标的头像

import React from 'react';
import { Avatar, Badge } from 'uiw';

export default function Demo() {
  return (
    <div>
      <span style={{ marginRight: 24 }}>
        <Badge count={1}><Avatar shape="square" icon="user" /></Badge>
      </span>
      <span>
        <Badge dot><Avatar shape="square" icon="user" /></Badge>
      </span>
    </div>
  )
}

Props

参数说明类型默认值
icon设置头像的图标类型,参考 Icon 组件String、ReactNode-
shape指定头像的形状 square 正方形或者 circleEnum{'circle', 'square' }-
size设置头像的大小Enum{ 'large', 'small','mini', 'default' }default
src图片类头像的资源地址String-
alt规定图像的替代文本String-
onError图片加载失败的事件,返回 false 会关闭组件默认的 fallback 行为() => boolean-
4.22.0

2 years ago

4.22.1

2 years ago

4.22.2

2 years ago

4.22.3

2 years ago

4.21.26

2 years ago

4.21.25

2 years ago

4.21.28

2 years ago

4.21.27

2 years ago

5.0.0-bate.2.1

2 years ago

5.0.0-bate.2.0

2 years ago

4.21.24

2 years ago

5.0.0-bate-19

3 years ago

4.21.22

2 years ago

4.21.21

2 years ago

4.21.23

2 years ago

5.0.0-bate-18

3 years ago

5.0.0-bate-14

3 years ago

5.0.0-bate-17

3 years ago

5.0.0-bate-10

3 years ago

5.0.0-bate-11

3 years ago

5.0.0-bate-12

3 years ago

5.0.0-bate-9

3 years ago

5.0.0-bate-7

3 years ago

5.0.0-bate-8

3 years ago

5.0.0-bate-6

3 years ago

4.21.20

3 years ago

4.21.19

3 years ago

4.21.18

3 years ago

4.21.15

3 years ago

4.21.17

3 years ago

4.21.16

3 years ago

5.0.0-bate-5

3 years ago

5.0.0-bate-3

3 years ago

5.0.0-bate-4

3 years ago

5.0.0-bate-1

3 years ago

5.0.0-bate-2

3 years ago

5.0.0-bate-0

3 years ago

4.21.13

3 years ago

4.21.14

3 years ago

4.21.11

3 years ago

4.21.12

3 years ago

4.21.10

3 years ago

4.21.1

3 years ago

4.21.2

3 years ago

4.21.3

3 years ago

4.21.4

3 years ago

4.21.0

3 years ago

4.20.0

3 years ago

4.21.9

3 years ago

4.21.5

3 years ago

4.21.6

3 years ago

4.21.7

3 years ago

4.21.8

3 years ago

4.18.1

3 years ago

4.18.0

3 years ago

4.17.0

3 years ago

4.16.0

3 years ago

4.16.1

3 years ago

4.16.2

3 years ago

4.19.0

3 years ago

4.15.1

3 years ago

4.14.1

3 years ago

4.14.2

3 years ago

4.14.0

3 years ago

4.13.7

3 years ago

4.13.8

3 years ago

4.13.9

3 years ago

4.13.11

3 years ago

4.13.12

3 years ago

4.13.10

3 years ago

4.15.0

3 years ago

4.10.5

3 years ago

4.10.6

3 years ago

4.10.7

3 years ago

4.9.9

3 years ago

4.10.1

3 years ago

4.10.2

3 years ago

4.10.3

3 years ago

4.10.4

3 years ago

4.10.0

3 years ago

4.13.6

3 years ago

4.13.2

3 years ago

4.13.3

3 years ago

4.13.4

3 years ago

4.13.5

3 years ago

4.13.0

3 years ago

4.13.1

3 years ago

4.12.0

3 years ago

4.12.1

3 years ago

4.12.2

3 years ago

4.11.4

3 years ago

4.11.5

3 years ago

4.11.6

3 years ago

4.9.11

3 years ago

4.9.10

3 years ago

4.11.0

3 years ago

4.11.1

3 years ago

4.11.2

3 years ago

4.11.3

3 years ago

4.9.7

4 years ago

4.9.6

4 years ago

4.9.4

4 years ago

4.9.3

4 years ago

4.9.2

4 years ago

4.9.1

4 years ago

4.9.0

4 years ago

4.8.9

4 years ago

4.8.8

4 years ago

4.7.16

4 years ago

4.8.5

4 years ago

4.8.4

4 years ago

4.8.7

4 years ago

4.8.6

4 years ago

4.8.1

4 years ago

4.8.0

4 years ago

4.8.3

4 years ago

4.8.2

4 years ago

4.7.13

4 years ago

4.7.14

4 years ago

4.7.15

4 years ago

4.7.12

4 years ago

4.7.10

4 years ago

4.7.11

4 years ago

4.7.9

4 years ago

4.7.8

4 years ago

4.7.7

4 years ago

4.7.6

4 years ago

4.7.5

4 years ago

4.7.4

4 years ago

4.7.3

4 years ago

4.7.2

4 years ago

4.7.0

4 years ago

4.6.19

5 years ago

4.6.15

5 years ago

4.6.16

5 years ago

4.6.17

5 years ago

4.6.18

5 years ago

4.6.14

5 years ago

4.6.13

5 years ago

4.6.11

5 years ago

4.6.12

5 years ago

4.6.10

5 years ago

4.6.9

5 years ago

4.6.8

5 years ago

4.6.7

5 years ago

4.6.6

5 years ago

4.6.3

5 years ago

4.6.4

5 years ago

4.6.2

5 years ago

4.6.1

5 years ago

4.6.0

5 years ago

4.5.0

5 years ago

4.4.1

5 years ago

4.4.0

5 years ago

4.3.1

5 years ago

4.2.3

5 years ago

4.2.5

5 years ago

4.3.0

5 years ago

4.2.14

5 years ago

4.2.1

5 years ago

4.2.0

5 years ago

4.1.2

5 years ago

4.1.0

5 years ago

4.1.1

5 years ago

4.0.0

5 years ago

4.0.0-alpha.7

5 years ago

4.0.0-alpha.8

5 years ago

4.0.0-alpha.6

5 years ago

4.0.0-alpha.3

5 years ago

4.0.0-alpha.2

5 years ago

4.0.0-alpha.1

5 years ago

4.0.0-alpha.0

5 years ago