[TOC]

更新日志：

| 时间 | 类型 | 修改人 | 版本号 | 修改内容 | 具体日志 | | ---------- | ------ | ------ | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------- | --- | | 2019-09-25 | Modify | 任梦飞 | 0.0.15-beta | 修改富文本编辑器 RichText 组件，添加 maxTextLength 属性显示最大可输入值（例如：1/200） | | 2019-09-25 | Modify | 任梦飞 | 0.0.16-beta | 提交编译后的文件。 | | 2019-09-26 | Modify | 任梦飞 | 0.0.17-beta | 修改上传功能 Upload 组件， 添加 iconComponent 属性，支持自定义 Icon 图标，也可以传入空 div 隐藏。 | ./doc/Upload.md | | 2019-09-26 | Modify | 任梦飞 | 0.0.18-beta | 修改上传功能 Upload 组件，iconComponent 属性更名为 upLoadButtonIcon，新增 upLoadButtonProps 支持自定义上传按钮的 props 属性。 | ./doc/Upload.md | | 2019-10-16 | Modify | 任梦飞 | 0.0.19-beta | 修改 KitTable 组件的 rowSelection props 的优先级高于默认值 | ./doc/KitTable.md | | 2019-10-22 | Modify | 任梦飞 | 0.0.20-beta | 修改 KitTable 组件的 rowSelection 的 onChange 优先级不能高于默认值 | ./doc/KitTable.md | | 2019-12-20 | Modify | 任梦飞 | 0.0.23-beta | 修改 KitTable 组件的 selectedRowKeys 在前端分页时切换不会被清空 | ./doc/KitTable.md | | 2019-12-24 | Add | 任梦飞 | 0.0.24-beta | 添加 Form 新组件 KitDoubleSelect, 双下拉组件联动 | —— | | 2019-12-29 | Modify | 任梦飞 | 0.0.25-beta | KitMixComponent 详情模式显示问题修复 | —— | | 2019-12-30 | Modify | 任梦飞 | 0.0.26-beta | KitMixComponent 和 KitDoubleSelect 增加左右两边单独的 onChange 事件 | —— | | 2019-12-30 | Modify | 任梦飞 | 0.0.28-beta | KitMixComponent 和 KitDoubleSelect 修改左右两边 onChange 名称 | —— | | 2019-12-30 | Modify | 任梦飞 | 0.0.29-beta | KitMixComponent 和 KitDoubleSelect 修改左右两边 onChange 互不影响 | —— | | 2019-12-30 | Modify | 任梦飞 | 0.0.30-beta | KitMixComponent 修改 onChange 问题 | —— | | 2020-1-16 | Modify | 吴永松 | 0.0.31-beta | KitUpload 修改 componentWillReceiveProps 空值设置的问题 | —— | | 2020-1-16 | Modify | 任梦飞 | 0.0.32-beta | KitInput 详情时 addonAfter 属性可作为单位返显显示 | —— | | 2020-1-16 | Modify | 任梦飞 | 0.0.33-beta/0.0.34-beta | build 代码并发布 | —— | | 2020-2-11 | Modify | 任梦飞 | 0.0.35-beta | KitForm 增加 compactLayout 属性，开启紧凑布局，display 被隐藏的元素，将不在占据位置 | —— | | 2020-2-13 | Modify | 任梦飞 | 0.0.36-beta | MixComponent 增加 leftHidden、rightHidden 属性，隐藏左右两边组件 | —— | | 2020-2-13 | Modify | 任梦飞 | 0.0.37-beta | KitInput 将 placeholder 添加到默认 title 属性 | —— | | 2020-2-14 | Modify | 任梦飞 | 0.0.38-beta | KitUpload 修复 showButton 显示隐藏逻辑 | —— | | 2020-2-15 | Modify | 任梦飞 | 0.0.39-beta | KitUpload 修复 detail 与 showButton 优先级问题 | —— | | 2020-2-15 | Modify | 任梦飞 | 0.0.40-beta | KitUpload 修复 detail 判断逻辑 | —— | | 2020-2-15 | Modify | 任梦飞 | 0.0.41-beta | KitDoubleSelect 增加 leftHidden、rightHidden 属性，隐藏左右两边组件 | —— | | 2020-2-17 | Modify | 任梦飞 | 0.0.42-beta | 修改 KitTable 组件的 selectedRowKeys 无法被按钮点击清空 | —— | | 2020-2-17 | Modify | 任梦飞 | 0.0.43-beta | 修改 kitking-core 版本依赖 | —— | | 2020-2-28 | Modify | 任梦飞 | 0.0.44-beta | 修改 KitSidebar 没有父级节点的菜单不高亮的问题 | —— | | 2020-2-28 | Modify | 任梦飞 | 0.0.45-beta | 修改 KitSidebar 没有父级节点的菜单不高亮的问题 | —— | | 2020-3-13 | Add | 任梦飞 | 0.0.46-beta | 新增 KitNewRichText 富文本组件 | —— | | 2020-3-14 | Add | 任梦飞 | 0.0.47-beta | 新增 KitNewRichText 富文本组件，将源码编译发布 | —— | | 2020-3-16 | Modify | 任梦飞 | 0.0.48-beta | 修改 KitNewRichText 使用富文本的组件，更正为 wangEditor | —— | | 2020-3-19 | Modify | 任梦飞 | 0.0.49-beta | 修改 KitNewRichText 添加可配置项，字数展示和长度限制，修改 kitSidebar bug | —— | | 2020-3-19 | Modify | 任梦飞 | 0.0.49-beta | 修改 KitNewRichText 添加可配置项，字数展示和长度限制，修改 kitSidebar bug | —— | | 2020-3-20 | Modify | 任梦飞 | 0.0.50-beta | 修改 KitNewRichText onChange 与 setState 不同步引起的 bug | —— | | 2020-4-16 | Modify | 任梦飞 | 0.0.51-beta | 修改 KitNewRichText 从 word 粘贴过来带来的冗余换行符造成字数个数不正确的问题 | —— | | 2020-4-17 | Modify | 任梦飞 | 0.0.52-beta | 修复 KitNewRichText 空格统计问题 | —— | | 2020-4-18 | Modify | 任梦飞 | 0.0.53-beta | KitSelect 新增 optionsFilter 属性，可以控制 options 过滤，包括数据字典的过滤 | —— | | 2020-4-22 | Modify | 任梦飞 | 0.0.54-beta | 修复 KitNewRichText 从 word 粘贴字符长度不一致的问题 | —— | | 2020-4-22 | Modify | 任梦飞 | 0.0.55-beta | 修复 KitNewRichText 从 word 粘贴过滤 style 样式字符 | —— | | 2020-4-22 | Modify | 任梦飞 | 0.0.56-beta | KitInput 新增 statistics 字段，配合 maxLength 统计输入字符和总字符 | —— | | 2020-4-24 | Modify | 任梦飞 | 0.0.57-beta | KitTable 的 buttonsConfig 新增 isDisplay 字段，控制显示隐藏 | —— | | 2020-11-26 | Modify | 吴永松 | 0.0.58-bate | KitNewRichText 升级 wangeditor 编辑器到 4.0 | —— | —— |

