初始化 antd-pro

admin-web/src/components/AvatarList/AvatarItem.d.ts

@@ -0,0 +1,10 @@
+import * as React from 'react';
+export interface IAvatarItemProps {
+  tips: React.ReactNode;
+  src: string;
+  style?: React.CSSProperties;
+}
+
+export default class AvatarItem extends React.Component<IAvatarItemProps, any> {
+  constructor(props: IAvatarItemProps);
+}

admin-web/src/components/AvatarList/demo/maxLength.md

@@ -0,0 +1,24 @@
+---
+order: 0
+title: 
+  zh-CN: 要显示的最大项目 
+  en-US: Max Items to Show
+---
+
+`maxLength` attribute specifies the maximum number of items to show while `excessItemsStyle` style the excess
+item component.
+
+````jsx
+import AvatarList from 'ant-design-pro/lib/AvatarList';
+
+ReactDOM.render(
+  <AvatarList size="mini" maxLength={3} excessItemsStyle={{ color: '#f56a00', backgroundColor: '#fde3cf' }}>
+    <AvatarList.Item tips="Jake" src="https://gw.alipayobjects.com/zos/rmsportal/zOsKZmFRdUtvpqCImOVY.png" />
+    <AvatarList.Item tips="Andy" src="https://gw.alipayobjects.com/zos/rmsportal/sfjbOqnsXXJgNCjCzDBL.png" />
+    <AvatarList.Item tips="Niko" src="https://gw.alipayobjects.com/zos/rmsportal/kZzEzemZyKLKFsojXItE.png" />
+    <AvatarList.Item tips="Niko" src="https://gw.alipayobjects.com/zos/rmsportal/kZzEzemZyKLKFsojXItE.png" />
+    <AvatarList.Item tips="Niko" src="https://gw.alipayobjects.com/zos/rmsportal/kZzEzemZyKLKFsojXItE.png" />
+    <AvatarList.Item tips="Niko" src="https://gw.alipayobjects.com/zos/rmsportal/kZzEzemZyKLKFsojXItE.png" />
+  </AvatarList>
+, mountNode);
+````

admin-web/src/components/AvatarList/demo/simple.md

@@ -0,0 +1,20 @@
+---
+order: 0
+title: 
+  zh-CN: 基础样例 
+  en-US: Basic Usage
+---
+
+Simplest of usage.
+
+````jsx
+import AvatarList from 'ant-design-pro/lib/AvatarList';
+
+ReactDOM.render(
+  <AvatarList size="mini">
+    <AvatarList.Item tips="Jake" src="https://gw.alipayobjects.com/zos/rmsportal/zOsKZmFRdUtvpqCImOVY.png" />
+    <AvatarList.Item tips="Andy" src="https://gw.alipayobjects.com/zos/rmsportal/sfjbOqnsXXJgNCjCzDBL.png" />
+    <AvatarList.Item tips="Niko" src="https://gw.alipayobjects.com/zos/rmsportal/kZzEzemZyKLKFsojXItE.png" />
+  </AvatarList>
+, mountNode);
+````

admin-web/src/components/AvatarList/index.d.ts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import AvatarItem from './AvatarItem';
+
+export interface IAvatarListProps {
+  size?: 'large' | 'small' | 'mini' | 'default';
+  maxLength?: number;
+  excessItemsStyle?: React.CSSProperties;
+  style?: React.CSSProperties;
+  children: React.ReactElement<AvatarItem> | Array<React.ReactElement<AvatarItem>>;
+}
+
+export default class AvatarList extends React.Component<IAvatarListProps, any> {
+  public static Item: typeof AvatarItem;
+}

admin-web/src/components/AvatarList/index.en-US.md

@@ -0,0 +1,24 @@
+---
+title: AvatarList
+order: 1
+cols: 1
+---
+
+A list of user's avatar for project or group member list frequently. If a large or small AvatarList is desired, set the `size` property to either `large` or `small` and `mini` respectively. Omit the `size` property for a AvatarList with the default size.
+
+## API
+
+### AvatarList
+
+| Property         | Description           | Type                               | Default   |
+| ---------------- | --------------------- | ---------------------------------- | --------- |
+| size             | size of list          | `large`、`small` 、`mini`, `default` | `default` |
+| maxLength        | max items to show     | number                             | -         |
+| excessItemsStyle | the excess item style | CSSProperties                      | -         |
+
+### AvatarList.Item
+
+| Property | Description                                  | Type      | Default |
+| -------- | -------------------------------------------- | --------- | ------- |
+| tips     | title tips for avatar item                   | ReactNode | -       |
+| src      | the address of the image for an image avatar | string    | -       |

admin-web/src/components/AvatarList/index.js

