flutter_giphy_picker 1.0.12

A Flutter package for interacting with the Giphy API and a full-featured GIF picker UI, enabling seamless search and selection of GIFs, stickers, and emojis.

flutter_giphy_picker Package

Example of a GIF picker using the flutter_giphy_picker package with giphy_ui library.

This Flutter package provides two main functionalities:

1. Direct Communication with Giphy API: Easily interact with the Giphy API to search for GIFs, stickers, and emojis, retrieve trending items, and more. This part of the package abstracts the complexities of the API, offering simple and intuitive methods for making requests and handling responses.

2. Comprehensive GIF Picker: A fully-featured widget for picking GIFs, stickers, and emojis. The picker integrates seamlessly with the Giphy API, allowing users to browse and select from a wide range of media types. The picker includes built-in search functionality, pagination, and loading indicators to ensure a smooth user experience.

Features

• Giphy API Integration: Direct methods to interact with Giphy’s extensive database of GIFs, stickers, and emojis.
• GIF Picker Widget: A ready-to-use widget for browsing and selecting GIFs, stickers, and emojis, with integrated search and pagination.
• Error Handling: Graceful error handling to manage failed API requests and image loading errors.

Libraries

The package consists of two main libraries:

1. giphy_api: import 'package:flutter_giphy_picker/giphy_api.dart';
2. giphy_ui: import 'package:flutter_giphy_picker/giphy_ui.dart';

Example

To show a GIF picker use the following function:

showGiphyPicker(...);

Here is a simple example of how to use the showGiphyPicker function:

import 'package:flutter/material.dart';
import 'package:flutter_giphy_picker/giphy_ui.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      title: 'Flutter Giphy Test',
      home: Scaffold(
        body: TestApp(),
      ),
    );
  }
}

class TestApp extends StatefulWidget {
  const TestApp({super.key});

  @override
  State<TestApp> createState() => _TestAppState();
}

class _TestAppState extends State<TestApp> {
  GiphyResult? gifUrl;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Test Flutter Giphy'),
      ),
      body: Column(
        children: [
          if (gifUrl != null)
            Center(
              child: Image.network(
                gifUrl!.url,
                fit: BoxFit.contain,
              ),
            ),
          Center(
            child: TextButton(
              onPressed: () async {
                final config = GiphyUIConfig(
                  apiKey: "YOUR_API_KEY",
                );

                // Highlighted call to showGiphyPicker
                final result = await showGiphyPicker(context, config);

                setState(() {
                  gifUrl = result;
                });
              },
              child: const Text("Open giphy UI"),
            ),
          ),
        ],
      ),
    );
  }
}

To directly interact with the Giphy API, use the following class:

import 'package:flutter_giphy_picker/giphy_api.dart';


GiphyAPI(
  apiKey: "YOUR_API_KEY",
  randomID: "YOUR_RANDOM_ID (optional)",
)

Localization

The giphy_ui library supports localization for two languages:

• English
• French

Installation

Add the following to your pubspec.yaml file:

dependencies:
  flutter_giphy_picker: any

Usage

1. Giphy Picker: Call the showGiphyPicker function to open a comprehensive GIF picker interface.

Here’s a simple example to show a GIF:

Image.network(
    gifUrl!.url,
    fit: BoxFit.contain,
),