Files
amis-fork/docs/zh-CN/components/timeline.md

30 KiB
Raw Permalink Blame History

title, description, type, group, menuName, icon, order
title description type group menuName icon order
Timeline 时间轴 0 ⚙ 组件 Timeline 73

时间轴组件

基本用法

{
  "type": "page",
  "body": [
    {
      type: 'timeline',
      direction: 'vertical',
      items: [
        {
          time: '2019-02-07',
          title: '图片集说明',
          detail:
            '图片集展示,不支持配置初始化接口初始化数据域,所以需要搭配类似像Service、Form或CRUD这样的,具有配置接口初始化数据域功能的组件,或者手动进行数据域初始化,然后通过source属性,获取数据链中的数据,完成数据展示。'
        },
        {
          time: '2019-02-08',
          title: '卡片组说明',
          detail:
            '卡片展示,不支持配置初始化接口初始化数据域,所以需要搭配类似像Service这样的,具有配置接口初始化数据域功能的组件,或者手动进行数据域初始化,然后通过source属性,获取数据链中的数据,完成数据展示。'
        },
        {
          time: '2019-02-09',
          title: '宫格导航说明',
          detail:
            '宫格菜单导航,不支持配置初始化接口初始化数据域,所以需要搭配类似像Service、Form或CRUD这样的,具有配置接口初始化数据域功能的组件,或者手动进行数据域初始化,然后通过source属性,获取数据链中的数据,完成菜单展示。'
        },
        {
          time: '2019-02-10',
          title: '表格展现说明',
          detail:
            '通过表格的方式来展现数据,和 table 的不同之处:数据源要求不同:table 的数据源需要是多行的数据,最典型的就是来自某个数据库的表,table view 的数据源可以来自各种固定的数据,比如单元格的某一列是来自某个变量。功能不同:table 只能用来做数据表的展现,table view 除了展现复杂的报表,还能用来进行布局。合并单元格方式不同:table 的合并单元格需要依赖数据,table view 的合并单元格是手动指定的,因此可以支持不规则的数据格式。'
        }
      ]
    }
  ]
}

时间轴节点颜色设置

支持设置自定义节点颜色,或者使用内置的颜色值。内置颜色值有:success, warning, danger, info。

{
  "type": "page",
  "body": [
    {
      "type": "timeline",
      "items": [
        {
          "time": "2019-02-07",
          "title": "节点数据",
          "color": "#ffb200",
          "backgroundColor": "#eeb739"
        },
        {
          "time": "2019-02-08",
          "title": "节点数据",
          "color": "#4F86F4",
        },
        {
          "time": "2019-02-09",
          "title": "节点数据",
          "color": "success",
        },
        {
          "time": "2019-02-09",
          "title": "节点数据",
          "color": "warning",
        }
      ]
    }
  ]
}

时间轴节点的位置、隐藏、大小配置

