internet_connection_control_alert 0.0.5

Monitors real-time internet connectivity, provides offline mode support, and detects connection disruptions.

The internet_connection_control_alert package is a tool for monitoring internet connectivity in your Flutter applications and notifying users when the connection is lost. This package checks the status of the internet connection and displays a customizable alert dialog.

Features

• Internet Connection Monitoring: Monitors the internet connection of your application in real-time.
• Customizable Alert Dialog: Allows you to customize the alert dialog that is shown when the internet connection is lost.
• Delayed Start: You can delay the start of the connection check by a specified time.
• Dismiss Options: Configure whether the alert dialog can be dismissed by the user.
• Internet Status Visibility: Check the current status of the internet connection with the internet variable.

Installation

To add the package to your project, include the following line in your pubspec.yaml file:

dependencies:
  internet_connection_control_alert: ^1.0.0

Then run flutter pub get in your terminal to install the package. Usage Importing the Package

In your main Dart file, import the package:

import 'package:internet_connection_control_alert/internet_connection_control_alert.dart';

Initialization and Configuration

Use the delayStart() method to check the internet connection and show a customized alert dialog when starting your application:

import 'package:flutter/material.dart';
import 'package:internet_connection_control_alert/internet_connection_control_alert.dart';

void main() =>
    runApp(
      MaterialApp(
        home: Builder(
            builder: (context)
            {
              Internet.delayStart(
                context: context,
                delay: 1000,
                barrier: false,
                alert: AlertDialog(
                  backgroundColor: Colors.white,
                  shape: RoundedRectangleBorder(
                    borderRadius: BorderRadius.circular(25),
                  ),
                  content: Container(
                    height: 200,
                    padding: const EdgeInsets.all(25),
                    child: const Column(
                      mainAxisAlignment: MainAxisAlignment.spaceEvenly,
                      spacing: 20,
                      children:
                      [
                        Icon(Icons.wifi_off_rounded, size: 50),
                        Text(
                          textAlign: TextAlign.center,
                          style: TextStyle(color: Colors.black, fontSize: 15),
                          "Internet is not available at the moment. Please check your internet connection and try again.",
                        )
                      ],
                    ),
                  ),
                ),
              );

              return const Scaffold(
                body: Center(child: Text("Internet Connection Control Alert")),
              );
            }
            ),
      ),
    );

Methods

    Internet.delayStart({required BuildContext context, required int delay, bool? barrier, AlertDialog? alert})

This method waits for the specified delay before starting to check the internet connection. The barrier parameter determines whether the alert dialog can be dismissed by the user. The alert parameter provides a customized AlertDialog. delay: Delay time (milliseconds). barrier: If true, allows the alert dialog to be dismissed; if false, prevents it from being dismissed. alert: The AlertDialog to be shown if there is no internet connection.

    Internet.start({required BuildContext context, bool? barrier, AlertDialog? alert})

This method starts monitoring the internet connection. It listens for connection changes and shows the alert dialog if the internet connection is lost or restored. barrier: If true, allows the alert dialog to be dismissed; if false, prevents it from being dismissed. alert: The AlertDialog to be shown if there is no internet connection.

    Internet.stop()

This method stops monitoring the internet connection and closes any shown alert dialogs.

Checking Internet Status

You can check the current status of the internet connection using the Internet.internet variable. If this variable is true, the internet connection is available; if false, it is not.

Example Usage

import 'package:flutter/material.dart';
import 'package:internet_connection_control_alert/internet_connection_control_alert.dart';

void main() =>
    runApp(
      MaterialApp(
        home: Builder(
            builder: (context)
            {
              Internet.delayStart(
                context: context,
                delay: 1000,
                barrier: false,
                alert: AlertDialog(
                  backgroundColor: Colors.white,
                  shape: RoundedRectangleBorder(
                    borderRadius: BorderRadius.circular(25),
                  ),
                  content: Container(
                    height: 200,
                    padding: const EdgeInsets.all(25),
                    child: const Column(
                      mainAxisAlignment: MainAxisAlignment.spaceEvenly,
                      spacing: 20,
                      children:
                      [
                        Icon(Icons.wifi_off_rounded, size: 50),
                        Text(
                          textAlign: TextAlign.center,
                          style: TextStyle(color: Colors.black, fontSize: 15),
                          "Internet is not available at the moment. Please check your internet connection and try again.",
                        )
                      ],
                    ),
                  ),
                ),
              );

              return const Scaffold(
                body: Center(child: Text("Internet Connection Control Alert")),
              );
            }
            ),
      ),
    );

License

This project is licensed under the MIT License.

This README provides detailed information about the internet_connection_control_alert package and how to use it. Let me know if you need any additions or corrections!