Matarialize中文技术社区-vue-material专栏-Vue Material 组件 Progress Bar 的使用详解

Vue Material 组件 Progress Bar 的使用详解

Progress Bar

在现代 Web 应用中，Progress Bar（进度条）是一个常见的 UI 元素，用于显示某项操作的进度，例如文件上传、数据加载等。Vue Material 框架中提供了 md-progress 组件，用于轻松实现进度条的功能。本文将详细介绍 Vue Material 中 md-progress 组件的使用，涵盖所有属性、方法及其与其他组件的结合使用，并提供多个详细的示例代码。

1. 介绍 `md-progress`

md-progress 组件是 Vue Material 提供的一个用于展示进度的 UI 组件。它支持多种进度类型（线性、圆形）和样式（定时进度、无限加载等）。进度条可以通过数据驱动，用户可以看到任务完成的可视化状态。

2. 基本用法

首先，确保你已经在项目中安装并配置好了 Vue Material。

安装 Vue Material

npm install vue-material --save

在你的项目中引入并配置 Vue Material：

import Vue from 'vue';
import VueMaterial from 'vue-material';
import 'vue-material/dist/vue-material.min.css';
import 'vue-material/dist/theme/default.css';

Vue.use(VueMaterial);

线性进度条的基本示例

<template>
  <div>
    <md-progress :md-value="progress"></md-progress>
    <md-button @click="increaseProgress" class="md-raised md-primary">增加进度</md-button>
  </div>
</template>

<script>
export default {
  data() {
    return {
      progress: 0
    };
  },
  methods: {
    increaseProgress() {
      if (this.progress < 100) {
        this.progress += 10;
      }
    }
  }
}
</script>

说明

md-progress 组件通过 md-value 属性接收当前进度的值（0-100 范围）。
在示例中，点击按钮后通过 increaseProgress 方法每次将进度增加 10%，并更新进度条显示。

3. 不同类型的进度条

md-progress 组件支持两种主要类型的进度条：

线性进度条 (md-progress)
圆形进度条 (md-progress-spinner)

圆形进度条的示例

<template>
  <div>
    <md-progress-spinner :md-diameter="50" :md-value="progress"></md-progress-spinner>
    <md-button @click="increaseProgress" class="md-raised md-primary">增加进度</md-button>
  </div>
</template>

<script>
export default {
  data() {
    return {
      progress: 0
    };
  },
  methods: {
    increaseProgress() {
      if (this.progress < 100) {
        this.progress += 10;
      }
    }
  }
}
</script>

说明

md-progress-spinner 用于创建圆形的进度条，md-diameter 属性可以设置圆的直径。
md-value 属性同样用于控制进度百分比。

4. 进度条的样式自定义

Vue Material 提供了多种方式来自定义 md-progress 组件的样式，包括颜色、大小、动画等。

自定义进度条颜色

<template>
  <div>
    <md-progress md-color="primary" :md-value="progress"></md-progress>
    <md-progress md-color="accent" :md-value="progress"></md-progress>
    <md-progress md-color="warn" :md-value="progress"></md-progress>
  </div>
</template>

说明

md-color 属性允许你为进度条应用不同的颜色。Vue Material 提供了 primary、accent 和 warn 三种预定义的颜色。
你还可以通过 CSS 自定义进度条颜色。

设置进度条的高度

<template>
  <div>
    <md-progress :md-value="progress" md-height="8"></md-progress>
  </div>
</template>

说明

md-height 属性允许你自定义进度条的高度（默认单位为 px）。
在上例中，进度条的高度被设置为 8px。

5. 无穷加载进度条

有时我们需要展示一个正在进行的任务，但不知道它具体会在什么时候结束，这时可以使用无穷加载的进度条。

示例：无限加载的线性进度条

<template>
  <div>
    <md-progress md-indeterminate></md-progress>
  </div>
</template>

说明

使用 md-indeterminate 属性可以创建一个持续加载的线性进度条，这种进度条没有固定的进度值，适合显示任务在进行但未确定结束时间的场景。

示例：无限加载的圆形进度条