{
  "type": "page",
  "body": [
    {
      "type": "timeline",
      "items": [
        {
          "time": "2019-02-07",
          title: '图片集说明',
          detail:
            '图片集展示,不支持配置初始化接口初始化数据域,所以需要搭配类似像Service、Form或CRUD这样的,具有配置接口初始化数据域功能的组件,或者手动进行数据域初始化,然后通过source属性,获取数据链中的数据,完成数据展示。',
          align: 'bottom',
          dotSize: 'xl',
        },
        {
          "time": "2019-02-08",
          title: '卡片组说明',
          detail:
            '卡片展示,不支持配置初始化接口初始化数据域,所以需要搭配类似像Service这样的,具有配置接口初始化数据域功能的组件,或者手动进行数据域初始化,然后通过source属性,获取数据链中的数据,完成数据展示。',
          align: 'center',
          dotSize: 'lg',
        },
        {
          "time": "2019-02-09",
          title: '宫格导航说明',
          detail:
            '宫格菜单导航,不支持配置初始化接口初始化数据域,所以需要搭配类似像Service、Form或CRUD这样的,具有配置接口初始化数据域功能的组件,或者手动进行数据域初始化,然后通过source属性,获取数据链中的数据,完成菜单展示。',
          "color": "success",
          "hideDot": true,
        },
        {
          "time": "2019-02-09",
          title: '表格展现说明',
          detail:
            '通过表格的方式来展现数据,和 table 的不同之处:数据源要求不同:table 的数据源需要是多行的数据,最典型的就是来自某个数据库的表,table view 的数据源可以来自各种固定的数据,比如单元格的某一列是来自某个变量。功能不同:table 只能用来做数据表的展现,table view 除了展现复杂的报表,还能用来进行布局。合并单元格方式不同:table 的合并单元格需要依赖数据,table view 的合并单元格是手动指定的,因此可以支持不规则的数据格式。',
          "color": "warning",
          dotSize: 'sm',
        }
      ]
    },
    {
      "type": "timeline",
      direction: 'horizontal',
      "items": [
        {
          "time": "2019-02-07",
          title: '图片集说明',
          detail:
            '图片集展示,不支持配置初始化接口初始化数据域,所以需要搭配类似像Service、Form或CRUD这样的,具有配置接口初始化数据域功能的组件,或者手动进行数据域初始化,然后通过source属性,获取数据链中的数据,完成数据展示。',
          align: 'left',
          dotSize: 'xl',
        },
        {
          "time": "2019-02-08",
          title: '卡片组说明',
          detail:
            '卡片展示,不支持配置初始化接口初始化数据域,所以需要搭配类似像Service这样的,具有配置接口初始化数据域功能的组件,或者手动进行数据域初始化,然后通过source属性,获取数据链中的数据,完成数据展示。',
          align: 'right',
          dotSize: 'lg',
        },
        {
          "time": "2019-02-09",
          title: '宫格导航说明',
          detail:
            '宫格菜单导航,不支持配置初始化接口初始化数据域,所以需要搭配类似像Service、Form或CRUD这样的,具有配置接口初始化数据域功能的组件,或者手动进行数据域初始化,然后通过source属性,获取数据链中的数据,完成菜单展示。',
          "color": "success",
          "hideDot": true,
        },
        {
          "time": "2019-02-09",
          title: '表格展现说明',
          detail:
            '通过表格的方式来展现数据,和 table 的不同之处:数据源要求不同:table 的数据源需要是多行的数据,最典型的就是来自某个数据库的表,table view 的数据源可以来自各种固定的数据,比如单元格的某一列是来自某个变量。功能不同:table 只能用来做数据表的展现,table view 除了展现复杂的报表,还能用来进行布局。合并单元格方式不同:table 的合并单元格需要依赖数据,table view 的合并单元格是手动指定的,因此可以支持不规则的数据格式。',
          "color": "warning",
          dotSize: 'sm',
        }
      ]
    }
  ]
}

时间轴节点图标设置

{
  "type": "page",
  "data": {
    "image": "https://suda.cdn.bcebos.com/images%2F2021-01%2Fsearch.svg"
  },
  "body": [
    {
      "type": "timeline",
      "items": [
        {
          "time": "2019-02-07",
          "title": "节点数据error",
          "detail": "error",
          "icon": "fail"
        },
        {
          "time": "2019-02-08",
          "title": "节点数据success",
          "detail": "success",
          "icon": "success"
        },
        {
          "time": "2019-02-09",
          "title": "节点数据(自定义图片)",
          "detail": "warning",
          "icon": "${image}",
        }
      ]
    },{
      "type": "timeline",
      "direction": "horizontal",
      "items": [
        {
          "time": "2019-02-07",
          "title": "节点数据error",
          "detail": "error",
          "icon": "fail"
        },
        {
          "time": "2019-02-08",
          "title": "节点数据success",
          "detail": "success",
          "icon": "success"
        },
        {
          "time": "2019-02-09",
          "title": "节点数据(自定义图片)",
          "detail": "warning",
          "icon": "${image}",
        }
      ]
    }
  ]
}

时间轴分段颜色设置

{
  "type": "page",
  "body": [
    {
      "type": "timeline",
      "items": [
        {
          "time": "2019-02-07",
          "title": "节点数据error",
          "detail": "error",
          "icon": "fail",
          "lineColor": "#2e86d3",
        },
        {
          "time": "2019-02-08",
          "title": "节点数据success",
          "detail": "success",
          "icon": "success",
          "lineColor": "#2ee414",
        },
        {
          "time": "2019-02-09",
          "title": "节点数据(自定义图片)",
          "detail": "warning",
          "lineColor": "#e45c14",
          "icon": "${image}"
        }
      ]
    }
  ]
}

