Flutter波斯语日期选择器插件persian_easy_date_picker的使用

Persian Easy Date Picker 是一个功能丰富且可定制的波斯日期选择器包，适用于Flutter应用程序。它支持各种配置，如自定义颜色、过去和未来的日期选择以及模糊背景，使其非常适合任何波斯日期选择的需求。

特性

• 可定制UI: 可以更改边框半径、颜色、文本等。
• 步进导航: 选项用于显示年、月和日的选择步骤。
• 限制过去和未来的日期选择: 配置用户是否可以选择过去的或未来的日期。
• 模糊背景: 为对话框添加时尚的模糊背景。
• 错误处理: 自定义回调来处理错误。

安装

在你的 pubspec.yaml 文件中添加以下行：

dependencies:
  persian_easy_date_picker: latest_version

然后运行：

flutter pub get

使用

以下是如何在Flutter项目中使用波斯日期选择器的示例：

import 'package:persian_easy_date_picker/persian_easy_date_picker.dart';

void selectDate(BuildContext context) async {
  String? selectedDate = await PersianDatePicker.pick(
    context: context,
    onError: (error) {
      print('Error: $error');
    },
    showStepper: true,
    borderRadius: 7.0,
    blurredBackground: true,
    startYear: 1380,
    endYear: 1408,
    autoPick: false,
  );

  if (selectedDate != null) {
    print('Selected Date: $selectedDate');
  }
}

参数

pick 函数接受多个参数进行定制：

示例

要使用此包，可以将日期选择逻辑包装在一个小部件或函数中：

ElevatedButton(
  onPressed: () => selectDate(context),
  child: Text('Pick Date'),
);

错误处理

onError 回调处理任何错误或无效的选择，例如：

• 当 canSelectPastTime 为 false 时选择过去的日期。
• 当 canSelectFutureTime 为 false 时选择未来的日期。
• 在未做出选择的情况下关闭对话框。

示例：

onError: (error) {
  print('Error: $error');
}

示例代码

以下是完整的示例代码：

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

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const ExampleWidget(),
    );
  }
}

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

  [@override](/user/override)
  State<ExampleWidget> createState() => _ExampleWidgetState();
}

class _ExampleWidgetState extends State<ExampleWidget> {
  String date = 'Nothing selected yet!';

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          crossAxisAlignment: CrossAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () async {
                String? selectedDate = await PersianDatePicker.pick(
                  context: context,
                  onError: (e) {
                    print('Void call back text : $e');
                  },
                  showStepper: true,
                  borderRadius: 7,
                  blurredBackground: true,
                  startYear: 1380,
                  endYear: 1408,
                  autoPick: false,
                );
                setState(() {
                  if (selectedDate != null) {
                    date = selectedDate;
                  }
                });
              },
              child: const Text('Pick Shamsi Date'),
            ),
            const SizedBox(height: 30,),
            Text(date),
          ],
        ),
      ),
    );
  }
}