kitking cms ie8 API Introduction

base

formConfigFactory

表单配置文件操作工厂方法，主要服务于 KitForm 配置，针对配置做修改操作。

    @example
    import {FormConfigFactory} from 'kitking-cms-ie8';
    const formConfigFactory = new FormConfigFactory(kitFormConfig);
    formConfigFactory.qeuryIds('id').setDisabled(true);

KitForm 配置说明

property

• qeuryIds

  @description 通过配置文件id值，筛选配置，返回一个新的FormConfigFactory，通过链式调用，操作筛选后的配置； @params ids: array | string @retruen new FormConfigFactory(config)

    function qeuryIds(ids): FormConfigFactory;

• setDisabled

  @description 设置KitForm组件的disabled的状态 @params disabled: boolean @retruen FormConfigFactory

    function setDisabled(disabled): FormConfigFactory;

• setVisible

  @description 设置KitForm组件的是否显示状态。注意：隐藏状态，组件render生效，但不显示到页面； @params visible: boolean *@retruen * FormConfigFactory

    function setVisible(visible): FormConfigFactory;

• setComponentProps

  @description 设置组件props参数 @params callback: componentPropsCallback *@retruen * FormConfigFactory

    @example
    formConfigFactory.setComponentProps(componentProp => {
       return {
            onChange：this.handleChange
       }
    });

    function setComponentProps(callback): FormConfigFactory;

• componentPropsCallback

  @description 修改组件prop回调方法; 返回对应组件扩展的prop配置; @params componentProp: object @retruen object

    function componentPropsCallback(componentProp): object;

• setWarpperProps

  @description 设置FormItem 组件 prop @params callback: warpperPropsCallback @retruen FormConfigFactory

    @example
    formConfigFactory.setWarpperProps(warpperProp => {
       return {
            labelCol：{span: 3, offset: 12}
       }
    });

    function setWarpperProps(callback): FormConfigFactory;

• warpperPropsCallback

  @description 修改FormItem prop回调方法; 返回对应组件扩展的FormItem prop配置; @params warpperProp: object @retruen object

    function warpperPropsCallback(warpperProp): object;

• setRules

  @description 设置组件 getFieldProps options.rules 校验规则; @params callback: rulesCallback @retruen FormConfigFactory

    @example
    formConfigFactory.setRules(rule => {
       return {
                required: true,
                whitespace: true,
                message: '请再次输入密码'
            };
    });

    function setRules(callback): FormConfigFactory;

