SwiftyFORM

KO | EN

gitlite — search

#javascript #hacktoberfest #llm #go #golang #machine-learning #java #awesome #cli #kubernetes #awesome-list #pytorch #security #mcp

(★ 1,069)

iOS framework for creating forms

파일 탐색기

최종 버전 다운로드 (.zip)

- change_password_form.gif
- hire_simon_strandgaard@2x.png
- light_and_dark1.png
- swiftyform_logo.png
- swiftyform_logo.sketch
- - LaunchScreen.storyboard
- - CustomViewController.swift
  - LoadingCell.swift
  - LoadingCell.xib
- - DatePickerBindingViewController.swift
  - DatePickerInitialValueViewController.swift
  - DatePickerLocaleViewController.swift
  - DatePickerRangeViewController.swift
- - HeaderFooterViewController.swift
  - NoHeaderViewController.swift
- - Contents.json
- - LabViewController.swift
  - ScientificSliderViewController.swift
- - MyCollectionViewController.swift
  - MyTableViewController.swift
- - ButtonsViewController.swift
  - OptionsViewController.swift
  - PickerViewViewController.swift
  - PrecisionSlidersViewController.swift
  - ReloadingViewController.swift
  - SegmentedControlsViewController.swift
  - SlidersAndTextFieldsViewController.swift
  - SlidersViewController.swift
  - StaticTextAndAttributedTextViewController.swift
  - SteppersViewController.swift
- - Settings.storyboard
  - SettingsViewController.swift
- - StoryboardDemoViewController.swift
  - VoteViewController.storyboard
  - VoteViewController.swift
- - TextFieldEditingEndViewController.swift
  - TextFieldKeyboardTypesViewController.swift
  - TextFieldReturnKeyViewController.swift
  - TextFieldTabThroughFormViewController.swift
  - TextFieldValidInvalidViewController.swift
- - TextViewViewController.swift
- - Tutorial0_StaticText_ViewController.swift
  - Tutorial1_TextField_ViewController.swift
  - Tutorial2_ChildViewController_ViewController.swift
- - ChangePasswordViewController.swift
  - ColorPickerViewController.swift
  - MaleFemaleViewController.swift
  - RateAppViewController.swift
  - ReportViewController.swift
  - SignUpViewController.swift
- AppDelegate.swift
- FirstViewController.swift
- Info.plist
- project.pbxproj
- - AttributedTextCell.swift
  - ButtonCell.swift
  - DatePickerCell.swift
  - OptionCell.swift
  - OptionViewControllerCell.swift
  - PickerViewCell.swift
  - PrecisionSliderCell.swift
  - SegmentedControlCell.swift
  - SimpleToolbar.swift
  - SliderCell.swift
  - StaticTextCell.swift
  - StepperCell.swift
  - SwitchCell.swift
  - TextFieldCell.swift
  - TextViewCell.swift
  - ViewControllerCell.swift
- - AccessoryButtonDelegate.swift
  - AssignAppearance.swift
  - Bundle+LoadView.swift
  - CellDeselector.swift
  - CellForRowDelegate.swift
  - CellHeightProvider.swift
  - Command.swift
  - CustomizableButton.swift
  - CustomizableLabel.swift
  - DontCollapseWhenScrolling.swift
  - DumpVisitor.swift
  - FormBuilder.swift
  - FormTableView.swift
  - FormViewController.swift
  - OptionListViewController.swift
  - PopulateTableView.swift
  - ReloadPersistentValidationStateVisitor.swift
  - SelectOptionDelegate.swift
  - SelectRowDelegate.swift
  - TableViewCellArray.swift
  - TableViewSection.swift
  - TableViewSectionArray.swift
  - TableViewSectionPart.swift
  - TitleWidth.swift
  - ToggleExpandCollapse.swift
  - ValidateResult.swift
  - ValidateVisitor.swift
  - Validator.swift
  - WillDisplayCellDelegate.swift
- - AttributedTextFormItem.swift
  - ButtonFormItem.swift
  - CustomFormItem.swift
  - DatePickerFormItem.swift
  - FormItem.swift
  - MetaFormItem.swift
  - OptionPickerFormItem.swift
  - PickerViewFormItem.swift
  - PrecisionSliderFormItem.swift
  - SectionFormItem.swift
  - SegmentedControlFormItem.swift
  - SliderFormItem.swift
  - StaticTextFormItem.swift
  - StepperFormItem.swift
  - SwitchFormItem.swift
  - TextFieldFormItem.swift
  - TextViewFormItem.swift
  - ViewControllerFormItem.swift
- - PrecisionSlider.swift
  - PrecisionSlider_InnerCollectionViewCells.swift
  - PrecisionSlider_InnerModel.swift
  - PrecisionSlider_InnerZoomMode.swift
- - CharacterSetSpecification.swift
  - CountSpecification.swift
  - EmailSpecification.swift
  - Operator.swift
  - PredicateSpecification.swift
  - RegularExpressionSpecification.swift
  - Specification.swift
