Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jpnurmi/cupertino_progress_bar

Cupertino Progress Bar for Flutter
https://github.com/jpnurmi/cupertino_progress_bar

cupertino dart flutter flutter-widget progress-bar

Last synced: 24 days ago
JSON representation

Cupertino Progress Bar for Flutter

Host: GitHub
URL: https://github.com/jpnurmi/cupertino_progress_bar
Owner: jpnurmi
License: bsd-3-clause
Created: 2020-06-13T08:24:25.000Z (over 4 years ago)
Default Branch: main
Last Pushed: 2021-09-02T10:58:42.000Z (about 3 years ago)
Last Synced: 2023-10-29T15:43:28.671Z (about 1 year ago)
Topics: cupertino, dart, flutter, flutter-widget, progress-bar
Language: Dart
Size: 141 KB
Stars: 1
Watchers: 2
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

# Cupertino Progress Bar for Flutter

[![pub](https://img.shields.io/pub/v/cupertino_progress_bar.svg)](https://pub.dev/packages/cupertino_progress_bar)
[![license: BSD](https://img.shields.io/badge/license-BSD-yellow.svg)](https://opensource.org/licenses/BSD-3-Clause)
![build](https://github.com/jpnurmi/cupertino_progress_bar/workflows/build/badge.svg)
[![codecov](https://codecov.io/gh/jpnurmi/cupertino_progress_bar/branch/main/graph/badge.svg)](https://codecov.io/gh/jpnurmi/cupertino_progress_bar)

A progress bar includes a track that fills from left to right to show the progression of a task with
a known duration. Progress bars are non-interactive, although they are often accompanied by a button
for canceling the corresponding operation.

## Screenshots

| Light | Dark |
|:---:|:---:|
| ![Light CupertinoProgressBar](https://raw.githubusercontent.com/jpnurmi/cupertino_progress_bar/master/doc/images/light.png "Light CupertinoProgressBar") | ![Dark CupertinoProgressBar](https://raw.githubusercontent.com/jpnurmi/cupertino_progress_bar/master/doc/images/dark.png "Dark CupertinoProgressBar") |

## Example

```dart
CupertinoProgressBar(
value: 0.77,
)
```

## Guidelines

Always report progress accurately. Don’t display inaccurate progress information just to make your
app appear busy. Only use progress bars for tasks that are quantifiable. Otherwise, use an activity
indicator.

Use progress bars for tasks with a well-defined duration. Progress bars are great for showing the
status of a task, especially when it helps convey how much longer the task needs to complete.

Hide the unfilled portion of track in navigation bars and toolbars. By default, a progress bar’s
track includes both filled and unfilled portions. When used in a navigation bar or toolbar, such as
to denote a page loading, a progress bar should be configured to hide the unfilled portion of the
track.

Consider customizing a progress bar’s appearance to match your app. A progress bar’s appearance can
be adjusted to match your app’s design. You can specify, for example, a custom color for both the
track and fill.