Flutter角标丝带插件corner_ribbon的使用

Corner Ribbon 是一个 Flutter 小部件，可以让你在任何小部件的角落或边缘添加可自定义的丝带。使用它来轻松地为你的小部件添加诸如“促销”、“新品”或其他自定义标签。

特性

• 可以将丝带放置在任意角落：左上角、右上角、左下角、右下角。
• 支持沿边水平和垂直放置。
• 可以自定义颜色、文本样式、偏移距离和丝带宽度。
• 轻松地将丝带叠加在任何子小部件上。

开始使用

要使用此包，请确保你在 pubspec.yaml 文件中添加了以下依赖项：

dependencies:
  corner_ribbon: ^0.0.1

然后，运行 flutter pub get 来安装该包。

使用方法

以下是一个基本示例，展示了如何使用 CornerRibbon 小部件：

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

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Corner Ribbon Example')),
        body: Center(
          child: CornerRibbon(
            ribbonColor: Colors.red,
            text: "SALE",
            position: RibbonPosition.topRight,
            ribbonStroke: 75,
            cornerOffset: 10,
            textStyle: TextStyle(
              color: Colors.white,
              fontWeight: FontWeight.bold,
              fontSize: 14,
            ),
            child: Container(
              width: 200,
              height: 200,
              color: Colors.grey[300],
            ),
          ),
        ),
      ),
    );
  }
}

属性

• ribbonColor: 丝带背景的颜色。
• text: 显示在丝带上的文本。
• position: 枚举指定丝带的位置（例如，topLeft、bottomRight）。
• ribbonStroke: 丝带的厚度。
• cornerOffset: 偏离角落的距离。
• textStyle: 自定义字体大小、粗细和颜色。
• child: 在其上显示丝带的小部件。

完整示例

以下是一个更完整的示例，展示了如何在不同位置使用 CornerRibbon：

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

void main() {
  runApp(
    MaterialApp(
      title: 'Corner Ribbon Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(),
    ),
  );
}

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

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: const Text('Corner Ribbon Demo'),
      ),
      body: Container(
        padding: const EdgeInsets.all(8.0),
        width: double.maxFinite,
        height: double.maxFinite,
        child: SingleChildScrollView(
          child: Wrap(
            alignment: WrapAlignment.center,
            runSpacing: 16,
            spacing: 16,
            children: [
              for (final position in RibbonPosition.values)
                Container(
                  width: MediaQuery.of(context).size.width * 0.8,
                  height: MediaQuery.of(context).size.width * 0.8,
                  decoration: BoxDecoration(
                    borderRadius: BorderRadius.circular(24),
                  ),
                  clipBehavior: Clip.hardEdge,
                  child: CornerRibbon(
                    ribbonColor: Colors.orange,
                    text: 'Best Seller !!',
                    position: position,
                    textStyle: const TextStyle(
                      fontWeight: FontWeight.bold,
                      color: Colors.black,
                      fontSize: 26,
                    ),
                    child: Image.asset('assets/shoes.png'),
                  ),
                ),
            ],
          ),
        ),
      ),
    );
  }
}

希望这些示例能够帮助你更好地理解和使用 corner_ribbon 插件！