- - Colors.swift
  - DebugViewController.swift
  - Dictionary+Update.swift
  - DynamicUIColor.swift
  - KeyboardHandler.swift
  - Logging.swift
  - ShowInfo.swift
  - SubmitButton.swift
  - UITableView+PrevNext.swift
  - UITableView+ScrollToVisibleAfterExpand.swift
  - UIView+FirstResponder.swift
  - UIView+LookupCell.swift
  - UIView+LookupTableView.swift
  - UIViewController+Alert.swift
- Info.plist
- SwiftyFORM.h
- project.pbxproj
- - IDEWorkspaceChecks.plist
- contents.xcworkspacedata
- - AdvancedTests.csv
  - AdvancedTests.swift
  - CharacterSetSpecificationTests.swift
  - CountSpecificationTests.swift
  - EmailSpecificationTests.swift
  - OperatorTests.swift
  - PredicateSpecificationTests.swift
  - RegularExpressionSpecificationTests.swift
  - SpecificationTests.swift
  - TrueFalseTests.swift
- Info.plist
- JSONHelperTests.swift
- PrecisionSliderTests.swift
- PrevNextTests.swift
- ValidateResultTests.swift
- ValidatorTests.swift
.gitignore
.travis.yml
CHANGELOG.md
CREDITS.md
LICENSE.txt
Package.swift
README.md
SwiftyFORM.podspec

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h3 align="center">
<a href="https://github.com/neoneye/SwiftyFORM">
<img src="Documentation/swiftyform_logo.png" alt="SwiftyFORM by Simon Strandgaard"/>
<br />
SwiftyFORM
</a>
</h3>

---

<p align="center">
    <b>SwiftyFORM is a lightweight iOS framework for creating forms</b>
</p>

Because form code is hard to write, hard to read, hard to reason about. Has a slow turn around time. Is painful to maintain.

