shineout 1.7.0 → 1.7.1-beta.3

package/css/CardGroup/index.d.ts

@@ -0,0 +1,119 @@
+import * as React from 'react'
+import { StandardProps } from '../@types/common'
+
+type ReactNode = React.ReactNode;
+
+
+export interface CardGroupProps extends StandardProps {
+
+  /**
+   * group height
+   * 
+   * 卡片组高度
+   * 
+   * default: none
+   */
+  height?: number;
+  
+  /**
+   * card min width
+   *
+   * 卡片最小宽度 
+   * 
+   * default: none
+   */
+  cardWidth?: number;
+
+  /**
+   * items count each row, not work while cardWidth setted
+   * 
+   * 列数，设置 cardWidth 后该属性将失效
+   * 
+   * default: 3
+   */
+  columns?: number;
+
+  /**
+   * grid style
+   * 
+   * 卡片网格样式
+   * 
+   * default: none
+   */
+  gridStyle?: React.CSSProperties;
+
+
+  /**
+   * gutter width horizontal and vertical, if diff shoud set gridStyle
+   * 
+   * 卡片横向纵向间距，如果两个间距相互独立可以通过 gridStyle 调整
+   * 
+   * default: 16
+   */
+  gutter?: number;
+}
+
+
+export interface CardGroupItemProps<T> extends StandardProps {
+  
+    /**
+     * desc: lazy load placeholder, enable lazy load while set
+     * 
+     * 懒加载占位元素，设置后卡片将开启懒加载
+     * 
+     * default: none
+     */
+    placeholder?: ReactNode;
+  
+    /**
+     * desc: checked status, hide while not set
+     * 
+     * checked 表示选中状态，不设置则不显示选择框
+     * 
+     * default: -
+     */
+    checked?: boolean | undefined;
+  
+    /**
+     * desc: disable checkbox
+     * 
+     * 是否禁用选择框
+     * 
+     * default: false
+     */
+    disabled?: boolean;
+  
+    /**
+     * desc: Specifies the result
+     * 
+     * 选中时返回值
+     * 
+     * default: true
+     */
+    value?: T;
+  
+    /**
+     * desc: check changed, value is the value props
+     * 
+     * 选中状态变化事件，checked表示选中状态，value代表对应的值
+     * 
+     * default: -
+     */
+    onChange?: (checked: boolean, value: T) => void;
+  
+}
+
+
+declare class CardGroupItem<T = any> extends React.Component<CardGroupItemProps<T>, {}> { 
+  render(): JSX.Element;
+}
+
+
+declare class CardGroup extends React.Component<CardGroupProps, {}> { 
+  static Item: typeof CardGroupItem
+
+  render(): JSX.Element;
+}
+
+export default CardGroup
+

package/css/Carousel/index.d.ts

@@ -0,0 +1,59 @@
+import * as React from 'react'
+import { StandardProps } from '../@types/common'
+
+type ReactNode = React.ReactNode;
+
+export interface CarouselProps extends StandardProps {
+
+    /**
+     * animation effects, options: <br />slide - horizontal sliding<br />slide-y - vertical sliding<br />fade - fading
+     * 
+     * 动画效果，可选值为 slide - 横向滑动 ，slide-y - 垂直滑动 ，fade - 淡入淡出
+     * 
+     * default: 'slide'
+     */
+     animation?: string;
+  
+     /**
+      * the position of indicator
+      * 
+      * 指示标示位置
+      * 
+      * default: 'center'
+      */
+     indicatorPosition?: 'left' | 'center' | 'right';
+   
+     /**
+      * the style of indicator, string options: ['circle', 'number', 'line'], using function for custom styles
+      * 
+      * 指示标示样式，字符串可以是：['circle', 'number', 'line']，函数则可以自定义样式: (current, moveTo) => (<Component />)
+      * 
+      * default: 'circle'
+      */
+     indicatorType?: ((current: number, moveTo: () => void) => ReactNode) | string;
+   
+     /**
+      * the interval of animation, When it is not 0, play automatically
+      * 
+      * 动画间隔时间，为 0 时，不自动播放
+      * 
+      * default: 0
+      */
+     interval?: number;
+
+     /**
+      * move callback
+      * 
+      * 轮播后的回调
+      * 
+      * default: none
+      */
+     onMove?: (current: number, extra: { prev: number, direction: 'forward' | 'backward', moveTo: (n: number) => void}) => void;
+}
+
+
+declare class Carousel extends React.Component<CarouselProps> {
+  render(): JSX.Element
+}
+
+export default Carousel

