Flutter尺子选择插件simple_ruler_picker的使用

简介

SimpleRulerPicker 是一个用于Flutter的可定制化尺子样式数字选择器，允许用户在最小值和最大值之间滚动选择一个数字。

功能特性

• 可滚动数字选择器：用户可以在 minValue 和 maxValue 之间滚动选择。
• 可自定义刻度：可以调整刻度标签大小、刻度项之间的宽度以及尺子线条的高度。

预览

Portrait	Landscape

开始使用

安装

在项目的 pubspec.yaml 文件中添加 simple_ruler_picker：

dependencies:
  simple_ruler_picker: ^0.1.0

或者直接通过命令行安装：

flutter pub add simple_ruler_picker

使用示例

以下是一个完整的示例代码，展示了如何在项目中使用 SimpleRulerPicker：

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

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

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

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      backgroundColor: const Color(0xffF6F8FC),
      body: SafeArea(
        child: SingleChildScrollView(
          child: Column(
            children: [
              PickerCard(
                title: '您的身高',
                height: 180,
                child: SimpleRulerPicker(
                  height: 100,
                  minValue: 0,
                  maxValue: 250,
                  initialValue: 180,
                  onValueChanged: (value) {
                    debugPrint(value.toString());
                  },
                ),
              ),
              PickerCard(
                title: '您的体重',
                height: 200,
                child: SimpleRulerPicker(
                  height: 130,
                  minValue: 50,
                  maxValue: 300,
                  initialValue: 100,
                  selectedColor: Colors.blue,
                  lineStroke: 3,
                  longLineHeight: 50,
                  shortLineHeight: 25,
                  scaleItemWidth: 20,
                  lineColor: Colors.grey,
                  onValueChanged: (value) {
                    debugPrint(value.toString());
                  },
                ),
              ),
              PickerCard(
                title: '垂直轴选择器',
                height: 500,
                width: 200,
                child: Padding(
                  padding: const EdgeInsets.symmetric(vertical: 16),
                  child: SimpleRulerPicker(
                    height: 400,
                    minValue: 50,
                    maxValue: 300,
                    initialValue: 100,
                    selectedColor: Colors.green,
                    lineStroke: 3,
                    longLineHeight: 50,
                    shortLineHeight: 25,
                    scaleItemWidth: 20,
                    scaleLabelSize: 14,
                    scaleLabelWidth: 40,
                    axis: Axis.vertical,
                    lineColor: Colors.grey,
                    onValueChanged: (value) {
                      debugPrint(value.toString());
                    },
                  ),
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Simple Ruler Picker',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const ExamplePage(),
    );
  }
}

class PickerCard extends StatelessWidget {
  final String title;
  final double height;
  final double? width;
  final Widget child;

  const PickerCard({
    super.key,
    required this.title,
    required this.height,
    this.width,
    required this.child,
  });

  @override
  Widget build(BuildContext context) {
    return Container(
      height: height,
      width: width,
      margin: const EdgeInsets.all(16),
      padding: const EdgeInsets.all(16),
      decoration: BoxDecoration(
        color: Colors.white,
        borderRadius: BorderRadius.circular(32),
      ),
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          Text(
            title,
            style: const TextStyle(
              fontSize: 16,
              color: Colors.black,
              fontWeight: FontWeight.bold,
            ),
          ),
          child
        ],
      ),
    );
  }
}

属性说明

其他信息

贡献

我们欢迎贡献！如果您想改进 SimpleRulerPicker 或添加更多功能，请自由地 fork 仓库并提交 pull request。

提交问题

如果发现 bug 或需要增强功能，请在 GitHub 仓库 中提交 issue。