节点标题自定义

{
  "type": "page",
  "body": [
    {
      "type": "timeline",
      "items": [
        {
          "time": "2019-02-07",
          "title": [
            {
              "type": "text",
              "value": "2019年02月7日"
            },
            {
              "type": "button",
              "label": "查看",
              "actionType": "dialog",
              "level": "link",
              "dialog": {
                "title": "查看详情",
                "body": "这是详细内容。"
              }
            },
            {
              "type": "button",
              "label": "删除",
              "level": "link",
              "actionType": "dialog",
              "dialog": {
                "title": "删除",
                "body": "确认删除吗?"
              }
            }
          ]
        },
        {
          "time": "2019-02-10",
          "title": [
            {
              "type": "text",
              "value": "2019年02月10日"
            },
            {
              "type": "button",
              "label": "查看",
              "actionType": "dialog",
              "level": "link",
              "dialog": {
                "title": "查看详情",
                "body": "这是详细内容。"
              }
            },
            {
              "type": "button",
              "label": "删除",
              "level": "link",
              "actionType": "dialog",
              "dialog": {
                "title": "删除",
                "body": "确认删除吗?"
              }
            }
          ]
        },
      ]
    }
  ]
}

设置节点数据倒序

{
  "type": "page",
  "body": [
    {
      "type": "timeline",
      direction: "vertical",
      reverse: true,
      "items": [
        {
          "time": "2019-02-07",
          "title": "节点数据",
        },
        {
          "time": "2019-02-08",
          "title": "节点数据",
        },
        {
          "time": "2019-02-09",
          "title": "节点数据",
        },
        {
          "time": "2019-02-10",
          "title": "节点数据",
        },
      ]
    }
  ]
}

设置时间轴方向

{
  "type": "page",
  "body": [
    {
      "type": "timeline",
      direction: "horizontal",
      "items": [
        {
          "time": "2019-02-07",
          "title": "节点数据",
          "dotSize": "xl"
        },
        {
          "time": "2019-02-08",
          "title": "节点数据",
        },
        {
          "time": "2019-02-09",
          "title": "节点数据",
        },
        {
          "time": "2019-02-10",
          "title": "节点数据",
        },
      ]
    }
  ]
}

设置文字相对时间轴方向

纵向

文字位于时间轴左侧

{
  "type": "page",
  "body": [
    {
      "type": "timeline",
      "mode": "left",
      "items": [
        {
          "time": "2019-02-07",
          "title": "节点数据",
          "detail": "error",
        },
        {
          "time": "2019-02-08",
          "title": "节点数据",
          "detail": "success",
        }
      ]
    },
  ]
}

文字交替位于时间轴两侧

{
  "type": "page",
  "body": [
    {
      "type": "timeline",
      "mode": "alternate",
      "items": [
        {
          "time": "2019-02-07",
          "title": "节点数据",
          "detail": "error",
        },
        {
          "time": "2019-02-08",
          "title": "节点数据",
          "detail": "success",
        }
      ]
    }
  ]
}

文字位于时间轴右侧

{
  "type": "page",
  "body": [
    {
      "type": "timeline",
      "mode": "right",
      "items": [
        {
          "time": "2019-02-07",
          "title": "节点数据",
          "detail": "error",
        },
        {
          "time": "2019-02-08",
          "title": "节点数据",
          "detail": "success",
        }
      ]
    },
  ]
}

横向

时间标题位于时间轴上侧

{
  "type": "page",
  "body": [
    {
      "type": "timeline",
      "mode": "top",
      "direction": "horizontal",
      "items": [
        {
          "time": "2019-02-07",
          "title": "节点数据",
          "detail": "error",
        },
        {
          "time": "2019-02-08",
          "title": "节点数据",
          "detail": "success",
        }
      ]
    },
  ]
}

时间标题位于时间轴下侧

{
  "type": "page",
  "body": [
    {
      "type": "timeline",
      "mode": "bottom",
      "direction": "horizontal",
      "items": [
        {
          "time": "2019-02-07",
          "title": "节点数据",
          "detail": "error",
        },
        {
          "time": "2019-02-08",
          "title": "节点数据",
          "detail": "success",
        }
      ]
    },
  ]
}