package/css/Cascader/index.d.ts

@@ -0,0 +1,185 @@
+import * as React from 'react'
+import { StandardProps, FormItemStandardProps, StructDataStandardProps, keyType, RegularAttributes } from '../@types/common'
+
+export interface CascaderProps<Item, Value> extends StandardProps, FormItemStandardProps<Value>, StructDataStandardProps<Item>  {
+  /**
+   * show border bottom
+   *
+   * 仅仅展示下边框
+   *
+   * default: false
+   */
+   underline?: boolean;
+
+  /**
+   * When it is true, the pop-up layer of option append into document.body.
+   *
+   * 为 true 时，选项弹出层在 DOM 中独立 render
+   *
+   * default: false
+   */
+  absolute?: boolean;
+
+  /**
+   * the key of the children data name
+   *
+   * 指定子数据的属性名
+   *
+   * default: 'children'
+   */
+  childrenKey?: string;
+
+  /**
+   * If clearable is true, show clear value icon
+   *
+   * 是否显示清除数据图标
+   *
+   * default: true
+   */
+  clearable?: boolean;
+
+  /**
+   * Merges selected values
+   *
+   * 将选中值合并
+   *
+   * default: false
+   */
+  compressed?: boolean | 'no-repeat';
+
+  /**
+   * data. The child node is children. If the children value is null or its length is 0, it is render as a leaf node.
+   *
+   * 数据，子节点为children，如果 children 值为 null 或 长度为 0 时，视为叶子节点
+   *
+   * default: []
+   */
+  data?: Item[];
+
+  /**
+   * When it is true, all nodes disable the selection; when it is a function, it determines whether it is disabled according to the return result of the function.
+   *
+   * 如果 disabled 为 true，禁用全部选项，如果 disabled 为函数，根据函数反回结果禁用选项
+   *
+   * default: false
+   */
+  disabled?: (data: Item) => boolean | boolean;
+
+  /**
+   * Expand mode
+   *
+   * 节点展开触发方式
+   *
+   * default: 'click'
+   */
+  expandTrigger?: 'click' | 'hover' | 'hover-only';
+
+  /**
+   * close options after chose the final node
+   *
+   * 选择末级节点后是否关闭选项列表
+   *
+   * default: false
+   */
+  finalDismiss?: boolean;
+
+  /**
+   * Auxiliary method for generating key. When it is a function, use the return value of this function. When it is a string, use the data value corresponding to this string. For example, 'id' is the same thing as (d) => d.id.
+   *
+   * 生成key的辅助方法, 为函数时，使用此函数返回值, 为string时，使用这个string对应的数据值。如 'id'，相当于 (d) => d.id
+   *
+   * default: index
+   */
+  keygen: ((data: Item, parentKey: keyType) => keyType) | string;
+
+  /**
+   * If the loader attribute is a function, the node with no children is regarded as dynamically loaded node. Click expanded button to trigger the loader event. The children property is null or its length is 0 will be regarded as a leaf node.
+   *
+   * 设置loader属性后，未定义children的节点视为动态加载节点，点击展开触发 loader事件，children 为 null 或者长度为 0 视为叶子节点
+   *
+   * default:
+   */
+  loader?: (key: keyType, data: Item) => void;
+
+  /**
+   * mode 0: Returns only the fully selected node including the parent node. 1: Returns all selected nodes and semi-selected nodes. 2: Return only the selected child nodes. 3: If the parent node is full selected, only return the parent node.
+   *
+   * 选中值模式，未设置值为单选 0: 只返回完全选中的节点，包含父节点 1: 返回全部选中的节点和半选中的父节点 2: 只返回选中的子节点 3: 如果父节点选中，只返回父节点
+   *
+   * default: -
+   */
+  mode?: 0 | 1 | 2 | 3;
+
+  /**
+   * When the onChange property is set, the selection box is displayed. The parameter is the current selected value, which is related to the mode property.
+   *
+   * 设置 onChange 属性时，显示 选择框。参数为当前选中值，和 mode 属性相关
+   *
+   * default: -
+   */
+  onChange?: (value: Value, selected: boolean) => void;
+
+  /**
+   * options collapse callback
+   *
+   * 下拉列表展开/收起回调
+   *
+   * default: none
+   */
+  onCollapse?: (collapse: boolean) => void;
+
+  /**
+   * size
+   *
+   * 尺寸
+   *
+   * defualt: none
+   */
+  size?: RegularAttributes.Size;
+
+  /**
+   * Support single node deletion
+   *
+   * 支持单个节点删除
+   *
+   * default: none
+   */
+  singleRemove?: boolean;
+
+  /**
+   * render unmatch value
+   *
+   * 是否展示data中不存在的值
+   *
+   * default: -
+   */
+   unmatch?: boolean;
+  /**
+   * show dropdown arrow, only single select
+   *
+   * 是否显示下拉箭头，仅针对单选情况
+   *
+   * default: true
+   */
+  showArrow?: boolean;
+
+  /**
+   *  A reference to the binding component, you can call some component methods
+   *
+   *  绑定组件的引用, 可以调用某些组件的方法
+   *
+   *  default: -
+   *
+   */
+
+  getComponentRef?: (comp: componentRef )=> void;
+}
+
+interface componentRef  {
+  close: () => void;
+  [propName: string]: any;
+}
+
+declare class Cascader<Item = any, Value = string[]> extends React.Component<CascaderProps<Item, Value>, {}> {}
+
+export default Cascader

