Files
WeatherMaster/expressive_loading_indicator_modified/README.md
T

76 lines
2.7 KiB
Markdown

# Expressive Loading Indicator
> Archival notice: Refer to the implementation at [ksokolovskyi/material_loading_indicator](https://github.com/ksokolovskyi/material_loading_indicator).
[![Pub](https://img.shields.io/pub/v/expressive_loading_indicator.svg)](https://pub.dartlang.org/packages/expressive_loading_indicator)
Material 3 Expressive loading indicator ported to Flutter.
[![Expressive Loading Indicator Demo](https://github.com/user-attachments/assets/d5ee926f-7cae-4824-8a37-e844b7ebee4f)](https://github.com/user-attachments/assets/d5ee926f-7cae-4824-8a37-e844b7ebee4f)
## Package
[`expressive_loading_indicator` on pub.dev](https://pub.dev/packages/expressive_loading_indicator).
## Usage
```dart
import 'package:expressive_loading_indicator/expressive_loading_indicator.dart';
import 'package:material_new_shapes/material_new_shapes.dart';
ExpressiveLoadingIndicator(
// Custom color
color: Colors.purple,
// Custom size constraints
constraints: BoxConstraints(
minWidth: 64.0,
minHeight: 64.0,
maxWidth: 64.0,
maxHeight: 64.0,
),
// Custom polygon shapes
polygons: [
MaterialShapes.softBurst,
MaterialShapes.pentagon,
MaterialShapes.pill,
],
// Accessibility
semanticsLabel: 'Loading',
semanticsValue: 'In progress',
)
```
## TODO
- [ ] Add support for ContainedLoadingIndicator - A version that shows the loading indicator inside a container with a background
- [ ] Add support for DeterminateLoadingIndicator - A version that morphs depending on the progress value
## Credits
- [Kostia Sokolovskyi](https://github.com/ksokolovskyi) for their initial implementation of [material_shapes](https://github.com/ksokolovskyi/material_shapes).
## External Links
- [Loading Indicator](https://m3.material.io/components/loading-indicator/overview) on Material Design.
- [Kotlin source implementation](https://cs.android.com/androidx/platform/frameworks/support/+/androidx-main:compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/LoadingIndicator.kt) on Android Code Search.
## License & Attribution
This package is available under the [MIT License](LICENSE).
This package contains Dart ports of components from the Android Open Source Project (AOSP). The original Android components are licensed under the Apache License 2.0.
See [NOTICE](NOTICE) for complete attribution and license details.
## Contributing
Contributions are welcome! Please feel free to submit an Issue or Pull Request.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/amazing-feature`)
3. Commit your Changes (`git commit -m 'Add some amazing feature'`)
4. Push to the Branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request