时间标题和内容交替位于时间轴两侧

{
  "type": "page",
  "body": [
    {
      "type": "timeline",
      "mode": "alternate",
      "direction": "horizontal",
      "items": [
        {
          "time": "2019-02-07",
          "title": "节点数据",
          "detail": "error",
        },
        {
          "time": "2019-02-08",
          "title": "节点数据",
          "detail": "success",
        }
      ]
    },
  ]
}

时间轴内容支持卡片展示

{
  "type": "page",
  "body": [
    {
      type: 'timeline',
      mode: 'alternate',
      direction: 'horizontal',
      items: [
        {
          cardSchema: {
            type: 'card',
            href: 'https://github.com/baidu/amis',
            header: {
              title: '标题',
              subTitle: '副标题',
              description: '这是一段描述',
              avatarText: 'AMIS'
            },
            body: '这里是内容'
          }
        },
        {
          time: '2019-02-08',
          cardSchema: {
            type: 'card',
            href: 'https://github.com/baidu/amis',
            header: {
              title: '标题',
              subTitle: '副标题',
              description: '这是一段描述',
              avatarText: 'AMIS'
            },
            body: '这里是内容'
          }
        },
        {
          time: '2019-02-09',
          title: '表格展现说明',
          detail:
            '通过表格的方式来展现数据,和 table 的不同之处:数据源要求不同:table 的数据源需要是多行的数据,最典型的就是来自某个数据库的表,table view 的数据源可以来自各种固定的数据,比如单元格的某一列是来自某个变量。功能不同:table 只能用来做数据表的展现,table view 除了展现复杂的报表,还能用来进行布局。合并单元格方式不同:table 的合并单元格需要依赖数据,table view 的合并单元格是手动指定的,因此可以支持不规则的数据格式。'
        }
      ]
    }
  ]
}

如果当前所有节点均需要以卡片形式展示,可以通过 timeline 节点增加 cardSchema以统一卡片渲染模板。在这种情况下,每个 timelineItem内的数据都可以作为数据引用,在 cardSchema 中引用展示。

{
  type: 'page',
  data: {
    content: '这里是卡片主体内容,在所有的卡片都会展示'
  },
  body: {
    type: 'timeline',
    mode: 'alternate',
    direction: 'horizontal',
    cardSchema: {
      type: 'card',
      href: 'https://github.com/baidu/amis',
      header: {
        title: '${title}',
        subTitle: '${time}',
        description: '${detail}'
      },
      body: '${content}'
    },
    items: [
      {
        cardSchema: {
          type: 'card',
          href: 'https://github.com/baidu/amis',
          header: {
            title: '标题',
            subTitle: '副标题',
            description: '这是一段描述',
            avatarText: 'AMIS'
          },
          body: '这里是内容'
        }
      },
      {
        time: '2019-02-08',
        title: '卡片组说明',
        detail:
          'Content'
      },
      {
        time: '2019-02-09',
        title: '表格展现说明',
        detail:
          'Content'
      }
    ]
  }
}

动态数据

远程数据

{
  "type": "page",
  "body": [
    {
      "type": "timeline",
      "source": {
        "method": "get",
        "url": "/api/mock2/timeline/timelineItems"
      }


    }
  ]
}

"source": "/api/mock2/timeline/timelineItems",

远程拉取接口时,返回的数据结构除了需要满足 amis 接口要求的基本数据结构 以外,必须用"items"作为时间轴数据的 key 值,如下:

{
  "status": 0,
  "msg": "",
  "data": {
    "items": [
      {
        "time": "2019-02-07",
        "title": "数据开发",
        "detail": "2019-02-07detail",
        "color": "#ffb200",
        "icon": "close"
      },
      {"time": "2019-02-08", "title": "管理中心", "detail": "2019-02-08detail"},
      {
        "time": "2019-02-09",
        "title": "SQL语句",
        "detail": "2019-02-09detail",
        "color": "warning"
      },
      {
        "time": "2019-02-10",
        "title": "一键部署",
        "detail": "2019-02-10detail",
        "icon": "compress-alt"
      },
      {"time": "2019-02-10", "title": "一键部署", "detail": "2019-02-11detail"},
      {
        "time": "2019-02-10",
        "title": "一键部署",
        "detail": "2019-02-12detail",
        "icon": "close"
      },
      {"time": "2019-02-10", "title": "一键部署", "detail": "2019-02-13detail"}
    ]
  }
}

