3.4.2 • Published 4 years ago

@txdfe/uiless-member v3.4.2

Weekly downloads
-
License
MIT
Repository
gitlab
Last release
4 years ago
  • 依赖变量

        window.UILessConfig = {
            appId: ctx.app.config.appId, // current appId
            orgId: ctx.app.config.orgId, // current orgId
            accessToken: token, // current access token
            host: 'http://uiless.teambition.aone.alibaba.net', // host
        };

    对接入了tb导航的页面,appId,orgId,accessToken都可以在页面上找到,host需要后端增加一个配置写到页面上

  • 参数列表

参数类型可选值默认值说明
multiplebooltrue/falsefalse是否多选
valuearray[][]当前值
titlestring'''添加成员'标题
customRolesarray[][]是否有角色信息
onChangefunc()=>{}()=>{}人员信息变化回调
onSearchfunc()=> Promise使用自定义数据源dataSource时,传递onSearch 可使用自己的成员接口来搜索, 该函数需要return一个primise,参考示例
dataSourcearray[]null自定义搜索数据源,传递就使用,不传递就接口搜索,自定义数据的结构需要与组件onChange的参数一致
extraMemberTypesarray'team', 'role', 'group'除人员外可选的成员类型: 部门、角色、群组
modestringadd/editadd仅multiple = true 时生效,生效时:edit模式可以反选成员,并在onChange参数中移除该成员(包含传入的value)。 add模式时,不可反选成员,onChange参数中不包含传入的value
loadingboolfalse是否是loading
defaultListstring/arrayuser对象数组/ 'default'/ 'recommend'default组件打开时展示数据,可传递user数组, recommend表示组件根据最近沟通或共同项目计算推荐的成员, default表示组件加载的默认列表
defaultListNamestring成员组件打开时展示列表标题
okTextstring确认确认按钮文案
cancelTextstring取消取消按钮文案
visiblebool控制组件是否展示,传递时为可控, 不传递则使用trigger,由组件自身控制
onVisibleChangefunc不控制组件是否展示时,组件自身visible变化时回调
onRequestClosefunc控制组件是否展示时,点击关闭和取消时调用
messagePropsobject组件顶部的自定义信息,api参考AT.Message
confirmPropsobject点击确定按钮时确认框,type,title,content
useGroupFeaturesbooleanfalse开启后,可配置群组选择,可在角色及群组中选人
  • UilessMemberComponent.Mini

    除以下API,还可使用部分AT.Overlay的API,可尝试使用

参数类型可选值默认值说明
multiplebooltrue/falsefalse是否多选
valuearray[][]当前值
titlestring'''添加成员'标题
customRolesarray[][]是否有角色信息
onChangefunc()=>{}()=>{}人员信息变化回调
onSearchfunc()=> Promise使用自定义数据源dataSource时,传递onSearch 可使用自己的成员接口来搜索, 该函数需要return一个primise,参考示例
dataSourcearray[]null自定义搜索数据源,传递就使用,不传递就接口搜索,自定义数据的结构需要与组件onChange的参数一致
modestringadd/editadd仅multiple = true 时生效,生效时:edit模式可以反选成员,并在onChange参数中移除该成员(包含传入的value)。 add模式时,不可反选成员,onChange参数中不包含传入的value
loadingboolfalse是否是loading
userTagRenderfunc(userObj) => ({ color: 'blue', children: '推荐', ... })用户右侧标签, 函数参数是用户对象, 返回at组件的tag.colorable对象或 null
defaultListstring/arrayuser对象数组/ 'default'/ 'recommend'default组件打开时展示数据,可传递user数组, recommend表示组件根据最近沟通或共同项目计算推荐的成员, default表示组件加载的默认列表
okTextstring确定确定按钮文案
visiblebool控制组件是否展示,传递时为可控, 不传递则使用trigger,由组件自身控制
onVisibleChangefunc不控制组件是否展示时,组件自身visible变化时回调
onRequestClosefunc控制组件是否展示时,点击关闭和取消时调用
alignstring参考组件AT.Overlay align
offsetarray参考组件AT.Overlay offset
safeNodeany参考组件AT.Overlay safeNode
containerany参考组件AT.Overlay container
  • 使用

      import React from 'react';
      import ReactDOM from 'react-dom';
      import Member from '@alife/uiless-member';
      import { Button, Select } from '@alife/at';
      import './index.scss';
    
      const customRoles = [{
        label: 'owner',
        value: 1,
      }, {
        label: 'master',
        value: 2,
      }, {
        label: 'developer',
        value: 3,
      }, {
        label: 'reporter',
        value: 4,
      }];
    
      const value = [{
        _userId: "5c83a71a8449c608dd7378f6",
        name: "王x(昆x)"
      }, {
        _userId: "5c83aee88449c608dd73790a",
        name: "周x雄(拓x)",
        // tag: {
        //   color: 'red',
        //   children: '推荐'
        // }
      }];
    
      class Demo extends React.Component {
        constructor(props) {
          super(props);
          this.state = {
            value: [],
          };
        }
        onChange = (value, customRoleId) => {
          console.log(value, customRoleId);
        }
    
        render() {
          return (
            <div>
              <Member
                trigger={<Button>trigger</Button>}
                onChange={this.onChange}
                multiple
                value={value}
                customRoles={customRoles}
                okText="提交"
                cancelText="取消"
                ready={() => {}} // 传递的value由组件获取完整信息填充数据后调用
                extraMemberTypes={['role', 'team']} //除人员外还可添加的类型: 角色、部门
                messageProps={{ // 不传递则不展示, Api参考At.Message
                  title: '提示信息标题',
                  children: '这是提示信息的描述字段',
                  // visible: true, // 传递visible时,标识可控,可结合onClose,closeable使用
                  closeable: true, // 是否可关闭
                  type: 'notice', //' success', 'warning', 'error', 'notice', 'help', 'loading'
                  // ...At.Message Api
                }}
                confirmProps={{ // 点击确定按钮是否展示确认框,不传递不展示,仅支持以下三个api
                  title: '确认标题',
                  content: '这是确认描述字段',
                  type: 'warning',
                }}
                mode="edit" // 添加模式, edit可再次编辑传递的value, add模式只增, 传递的value禁用
              />
              <Member.Mini
                onChange={this.onChange}
                multiple
                customRoles={customRoles}
                onVisibleChange={(q) => console.log(q)}
                ready={q => console.log('ready', q)}
                trigger={
                    <div>
                      <Select
                        hasArrow={false}
                        mode="multiple"
                        value={value.map((item => item._userId))}
                        visible={false}
                        dataSource={value.map(item => Object.assign(item, { value: item._userId, label: item.name }))}
                      />
                    </div>
                }
              />
            </div>
          );
        }
      }
    
      ReactDOM.render(<Demo />, document.getElementById('demo-container'));
3.4.2

4 years ago

3.4.1

4 years ago

3.4.0

4 years ago

3.3.4

4 years ago

3.3.3

4 years ago

3.3.2

4 years ago

3.3.1

4 years ago

3.3.0

4 years ago

3.2.5

4 years ago

3.2.3

4 years ago

3.2.2

4 years ago

3.2.1

4 years ago

3.2.0

4 years ago

3.0.3

4 years ago

3.0.2

4 years ago

3.0.1

4 years ago

2.0.5

4 years ago

2.0.4

4 years ago

2.0.3

4 years ago

2.0.2

4 years ago

2.0.1

4 years ago

2.0.0

4 years ago