package/css/Checkbox/index.d.ts

@@ -0,0 +1,120 @@
+import * as React from 'react'
+import { RuleParamsType } from '../Rule'
+import { StandardProps, FormItemStandardProps, ListItemStandardProps } from '../@types/common'
+
+type ReactNode = React.ReactNode;
+
+export interface CheckboxProps<T> extends StandardProps, FormItemStandardProps<T> {
+
+  /**
+   * if not set, use (value === htmlValue).
+   *
+   * checked 传入时为受控组件
+   *
+   * default: -
+   */
+  checked?: boolean | 'indeterminate';
+
+  /**
+   * disable checkbox
+   *
+   * 是否禁用
+   *
+   * default: false
+   */
+  disabled?: boolean;
+
+  /**
+   * Specifies the result
+   *
+   * 选中时返回值
+   *
+   * default: true
+   */
+  htmlValue?: any;
+
+
+  /**
+   * Validation rules
+   *
+   * 校验规则
+   *
+   * default: -
+   */
+  rules?: RuleParamsType<T, CheckboxProps<T>>
+
+}
+
+// attention: checkbox group value is array
+
+export interface CheckboxGroupProps<Data, T> extends ListItemStandardProps<Data, T> {
+
+  /**
+   * The data item
+   *
+   * 数据项
+   *
+   * default: required
+   */
+  data?: Data[];
+
+  /**
+   * If the format and prediction does not satisfied your requirements, you can pass in a [Datum.List](/components/Datum.List) object or the Datum.List configuration to process data.
+   *
+   * 如果 disabled 为 true，禁用全部选项，如果 disabled 为函数，根据函数反回结果禁用选项
+   *
+   * default: -
+   */
+  datum?: object;
+
+  /**
+   * Initial value
+   *
+   * 初始值
+   *
+   * default: []
+   */
+  defaultValue?: T[];
+
+  /**
+   * value is datum.getValue()
+   *
+   * value 为 datum.getValue()
+   *
+   * default: -
+   */
+  onChange?: (value: T[]) => void;
+
+  /**
+   * When it is a string, return d[string]. When it is a function, return the result of the function.
+   *
+   * 为 string 时，返回 d[string]。为 function 时，返回函数结果
+   *
+   * default: required
+   */
+  renderItem?: ((data: Data) => ReactNode) | string;
+
+  /**
+   * In the Form, the value will be taken over by the form and the value will lose efficacy.
+   *
+   * 在Form中，value会被表单接管，value无效
+   *
+   * default: -
+   */
+  value?: T[];
+
+}
+
+
+declare class CheckboxGroup<Data = any, T = any> extends React.Component<CheckboxGroupProps<Data, T>, {}> {
+  render(): JSX.Element;
+}
+
+
+declare class Checkbox<T = any> extends React.Component<CheckboxProps<T>, {}> {
+  static Group: typeof CheckboxGroup;
+
+  render(): JSX.Element;
+}
+
+export default Checkbox