@@ -0,0 +1,61 @@
+import React from 'react';
+import { Tooltip, Avatar } from 'antd';
+import classNames from 'classnames';
+
+import styles from './index.less';
+
+const avatarSizeToClassName = size =>
+  classNames(styles.avatarItem, {
+    [styles.avatarItemLarge]: size === 'large',
+    [styles.avatarItemSmall]: size === 'small',
+    [styles.avatarItemMini]: size === 'mini',
+  });
+
+const AvatarList = ({ children, size, maxLength, excessItemsStyle, ...other }) => {
+  const numOfChildren = React.Children.count(children);
+  const numToShow = maxLength >= numOfChildren ? numOfChildren : maxLength;
+
+  const childrenWithProps = React.Children.toArray(children)
+    .slice(0, numToShow)
+    .map(child =>
+      React.cloneElement(child, {
+        size,
+      })
+    );
+
+  if (numToShow < numOfChildren) {
+    const cls = avatarSizeToClassName(size);
+
+    childrenWithProps.push(
+      <li key="exceed" className={cls}>
+        <Avatar size={size} style={excessItemsStyle}>{`+${numOfChildren - maxLength}`}</Avatar>
+      </li>
+    );
+  }
+
+  return (
+    <div {...other} className={styles.avatarList}>
+      <ul> {childrenWithProps} </ul>
+    </div>
+  );
+};
+
+const Item = ({ src, size, tips, onClick = () => {} }) => {
+  const cls = avatarSizeToClassName(size);
+
+  return (
+    <li className={cls} onClick={onClick}>
+      {tips ? (
+        <Tooltip title={tips}>
+          <Avatar src={src} size={size} style={{ cursor: 'pointer' }} />
+        </Tooltip>
+      ) : (
+        <Avatar src={src} size={size} />
+      )}
+    </li>
+  );
+};
+
+AvatarList.Item = Item;
+
+export default AvatarList;

admin-web/src/components/AvatarList/index.less

@@ -0,0 +1,50 @@
+@import '~antd/lib/style/themes/default.less';
+
+.avatarList {
+  display: inline-block;
+  ul {
+    display: inline-block;
+    margin-left: 8px;
+    font-size: 0;
+  }
+}
+
+.avatarItem {
+  display: inline-block;
+  width: @avatar-size-base;
+  height: @avatar-size-base;
+  margin-left: -8px;
+  font-size: @font-size-base;
+  :global {
+    .ant-avatar {
+      border: 1px solid #fff;
+    }
+  }
+}
+
+.avatarItemLarge {
+  width: @avatar-size-lg;
+  height: @avatar-size-lg;
+}
+
+.avatarItemSmall {
+  width: @avatar-size-sm;
+  height: @avatar-size-sm;
+}
+
+.avatarItemMini {
+  width: 20px;
+  height: 20px;
+  :global {
+    .ant-avatar {
+      width: 20px;
+      height: 20px;
+      line-height: 20px;
+
+      .ant-avatar-string {
+        font-size: 12px;
+        line-height: 18px;
+      }
+    }
+  }
+}

admin-web/src/components/AvatarList/index.test.js

@@ -0,0 +1,29 @@
+import React from 'react';
+import range from 'lodash/range';
+import { mount } from 'enzyme';
+import AvatarList from './index';
+
+const renderItems = numItems =>
+  range(numItems).map(i => (
+    <AvatarList.Item
+      key={i}
+      tips="Jake"
+      src="https://gw.alipayobjects.com/zos/rmsportal/zOsKZmFRdUtvpqCImOVY.png"
+    />
+  ));
+
+describe('AvatarList', () => {
+  it('renders all items', () => {
+    const wrapper = mount(<AvatarList>{renderItems(4)}</AvatarList>);
+    expect(wrapper.find('AvatarList').length).toBe(1);
+    expect(wrapper.find('Item').length).toBe(4);
+    expect(wrapper.findWhere(node => node.key() === 'exceed').length).toBe(0);
+  });
+
+  it('renders max of 3 items', () => {
+    const wrapper = mount(<AvatarList maxLength={3}>{renderItems(4)}</AvatarList>);
+    expect(wrapper.find('AvatarList').length).toBe(1);
+    expect(wrapper.find('Item').length).toBe(3);
+    expect(wrapper.findWhere(node => node.key() === 'exceed').length).toBe(1);
+  });
+});

admin-web/src/components/AvatarList/index.zh-CN.md

@@ -0,0 +1,25 @@
+---
+title: AvatarList
+subtitle: 用户头像列表
+order: 1
+cols: 1
+---
+
+一组用户头像，常用在项目/团队成员列表。可通过设置 `size` 属性来指定头像大小。
+
+## API
+
+### AvatarList
+
+| 参数               | 说明       | 类型                                 | 默认值       |
+| ---------------- | -------- | ---------------------------------- | --------- |
+| size             | 头像大小     | `large`、`small` 、`mini`, `default` | `default` |
+| maxLength        | 要显示的最大项目 | number                             | -         |
+| excessItemsStyle | 多余的项目风格  | CSSProperties                      | -         |
+
+### AvatarList.Item
+
+| 参数   | 说明     | 类型        | 默认值 |
+| ---- | ------ | --------- | --- |
+| tips | 头像展示文案 | ReactNode | -   |
+| src  | 头像图片连接 | string    | -   |