数据域变量配置

3.4.0 及以上版本

{
  "type": "page",
  "data": {
    "items": [
      {
        "title": "First",
        "time": "this is subTitle",
        "detail": "this is description"
      },
      {
        "title": "Second"
      },
      {
        "title": "Last"
      }
    ]
  },
  "body": [
    {
      "type": "timeline",
      "source": "${items}"
    }
  ]
}
{
  "type": "page",
  "data": {
    "items":
      {
        "First": "this is subTitle",
        "detail": "this is description",
        "title": "Second"
      }
  }
  ,
  "body": [
    {
      "type": "timeline",
      "source": "${items}"
    }
  ]
}

属性表

属性名 类型 默认值 说明
type string "timeline" 指定为 时间轴 渲染器
items Array<timelineItem> [] 配置节点数据
source API 或 数据映射 数据源,可通过数据映射获取当前数据域变量、或者配置 API 对象
mode left | right | alternate | top | bottom right``top 可选。支持时间在左/上展示,标题和内容在右/下展示,以及时间和内容交错方向展示。left / right 在 direction 为 vertical 时生效,top / bottom 在 direction 为 vertical 时生效。(v6.11.0 以前版本只有 vertical 支持,horizontal 不支持设置模式)
direction vertical | horizontal vertical 时间轴方向
reverse boolean false 根据时间倒序显示
iconClassName string 统一配置的节点图标 CSS 类(3.4.0 版本支持)名
timeClassName string 统一配置的节点时间 CSS 类(3.4.0 版本支持)名
titleClassName string 统一配置的节点标题 CSS 类(3.4.0 版本支持)名
detailClassName string 统一配置的节点详情 CSS 类(3.4.0 版本支持)名
cardSchema string 统一配置子节点渲染卡片模板。配置后  itemTitleSchema、titleClassName、detailClassName 将不生效。配置后 timeline item 中的数据都将可以在 cardSchema 中通过数据方式引用。如果子节点也配置了 cardSchema,子节点的 cardSchema 优先级高于 timeline 的 cardSchema。(v6.12.1 之后支持)

timeline.item

属性名 类型 默认值 说明
time string 节点时间
title string | SchemaNode 节点标题
detail string 节点详细描述(折叠)
detailCollapsedText string 展开 详细内容折叠时按钮文案
detailExpandedText string 折叠 详细内容展开时按钮文案
color string | level样式(info、success、warning、danger) #DADBDD 时间轴节点颜色
backgroundColor string #070c14 时间点圆圈后部阴影颜色。(v6.11.1 版本支持)
icon string icon 名,支持 fontawesome v4 或使用 url(优先级高于 color)
iconClassName string 节点图标的 CSS 类名(优先级高于统一配置的 iconClassName ,(3.4.0 版本支持))
timeClassName string 节点时间的 CSS 类名(优先级高于统一配置的 timeClassName,(3.4.0 版本支持))
titleClassName string 节点标题的 CSS 类名(优先级高于统一配置的 titleClassName,(3.4.0 版本支持))
detailClassName string 节点详情的 CSS 类名(优先级高于统一配置的 detailClassName,(3.4.0 版本支持))
dotSize sm | md | lg | xl md 当前节点大小。(v6.11.1 版本支持
lineColor string #e6e6e8 连线颜色。(v6.11.1 版本支持)
hideDot boolean false 是否隐藏当前节点的圆圈。(v6.11.1 版本支持)
align left | center | right | top | bottom center top 圆点的对齐方式。水平排列时,可选值为 left center right,默认为 center;垂直排列时,可选值为 top bottom center,默认为 top。(v6.11.1 版本支持)
cardSchema CardSchema 卡片展示配置,如果传入则以卡片形式展示,传入对象转为卡片展示,传入的 time、title、detail 及相关属性将被忽略,只有连线配置和节点圆圈配置生效。(v6.11.1 版本支持)