package/css/DataList/index.d.ts

@@ -0,0 +1,197 @@
+import * as React from 'react'
+import { StandardProps, StructDataStandardProps, ListItemStandardProps } from '../@types/common'
+
+type ReactNode = React.ReactNode;
+
+
+export interface ListProps<Item, Value> extends StandardProps,
+  StructDataStandardProps<Item>,
+  ListItemStandardProps<Item, Value> {
+
+
+  /**
+   * show border
+   *
+   * 是否显示边框
+   *
+   * default: null
+   */
+  bordered?: boolean;
+
+
+  /**
+   * What to display when no data
+   *
+   * 无数据时展示的内容
+   *
+   * default:null
+   */
+  empty?: string | ReactNode;
+
+
+  /**
+   * virtualized list
+   *
+   * 是否启用虚拟列表
+   *
+   * default: false
+   */
+  fixed?: boolean;
+
+
+  /**
+   * The content at the bottom
+   *
+   * 底部内容
+   *
+   * default: null
+   */
+  footer?: ReactNode;
+
+
+  /**
+   * height of item
+   *
+   * 列表项高度
+   *
+   * default: 32
+   */
+  lineHeight?: number;
+
+
+  /**
+   * loading
+   *
+   * 加载中
+   *
+   * default: false
+   */
+  loading?: boolean| ReactNode;
+
+
+  /**
+   * Select the row ,rowData is the selected data, rowIndex is the selected row number. If the data needs to be formatted, it is recommended to configure format
+   *
+   * 选择行。rowData为选中的数据，rowIndex为选中行号。如果需要数据需要格式化的处理，建议配置 format。
+   *
+   * default: null
+   */
+  onChange?: (rowData: Item, index: number) => void;
+
+
+  /**
+   * custom row className
+   *
+   * 自定义行 className
+   *
+   * default: null
+   */
+  rowClassName?: (rowData: Item, index: number) => string;
+
+
+  /**
+   * 同时展示的列表项数量
+   *
+   * Number of list items displayed at the same time
+   *
+   * default: 10
+   */
+  rowsInView?: number;
+
+
+  /**
+   * Triggered when scrolling to the bottom
+   *
+   * 滚动到底部时触发
+   *
+   * default: null
+   */
+  scrollLoading?: () => void;
+
+
+  /**
+   * The current selected value.
+   *
+   * 当前选中值，格式和 onChange 返回值一致
+   *
+   * default: none
+   */
+  value?: Value[];
+}
+
+export interface ListBaseItemProps{
+
+
+  /**
+   * List images
+   *
+   * 列表元素的图标
+   *
+   * default: null
+   */
+  avatar?: string| ReactNode |(() => ReactNode);
+
+
+  /**
+   * Item className
+   *
+   * Item 容器的className
+   *
+   * default: null
+   */
+  className?: string;
+
+
+  /**
+   * List content
+   *
+   * 列表内容
+   *
+   * default: null
+   */
+  content?: string| ReactNode |(() => ReactNode);
+
+
+  /**
+   * Description
+   *
+   * 描述
+   *
+   * default: null
+   */
+  desc?: string;
+
+  /**
+   * Content area on the right side of the list
+   *
+   * 列表右侧内容
+   *
+   * default: null
+   */
+  extra?: Array<ReactNode>|ReactNode;
+
+
+  /**
+   * The title of the list
+   *
+   * 列表元素的标题
+   *
+   * default: null
+   */
+  title?: string;
+
+
+}
+
+
+declare class ListBaseItem extends React.Component<ListBaseItemProps, {}> {
+  render(): JSX.Element;
+}
+
+declare class List<Item = any, Value = any> extends React.Component<ListProps<Item, Value>, {}> {
+  static BaseItem: typeof ListBaseItem;
+
+  render(): JSX.Element;
+}
+
+export default List

package/css/DatePicker/Container.js

@@ -572,7 +572,7 @@ Container.propTypes = {
   allowSingle: _propTypes.default.bool,
   defaultTime: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.array]),
   value: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string, _propTypes.default.object, _propTypes.default.array]),
-  absolute: _propTypes.default.bool,
+  absolute: _propTypes.default.oneOfType([_propTypes.default.bool, _propTypes.default.func]),
   zIndex: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]),
   onValueBlur: _propTypes.default.func,
   children: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.object]),