amis2/docs/zh-CN/components/progress.md

title	description	type	group	menuName	icon	order
Progress 进度条		0	⚙ 组件	Progress 进度条		60

基本用法

{
    "type": "page",
    "body": {
        "type": "progress",
        "value": 60
    }
}

颜色映射

可以配置map为单独颜色，例如：#F96D3E

若配置为字符串数组，指定颜色映射，例如，默认的 map 配置为：['bg-danger', 'bg-warning', 'bg-info', 'bg-success', 'bg-success']

它意味着将进度条分成了 5 份，前20%将会添加bg-danger css 类名到进度条上，20%~40%，将会添加bg-warning，以此类推，你可以自定义map来配置想要的进度效果

若配置为[{value: 30, color: "#007bff"}, {value: 60, color: "#F96D3E"}], 表示为 value 小于等于30的区间显示#007bff, 大于30则显示#F96D3E

{
    "type": "page",
    "body": [
        {
            "type": "progress",
            "value": 40,
            "map": "#F96D3E"
        },
        {
            "type": "divider"
        },
        {
            "type": "progress",
            "value": 60,
            "map": ["bg-danger", "bg-success"]
        },
        {
            "type": "divider"
        },
        {
            "type": "progress",
            "value": 20,
            "map": [{
                value: 30,
                color: "#007bff"
            },
            {
                value: 60,
                color: "#fad733"
            }],
            "mode": "circle"
        },
        {
            "type": "divider"
        },
        {
            "type": "progress",
            "value": 50,
            "map": [{
                value: 50,
                color: "#007bff"
            },
            {
                value: 60,
                color: "#fad733"
            }],
            "mode": "circle"
        }
    ]
}

阈值（刻度）

{
    "type": "page",
    "body": {
        "type": "progress",
        "value": 60,
        "threshold": [
            {
                "value": "30%",
                "color": "red"
            },
            {
                "value": "90%",
                "color": "blue"
            }
        ],
        "showThresholdText": true
    }
}

用作 Field 时

当用在 Table 的列配置 Column、List 的内容、Card 卡片的内容和表单的 Static-XXX 中时，可以设置name属性，映射同名变量

Table 中的列类型

{
    "type": "table",
    "data": {
        "items": [
            {
                "id": "1",
                "progress": 20
            },
            {
                "id": "2",
                "progress": 40
            },
            {
                "id": "3",
                "progress": 60
            }
        ]
    },
    "columns": [
        {
            "name": "id",
            "label": "Id"
        },

        {
            "name": "progress",
            "label": "进度",
            "type": "progress"
        }
    ]
}

List 的内容、Card 卡片的内容配置同上

Form 中静态展示

{
    "type": "form",
    "data": {
        "progress": 60
    },
    "body": [
        {
            "type": "static-progress",
            "name": "progress",
            "label": "进度"
        }
    ]
}

显示背景间隔

{
    "type": "page",
    "body": {
        "type": "progress",
        "stripe": true,
        "value": 60
    }
}

显示动画

需要条形进度条才生效

{
    "type": "page",
    "body": [
      {
          "type": "progress",
          "animate": true,
          "value": 60
      },
      {
          "type": "divider"
      },
      {
          "type": "progress",
          "animate": true,
          "value": 60,
          "stripe": true
      }
    ]
}

圆形进度条

{
    "type": "page",
    "body": {
        "type": "progress",
        "value": 60,
        "mode": "circle"
    }
}

仪表盘进度条

可设置缺口位置和缺口角度

{
    "type": "page",
    "body": {
        "type": "progress",
        "value": 60,
        "mode": "dashboard",
        "gapDegree": 22,
        "gapPosition": "bottom"
    }
}

设置线条宽度

可设置 strokeWidth 调整线条宽度

{
    "type": "page",
    "body": [
        {
            "type": "progress",
            "value": 60,
            "mode": "line",
            "strokeWidth": 4
        },
        {
            "type": "progress",
            "value": 60,
            "mode": "line",
            "strokeWidth": 8
        },
        {
            "type": "progress",
            "value": 60,
            "mode": "line",
            "strokeWidth": 12
        },
        {
            "type": "progress",
            "value": 60,
            "mode": "dashboard",
            "strokeWidth": 4
        },
        {
            "type": "progress",
            "value": 60,
            "mode": "dashboard",
            "strokeWidth": 8
        },
        {
            "type": "progress",
            "value": 60,
            "mode": "dashboard",
            "strokeWidth": 12
        },
    ]
}

自定义格式输出内容

{
    "type": "page",
    "body": {
        "type": "progress",
        "mode": "circle",
        "value": 60,
        "valueTpl": "${value}个"
    }
}

属性表

属性名	类型	默认值	说明
type	string		如果在 Form 中用作静态展示，为"static-progress"
mode	string	line	进度「条」的类型，可选line circle dashboard
className	string		外层 CSS 类名
value	模板		进度值
placeholder	string	-	占位文本
showLabel	boolean	true	是否展示进度文本
stripe	boolean	false	背景是否显示条纹
animate	boolean	false	type 为 line，可支持动画
map	string | Array<string> | Array<{value:number, color:string}>	['bg-danger', 'bg-warning', 'bg-info', 'bg-success', 'bg-success']	进度颜色映射
threshold	{value:模板, color?:模板} | Array<{value:模板, color?:模板}>	-	阈值（刻度）
showThresholdText	boolean	false	是否显示阈值（刻度）数值
valueTpl	string	${value}%	自定义格式化内容
strokeWidth	number	line 类型为10，circle、dashboard 类型为6	进度条线宽度
gapDegree	number	75	仪表盘缺角角度，可取值 0 ~ 295
gapPosition	string	bottom	仪表盘进度条缺口位置，可选top bottom left right

动作表

当前组件对外暴露以下特性动作，其他组件可以通过指定actionType: 动作名称、componentId: 该组件id来触发这些动作，动作配置可以通过args: {动作配置项名称: xxx}来配置具体的参数，详细请查看事件动作。

动作名称	动作配置	说明
reset	-	将值重置为 0
setValue	value: string | number 更新的值	更新数据

reset

{
  "type": "page",
  "body": [
    {
      "type": "progress",
      "name": "progress",
      "id": "progress",
      "value": 67
    },
    {
      "type": "button",
      "label": "重置值",
      "onEvent": {
        "click": {
          "actions": [
            {
              "actionType": "reset",
              "componentId": "progress"
            }
          ]
        }
      }
    }
  ]
}

setValue

{
  "type": "page",
  "body": [
    {
      "type": "progress",
      "name": "progress",
      "id": "progress",
      "value": 67
    },
    {
      "type": "button",
      "label": "设置值",
      "onEvent": {
        "click": {
          "actions": [
            {
              "actionType": "setValue",
              "componentId": "progress",
              "args": {
                "value": 20
              }
            }
          ]
        }
      }
    }
  ]
}