[SwiftyFORM demo on YouTube](https://youtu.be/PKbVJ91uQdA)

## Requirements

- iOS 12+
- Xcode 12+
- Swift 5.1+

## Features

- [x] Several form items, such as textfield, buttons, sliders
- [x] Some form items can expand/collapse, such as datepicker, pickerview
- [x] You can create your own custom form items
- [x] Align textfields across multiple rows
- [x] Form validation rule engine
- [x] Shows with red text where there are problems with validation
- [x] Strongly Typed
- [x] Pure Swift
- [x] No 3rd party dependencies

# USAGE

### Tutorial 0 - Static text

```swift
import SwiftyFORM
class MyViewController: FormViewController {
    override func populate(_ builder: FormBuilder) {
        builder += StaticTextFormItem().title("Hello").value("World")
    }
}
```

### Tutorial 1 - TextField

```swift
import SwiftyFORM
class MyViewController: FormViewController {
    override func populate(_ builder: FormBuilder) {
        builder += TextFieldFormItem().title("Email").placeholder("Please specify").keyboardType(.emailAddress)
    }
}
```

### Tutorial 2 - Open child view controller

```swift
import SwiftyFORM
class MyViewController: FormViewController {
    override func populate(_ builder: FormBuilder) {
        builder += ViewControllerFormItem().title("Go to view controller").viewController(FirstViewController.self)
    }
}
```

### Advanced - date picker

```swift
class DatePickerBindingViewController: FormViewController {
    override func populate(_ builder: FormBuilder) {
        builder += datePicker
        builder += incrementButton
        builder += decrementButton
        builder += SectionFormItem()
        builder += summary
        updateSummary()
    }
    
    lazy var datePicker: DatePickerFormItem = {
        let instance = DatePickerFormItem()
        instance.title = "Date"
        instance.datePickerMode = .date
        instance.behavior = .expandedAlways
        instance.valueDidChangeBlock = { [weak self] _ in
            self?.updateSummary()
        }
        return instance
    }()
    
    lazy var incrementButton: ButtonFormItem = {
        let instance = ButtonFormItem()
        instance.title = "Next Day"
        instance.action = { [weak self] in
            self?.increment()
        }
        return instance
    }()
    
    lazy var decrementButton: ButtonFormItem = {
        let instance = ButtonFormItem()
        instance.title = "Previous Day"
        instance.action = { [weak self] in
            self?.decrement()
        }
        return instance
    }()
    
    lazy var summary: StaticTextFormItem = {
        return StaticTextFormItem().title("Date").value("-")
    }()
    
    func updateSummary() {
        summary.value = "\(datePicker.value)"
    }
    
    func offsetDate(_ date: Date, days: Int) -> Date {
        var dateComponents = DateComponents()
        dateComponents.day = days
        let calendar = Calendar.current
        guard let resultDate = calendar.date(byAdding: dateComponents, to: date) else {
            return date
        }
        return resultDate
    }
    
    func increment() {
        datePicker.setValue(offsetDate(datePicker.value, days: 1), animated: true)
        updateSummary()
    }
    
    func decrement() {
        datePicker.setValue(offsetDate(datePicker.value, days: -1), animated: true)
        updateSummary()
    }
}
```

### Advanced - Validation

![Change password form](https://github.com/neoneye/SwiftyFORM/raw/master/Documentation/change_password_form.gif "Change password form")

```swift
class ChangePasswordViewController: FormViewController {
    override func populate(_ builder: FormBuilder) {
        builder.navigationTitle = "Password"
        builder += SectionHeaderTitleFormItem().title("Your Old Password")
        builder += passwordOld
        builder += SectionHeaderTitleFormItem().title("Your New Password")
        builder += passwordNew
        builder += passwordNewRepeated
        builder.alignLeft([passwordOld, passwordNew, passwordNewRepeated])
    }
    
    lazy var passwordOld: TextFieldFormItem = {
        let instance = TextFieldFormItem()
        instance.title("Old password").password().placeholder("required")
        instance.keyboardType = .numberPad
        instance.autocorrectionType = .no
        instance.validate(CharacterSetSpecification.decimalDigitCharacterSet(), message: "Must be digits")
        instance.submitValidate(CountSpecification.min(4), message: "Length must be minimum 4 digits")
        instance.validate(CountSpecification.max(6), message: "Length must be maximum 6 digits")
        return instance
        }()
    
    lazy var passwordNew: TextFieldFormItem = {
        let instance = TextFieldFormItem()
        instance.title("New password").password().placeholder("required")
        instance.keyboardType = .numberPad
        instance.autocorrectionType = .no
        instance.validate(CharacterSetSpecification.decimalDigitCharacterSet(), message: "Must be digits")
        instance.submitValidate(CountSpecification.min(4), message: "Length must be minimum 4 digits")
        instance.validate(CountSpecification.max(6), message: "Length must be maximum 6 digits")
        return instance
        }()
    
    lazy var passwordNewRepeated: TextFieldFormItem = {
        let instance = TextFieldFormItem()
        instance.title("Repeat password").password().placeholder("required")
        instance.keyboardType = .numberPad
        instance.autocorrectionType = .no
        instance.validate(CharacterSetSpecification.decimalDigitCharacterSet(), message: "Must be digits")
        instance.submitValidate(CountSpecification.min(4), message: "Length must be minimum 4 digits")
        instance.validate(CountSpecification.max(6), message: "Length must be maximum 6 digits")
        return instance
        }()
}
```

# INSTALLATION

## Swift Package Manager

With Swift Package Manager support in the latest Xcode, installation has never been easier.

Open your Xcode project -> `File` -> `Swift Packages` -> `Add Package Dependency...`

Search for `SwiftyFORM` and specify the version you want. The latest tagged release is usually a good idea.

## CocoaPods

To integrate SwiftyFORM into your Xcode project using CocoaPods, specify the following in your `Podfile`:

```ruby
source 'https://github.com/CocoaPods/Specs.git'
swift_version = '5.0'
platform :ios, '12.0'
use_frameworks!

target 'MyApp' do
    pod 'SwiftyFORM', '~> 1.8'
end
```

Then, run the following command:

```bash
$ pod install
```

## Carthage

[Link to demo project that shows a minimal SwiftyFORM app using Carthage](https://github.com/neoneye/SwiftyFORM-Carthage-Example).

To integrate SwiftyFORM into your Xcode project using Carthage, specify it in your `Cartfile`:
```
github "neoneye/SwiftyFORM" ~> 1.8
```

Then, run the following command:
```bash
$ carthage update
```

Finally, add `SwiftyFORM.framework` (will be built by Carthage under `Carthage/Build/iOS/`) to your project's _Linked Frameworks and Libraries_ in the _General_ tab, and add a new _Run Script_ Build Phase:
- Set `/bin/bash` as the shell
- write `/usr/local/bin/carthage copy-frameworks` in the script body
- add `$(SRCROOT)/Carthage/Build/iOS/SwiftyFORM.framework` to the input files

## Manual

1. Open up Terminal application and cd into your iOS project directory

2. ONLY IF your project is not already initialized as a git repository, run
```
$ git init
```

3. Add `SwiftyFORM` as a submodule by running
```
$ git submodule add https://github.com/neoneye/SwiftyFORM.git
```

4. In the Project Navigator, select your application project and go to "Targets" -> "General"

5. Open the project folder and drag the `SwiftyFORM.xcodeproj` file into the "Frameworks, Libraries, and Embedded Content" tab of your application.

6. Click the `+` button under the "Frameworks, Libraries, and Embedded Content" section and `Add` the `SwiftyFORM.framework`

# Communication

- If you want to contribute, submit a pull request.
- If you found a bug, have suggestions or need help, please, open an issue.
- If you need help, write me: neoneye@gmail.com

SwiftyFORM

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

SwiftyFORM

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README