Skip to content

feat(useMicroLoader): add useMicroLoader #4718

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

feat(useMicroLoader): add useMicroLoader #4718

wants to merge 1 commit into from

Conversation

osovv
Copy link

@osovv osovv commented Apr 21, 2025

Before submitting the PR, please make sure you do the following

  • Read the Contributing Guidelines.
  • Read the Pull Request Guidelines.
  • Check that there isn't already a PR that solves the problem the same way to avoid creating a duplicate.
  • Provide a description in this PR that addresses what the PR is solving, or reference the issue that it solves (e.g. fixes #123).
  • Ideally, include relevant tests that fail without this PR but pass with it.
⚠️ Slowing down new functions

Warning: Slowing down new functions

As the VueUse audience continues to grow, we have been inundated with an overwhelming number of feature requests and pull requests. As a result, maintaining the project has become increasingly challenging and has stretched our capacity to its limits. As such, in the near future, we may need to slow down our acceptance of new features and prioritize the stability and quality of existing functions. Please note that new features for VueUse may not be accepted at this time. If you have any new ideas, we suggest that you first incorporate them into your own codebase, iterate on them to suit your needs, and assess their generalizability. If you strongly believe that your ideas are beneficial to the community, you may submit a pull request along with your use cases, and we would be happy to review and discuss them. Thank you for your understanding.

Description

This PR introduces useMicroLoader, a composable that provides smart loading state management to prevent UI flicker and improve user experience. It's particularly useful for handling both fast and slow network conditions.

Key features:

  • Prevents loading indicator flicker for quick operations
  • Ensures minimum loading time for better UX
  • Adapts to network conditions - won't show loading indicators on fast connections
  • Handles both local operations and network requests efficiently

The composable solves common issues with loading states:

  1. Flickering loading indicators for fast operations (< 300ms by default)
  2. Abruptly disappearing loaders that can be jarring to users
  3. Inconsistent loading experience between fast and slow networks

Additional context

The implementation includes:

  • Comprehensive test coverage for various timing scenarios
  • Interactive demo with visual progress indicators
  • TypeScript support with proper type definitions
  • Documentation with real-world usage examples

@dosubot dosubot bot added size:XL This PR changes 500-999 lines, ignoring generated files. enhancement New feature or request new function labels Apr 21, 2025
@osovv osovv force-pushed the use-micro-loader branch 3 times, most recently from 0f762d1 to 07db88d Compare April 21, 2025 10:08
@dosubot dosubot bot added size:L This PR changes 100-499 lines, ignoring generated files. and removed size:XL This PR changes 500-999 lines, ignoring generated files. labels Apr 21, 2025
@osovv osovv force-pushed the use-micro-loader branch from 07db88d to e8b7b38 Compare April 27, 2025 19:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers
No reviews
Assignees
No one assigned
Labels
enhancement New feature or request new function size:L This PR changes 100-499 lines, ignoring generated files.
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
1 participant
@osovv