패키지, 저장소 및 앱 카테고리 검색

패키지 상세v0.1.5

clean_settings

합리적인 기본값을 가진 설정 UI 생성기. 반복 코드의 필요성을 제거하고 풍부한 고도로 의견이 강한 위젯을 제공합니다.

30일 다운로드
68
좋아요
62
Pub 점수
40

패키지 설치

flutter pub add clean_settings

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

Clean Settings는 사전에 설계된 의도적인 위젯과 합리적인 기본값을 제공하여 설정 인터페이스 생성을 간소화하는 Flutter 패키지입니다. 반복되는 보일러플레이트 코드를 제거하기 위해 앱 설정용 구조적이고 일관된 UI를 제공하여 개발자가 빠르게 정교하고 전문적인 설정 화면을 만들 수 있도록 합니다. 사용성과 시각적 조화에 중점을 두어 설정 시간을 단축하면서도 커스터마이징의 유연성을 유지합니다. 직관적이고 체계적인 구성 패널이 필요한 앱에 적합합니다.

사용 사례

  • 앱 설정 화면 만들기
  • 사용자 선호도 패널 생성
  • 구성 인터페이스의 빠른 프로토타이핑
  • 설정에서 UI 보일러플레이트 줄이기
  • 일관된 설정 레이아웃 설계

주요 기능

  • 의사결정적인, 즉시 사용 가능한 위젯
  • 합리적인 기본 스타일
  • 최소한의 보일러플레이트
  • 일관된 UI 패턴
  • 기존 앱과의 간편한 통합

적합한 대상

  • 빠른 설정 UI를 원하는 플러터 개발자
  • 복잡한 사용자 선호 설정을 가진 프로젝트
  • 깔끔하고 현대적인 설정 인터페이스가 필요한 앱
  • 디자인 일관성을 우선시하는 팀
  • 개발자가 수동 위젯 스캐폴딩을 피하는 경우

고려 사항

  • 제한된 사용자 정의 유연성
  • 강한 입장을 가진 디자인 선택
  • 매우 고유한 UI에 대한 적응이 필요할 수 있습니다
  • 설정 외 사용 사례에 적합하지 않습니다
  • 업데이트를 위해 GitHub 소스에 의존합니다

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

pub package

clean_settings

Settings UI generator with sane defaults.

Creating a settings screen requires the same boiler plate code over and over. Settings also need a rich set of widgets to cover all possible cases. This library aims to provide sane defaults while creating a setting screen.

Features

  • Setting Sections
  • Out-of-the-box widgets for multiple types
  • Read-only items

Widgets supported

  • Checkbox

Checkbox Widget


SettingCheckboxItem(
    title: 'Smart Reply',
    value: smartReply,
    onChanged: (v) => setState(() => smartReply = v),
    description: 'Show suggested replies when available'),
  • Switch

Switch Widget


SettingSwitchItem(
  title: 'Smart Compose',
  value: smartCompose,
  onChanged: (v) => setState(() => smartCompose = v),
  description: 'Show predictive writing suggestions',
  priority: ItemPriority.high,
),
  • Radio Picker

Radio Picker


SettingRadioItem<String>(
  title: 'Theme',
  displayValue: '$theme theme',
  selectedValue: theme,
  items: [
    SettingRadioValue('Light', 'Light'),
    SettingRadioValue('Dark', 'Dark'),
    SettingRadioValue('System Default', 'System Default'),
  ],
  onChanged: (v) => setState(() => theme = v),
),

  • Text Input

Text Input

SettingTextItem(
  title: 'Auto Reply Message',
  displayValue: autoReplyMessage,
  initialValue: autoReplyMessage,
  hintText: 'Sent by system on away',
  onChanged: (v) => setState(() => autoReplyMessage = v),
),

  • Date and Time Picker

Date Time Picker

SettingDateTimeItem<DateTime>(
  title: 'Next Scheduled Email At',
  displayValue: scheduledEmailSlug,
  onChanged: (v) => setState(() => scheduledEmailDateTime = v),
),
  • Date Picker

Date Picker

SettingDateTimeItem<DateTime>(
  title: 'Date of birth',
  displayValue: dateOfBirthSlug,
  onChanged: (v) => setState(() => dateOfBirth = v),
  timePicker: false,
),
  • Time Picker

Time Picker

SettingDateTimeItem<TimeOfDay>(
  title: 'Daily wake up email',
  displayValue: dailyEmailAt.format(context),
  onChanged: (v) => setState(() => dailyEmailAt = v),
  datePicker: false,
),
  • Wheel - Number List

Wheel Number

SettingWheelPickerItem(
  title: 'Days of mail to sync',
  displayValue: daysOfMailToSync.toString(),
  initialValueIndex: daysOfMailToSync,
  items: List.generate(10, (index) => index.toString()),
  onChanged: (v) => setState(() => daysOfMailToSync = v),
),
  • Wheel - Text

Wheel Text

var replyOptions = ['Reply', 'Reply All', 'Last Chosen', 'None'];
SettingWheelPickerItem(
  title: 'Default reply action',
  displayValue: replyOptions[chosenReplyOptionIndex],
  initialValueIndex: chosenReplyOptionIndex,
  items: replyOptions,
  onChanged: (v) => setState(() => chosenReplyOptionIndex = v),
),

  • Confirm Dialog

Confirm Dialog

SettingConfirmItem(
  title: 'Delete account',
  displayValue: 'Permanently deletes your account',
  alertTitle: 'Delete your account',
  alertMessage: 'Are you sure?',
  priority: ItemPriority.high,
  onConfirm: () => {},
  onCancel: () => {},
),

  • Custom Handler

Custom Handler

SettingItem(
  title: 'Simple Counter',
  displayValue: counter.toString(),
  onTap: () => setState(() => counter++),
),

Structure


Root - SettingContainer
         \
          \_ SettingSection
                 \
                  \_ SettingItem (or Variants) 

Common Options

  • priority

Set the priority of the item to one of:

  • ItemPriority.high - Shows red color
  • ItemPriority.normal - Default color
  • ItemPriority.low - Shows in green color
  • ItemPriority.disabled - Disables the item

Example

Creates a simple Checkbox setting item

SettingContainer(
  sections: [
    SettingSection(
      title: 'Appearance',
      items: [
        SettingCheckboxItem(
            title: 'Smart Reply',
            value: smartReply,
            onChanged: (v) => setState(() => smartReply = v),
            description: 'Show suggested replies when available'),
      ],
    ),
  ],
)

Notes

  • Early version
  • API bound to change as more widgets get added
  • Please report bugs/issues/features

Buy Me A Coffee

Buy Me A Coffee

카테고리

소스 저장소

이 패키지를 사용하는 프로젝트

아직 데이터가 없습니다.