Flutter Cookie同意插件cookie_consent的使用

Flutter Cookie同意插件cookie_consent的使用

在您的Flutter应用或网站中展示一个Cookie同意横幅。

功能

• 可以选择不同的样式来展示同意横幅。
• 用户可以自定义他们接受的类别。

开始使用

TODO: 列出前提条件并提供或指向有关如何开始使用该包的信息。

使用方法

最小所需的输入是一个BuildContext和一个Cookie政策URL：

showCookieConsent(
  context,
  cookiePolicyUrl: Uri.parse('https://example.com/cookies'),
);

有几种布局可供选择：

例如，使用Material SnackBar布局：

showCookieConsent(
  context,
  layout: CookieConsentLayout.materialSnackBar,
  cookiePolicyUrl: Uri.parse('https://example.com/cookies'),
);

我们建议您提供自己的同意文本和类别，以便更好地适应您的应用：

showCookieConsent(
  context,
  cookiePolicyUrl: Uri.parse('https://example.com/cookies'),
  consent: '点击[接受所有Cookie]，即表示您同意我们可以将Cookie存储在您的设备上，并根据我们的[Cookie政策](https://example.com/cookies)披露信息。',
  categories: [
    CookeConsentCategory(
      id: 'necessary',
      name: '严格必要的Cookies',
      description: '必要Cookies是启用此站点基本功能所必需的，例如提供安全登录或调整您的同意偏好。这些Cookies不会存储任何可识别的个人信息。',
    ),
    CookeConsentCategory(
      id: 'advertising',
      name: '广告Cookies',
      description: '广告Cookies用于根据您之前访问过的页面向您提供定制化广告，并分析广告活动的有效性。',
    ),
  ],
);

示例代码

以下是在example/lib/main.dart中提供的完整示例代码：

import 'package:cookie_consent/cookie_consent.dart';
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';

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

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

  // 这个小部件是你的应用程序的根。
  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      title: 'Cookie Consent Demo',
      home: Scaffold(body: DemoPage()),
    );
  }
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    final size = MediaQuery.of(context).size;
    final buttonPadding =
        EdgeInsets.symmetric(horizontal: size.width / 5.0, vertical: 10.0);
    return ListView(
      children: [
        Center(
          child: Padding(
            padding: const EdgeInsets.all(22.0),
            child: Text('Cookie Consent Demo',
                style: Theme.of(context).textTheme.headline3),
          ),
        ),
        Padding(
          padding: buttonPadding,
          child: CupertinoButton.filled(
            onPressed: () => showCookieConsent(
              context,
              layout: CookieConsentLayout.cupertinoAlert,
              cookiePolicyUrl: Uri.parse('https://example.com/cookies'),
            ),
            child: const Text('Cupertino alert'),
          ),
        ),
        Padding(
          padding: buttonPadding,
          child: CupertinoButton.filled(
            onPressed: () => showCookieConsent(
              context,
              layout: CookieConsentLayout.cupertinoBottomSheet,
              cookiePolicyUrl: Uri.parse('https://example.com/cookies'),
            ),
            child: const Text('Cupertino bottom sheet'),
          ),
        ),
        Padding(
          padding: buttonPadding,
          child: CupertinoButton.filled(
            onPressed: () => showCookieConsent(
              context,
              cookiePolicyUrl: Uri.parse('https://example.com/cookies'),
            ),
            child: const Text('Floating bottom sheet'),
          ),
        ),
        Padding(
          padding: buttonPadding,
          child: CupertinoButton.filled(
            onPressed: () => showCookieConsent(
              context,
              layout: CookieConsentLayout.materialAlert,
              cookiePolicyUrl: Uri.parse('https://example.com/cookies'),
            ),
            child: const Text('Material alert'),
          ),
        ),
        Padding(
          padding: buttonPadding,
          child: CupertinoButton.filled(
            onPressed: () => showCookieConsent(
              context,
              layout: CookieConsentLayout.materialBottomSheet,
              cookiePolicyUrl: Uri.parse('https://example.com/cookies'),
            ),
            child: const Text('Material bottom sheet'),
          ),
        ),
        Padding(
          padding: buttonPadding,
          child: CupertinoButton.filled(
            onPressed: () => showCookieConsent(
              context,
              layout: CookieConsentLayout.materialSnackBar,
              cookiePolicyUrl: Uri.parse('https://example.com/cookies'),
            ),
            child: const Text('Material snack bar'),
          ),
        ),
      ],
    );
  }
}