<template>
  <div>
    <md-progress-spinner md-indeterminate></md-progress-spinner>
  </div>
</template>

说明

同样，md-progress-spinner 组件也支持 md-indeterminate 属性，用于创建一个持续旋转的圆形加载指示器。

6. 与其他组件的结合使用

md-progress 可以很容易地与其他组件结合使用。一个常见的场景是在页面加载时显示进度条，结合 md-button 或 md-dialog 等组件。

示例：文件上传进度条

<template>
  <div>
    <md-button @click="startUpload" class="md-raised md-primary">开始上传</md-button>
    <md-progress :md-value="uploadProgress" v-if="uploading"></md-progress>
    <p v-if="!uploading && uploadProgress === 100">上传完成</p>
  </div>
</template>

<script>
export default {
  data() {
    return {
      uploading: false,
      uploadProgress: 0
    };
  },
  methods: {
    startUpload() {
      this.uploading = true;
      this.uploadProgress = 0;
      let interval = setInterval(() => {
        if (this.uploadProgress < 100) {
          this.uploadProgress += 10;
        } else {
          clearInterval(interval);
          this.uploading = false;
        }
      }, 500);
    }
  }
}
</script>

说明

这个示例模拟了文件上传的场景，点击按钮后启动上传进度，每 0.5 秒进度增加 10%，直到完成上传。
当上传完成时，隐藏进度条并显示“上传完成”的文字。

结合 `md-dialog` 使用

你可以将 md-progress 与 md-dialog 结合起来使用，创建在数据加载或文件上传时的弹出进度条。

<template>
  <div>
    <md-button @click="showDialog" class="md-raised md-primary">显示对话框</md-button>
    <md-dialog :md-active.sync="isDialogActive">
      <md-dialog-title>数据加载中</md-dialog-title>
      <md-dialog-content>
        <md-progress :md-value="loadingProgress"></md-progress>
      </md-dialog-content>
      <md-dialog-actions>
        <md-button @click="closeDialog">关闭</md-button>
      </md-dialog-actions>
    </md-dialog>
  </div>
</template>

<script>
export default {
  data() {
    return {
      isDialogActive: false,
      loadingProgress: 0
    };
  },
  methods: {
    showDialog() {
      this.isDialogActive = true;
      this.loadingProgress = 0;
      let interval = setInterval(() => {
        if (this.loadingProgress < 100) {
          this.loadingProgress += 20;
        } else {
          clearInterval(interval);
        }
      }, 500);
    },
    closeDialog() {
      this.isDialogActive = false;
    }
  }
}
</script>

说明

md-dialog 用于创建对话框，而 md-progress 被嵌入在 md-dialog-content 中用于显示数据加载的进度。
你可以通过点击按钮打开对话框，并在对话框中显示加载进度，模拟数据加载完成后用户可以关闭对话框。

7. 使用动画

md-progress 和 md-progress-spinner 都支持 CSS 动画，默认会根据进度值的变化自动执行动画效果。你还可以通过自定义 CSS 来增强或修改默认动画效果。

8. 属性总结

属性	说明	默认值
`md-value`	设置进度条的进度，值为 0 到 100	无
`md-color`	设置进度条的颜色，可选`primary`、`accent`、`warn`	无
`md-height`	设置线性进度条的高度，默认单位为`px`	`4

9. 总结

Vue Material 框架中的 md-progress 组件提供了强大且灵活的进度显示功能。无论是线性进度条还是圆形进度条，开发者都可以通过简单的配置来满足不同的 UI 需求。此外，md-progress 组件能够与其他组件灵活组合，进一步提升了用户交互的体验。在实际项目中，你可以根据需要自由定制进度条的样式和行为，以构建更加生动的用户界面。

通过本文的详细讲解和丰富的示例，相信你已经对 Vue Material 的 md-progress 组件有了全面的认识和掌握。希望这篇文章能帮助你在项目中灵活使用这一组件！

评论区

评论列表

{{ rItem.user.nickname || rItem.user.username }} @ {{ rItem.toUser.nickname || rItem.toUser.username }}