• rulesCallback

  @description 修改组件 prop回调方法; 返回对应组件扩展校验规则; @params rule: array @retruen object | array

    function rulesCallback(rule): object | array;

• Chain calls

  链式调用，类似 jQuery 方式; 设置 id 为 name 的组件为 disabled 状态，可以类似以下调用方式：

    import {FormConfigFactory} from 'kitking-cms-ie8';
    const formConfigFactory = new FormConfigFactory(kitFormConfig);

    ...

    render(){
        formConfigFactory.qeuryIds('name').setDisabled(true);
        const config = formConfigFactory.getConfig();
        return <KitForm config={config}/>;
    }

ieDetection

@description

    浏览器识别,目前针对ie8 和 ie9 识别，其他情况返回'modern browser';
__*@return*__
    detection: 'ie8' | 'ie9' | 'modern browser';

    @example
    import {ieDetection} from 'kitking-cms-ie8';
    if(ieDetection() === 'ie8')

ie8-polyfill

dict

组件(components)

KitForm

• formConfig

    formConfigs: PropTypes.array,

    @example
    [
        {
            id: '', // form内唯一id， 与后端字段匹配
            dict: '', // 是否需要特殊字典、select、checkbox、radio组件自动查找字典
            label: '', // label文字
            newLineStart: false, // 是否为新的一行
            visible: true, // 是否显示 整个组件
            detail: true, // 详情模式（详情和 disabled的区别是：有无必选项星号显示）
            initialValue: '', // 初始值

            component: 'Input' || customComponent, // 内置组件或自定义组件
            componentProps: {}, // 表单组件的 props 属性，参考 ant design 组件/自定义组件文档
            formItemProps: {
                // FormItem 组件的 props 属性，参考 ant design 组件
                labelCol: {
                    span: '',
                    offset: ''
                },
                wrapperCol: {
                    span: '',
                    offset: ''
                }
            },
            colProps: {
                // Col 组件 Props 的属性，参考 ant design 组件
                span: ''
            },
            rules: [] // 规则显示，参考 ant design 组件
        }
    ];

• form

    form: PropTypes.object,

• colLength

     colLength: PropTypes.number,

• onSubmit

KitNotFound

404 页面

KitSearch

• config

    {
        formConfigs:PropTypes.array.isRequired,
        cardProps: PropTypes.object,
        colLength: PropTypes.number,
        operator: PropTypes.element,
        callback: PropTypes.func
    }

KitSidebar

• config

    {
        menuConfigs: PropTypes.array.isRequired,
        onSelect: PropTypes.func,
        getBreadcrumb: PropTypes.func,
        location: PropTypes.object
    }

KitTable

• config

    {
        dataSource: ,// 数据源
        columns: ,//列配置
        pagination: ,//翻页器
        selectOperation: {//选择操作栏
            show: PropTypes.bool,
            btnCallback: PropTypes.func,
            btnText: PropTypes.string,
            infoRender: PropTypes.func
        },
         // 列选择
        rowSelection: PropTypes.shape({
            type: PropTypes.string,
            selectedRowKeys: PropTypes.array,
            onChange: PropTypes.func,
            getCheckboxProps: PropTypes.func,
            onSelect: PropTypes.func,
            onSelectAll: PropTypes.func
        }),
        // 边框设置
        bordered: PropTypes.bool,
        // 加载动画
        loading: PropTypes.bool
    }

kitCard

kitModal

弹窗

• config

    {
        title: PropsType.string,// 头部文本显示 默认为空字符串
        confirmLoading: PropsType.bool,// 确定按钮loading状态 默认为 false
        maskClosable: PropsType.bool, // 点击蒙层是否允许关闭 默认为 false
        onOk: PropsType.func, // 点击‘确定’回调方法
        onCancel: PropsType.func, // 点击‘取消’回调方法
        extra: PropsTypr.array, //按钮扩展，包含React.Element
        extraPlacement: PropsType.array, //扩展按钮的方向 接收 left 和 right
        mode: PropsType.string //按钮默认展示模式 接收 alert(单按钮模式) 和 confirm(默认) *单按钮时不处理扩展按钮，单按钮时使用okText更改文字，onOk回调方法
    }

kitTableOperator

表格操作按钮组

• btnConfigs

    btnConfigs: PropTypes.array,// 按钮配置项 btnsConfig
    @example
    [
        {
            text: '', //按钮名称
            onClick: () => {}, //按钮点击事件
            isDisplay: true //是否显示隐藏
        },
        {
            textRender: '', //气泡确认框按钮名称
            popconfirm: {
                onConfirm //气泡确认框确定按钮事件
                titleRender: '' //气泡确认框标题
            }
        }
    ];