flutter_custom_tabs 1.0.4 icon indicating copy to clipboard operation
flutter_custom_tabs: ^1.0.4 copied to clipboard

Flutter plugin for seamlessly displaying web content using Chrome Custom Tabs.

flutter_custom_tabs #

pub package

A Flutter plugin for launching a URL using Custom Tabs like url_launcher.

The following platforms are supported:

  • Android
  • iOS(*)
  • Web(*)

On Android and iOS, you can customize the screen to display web contents according to your application.

AndroidiOS
androidiOS

*Custom Tabs is a feature that works seamlessly with apps and web content,
and requires browsers such as Chrome on Android.

Therefore, other platforms use different native features.

Getting Started #

Add flutter_custom_tabs to the dependencies of your pubspec.yaml.

dependencies:
  flutter_custom_tabs: ^1.0.4

Requirements #

  • Android Gradle Plugin 4.1 or higher
// your-project/android/build.gradle
buildscript {    
    dependencies {
-        classpath 'com.android.tools.build:gradle:3.x.x'
+        classpath 'com.android.tools.build:gradle:4.1.0' // or higher
    }
}

Usage #

Open the web URL like url_launcher.
It is also possible to customize look & feel by specifying options for each Platform.

Example

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: Scaffold(
        body: Center(
          child: TextButton(
            child: const Text('Show Flutter homepage'),
            onPressed: () => _launchURL(context),
          ),
        ),
      ),
    );
  }

  void _launchURL(BuildContext context) async {
    try {
      await launch(
        'https://flutter.dev',
        customTabsOption: CustomTabsOption(
          toolbarColor: Theme.of(context).primaryColor,
          enableDefaultShare: true,
          enableUrlBarHiding: true,
          showPageTitle: true,
          animation: CustomTabsAnimation.slideIn(),
          // or user defined animation.
          animation: const CustomTabsAnimation(
            startEnter: 'slide_up',
            startExit: 'android:anim/fade_out',
            endEnter: 'android:anim/fade_in',
            endExit: 'slide_down',
          ),
          extraCustomTabs: const <String>[
            // ref. https://play.google.com/store/apps/details?id=org.mozilla.firefox
            'org.mozilla.firefox',
            // ref. https://play.google.com/store/apps/details?id=com.microsoft.emmx
            'com.microsoft.emmx',
          ],
        ),                    
        safariVCOption: SafariViewControllerOption(
          preferredBarTintColor: Theme.of(context).primaryColor,
          preferredControlTintColor: Colors.white,
          barCollapsingEnabled: true,
          entersReaderIfAvailable: false,
          dismissButtonStyle: SafariViewControllerDismissButtonStyle.close,        
        ),
      );
    } catch (e) {
      // An exception is thrown if browser app is not installed on Android device.
      debugPrint(e.toString());
    }
  }
}

License #

Copyright (C) 2015 The Android Open Source Project
Copyright (C) 2018 Shinya Kumagai

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
130
likes
130
pub points
97%
popularity

Publisher

unverified uploader

Flutter plugin for seamlessly displaying web content using Chrome Custom Tabs.

Homepage

Documentation

API reference

License

Icon for licenses.Apache-2.0 (LICENSE)

Dependencies

flutter, flutter_custom_tabs_platform_interface, flutter_custom_tabs_web, meta

More

Packages that depend on flutter_custom_tabs