Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/iDhaval/DTTextField

DTTextField is a custom textfield with floating placeholder and error label
https://github.com/iDhaval/DTTextField

dttextfield error-label floating-placeholder swift uitextfield xcode

Last synced: about 2 months ago
JSON representation

DTTextField is a custom textfield with floating placeholder and error label

Lists

README

        

# DTTextField

[![Version](https://img.shields.io/badge/Pod-V0.7.0-green.svg)](https://github.com/iDhaval/DTTextField/releases/tag/0.7.0)
[![License](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/iDhaval/DTTextField/blob/master/LICENSE)
[![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/matteocrippa/awesome-swift)
[![Platform](https://img.shields.io/badge/Language-Swift_5.0-orange.svg)](https://developer.apple.com/library/content/documentation/Swift/Conceptual/Swift_Programming_Language/)
![Xcode](https://img.shields.io/badge/Xcode-11.0-blue.svg)

![Demo](https://github.com/iDhaval/DTTextField/blob/master/DTTextField.gif?raw=true)

## Introduction

DTTextField is a UITextField library with floating placeholder and error label.

Floating placeholder inspired from [JVFloatLabeledTextField](https://github.com/jverdi/JVFloatLabeledTextField) :+1:.

## Example

Clone the repo and run the example project from the Example directory.

## Requirements

* Xcode 11.0+
* Swift 5.0+

## Installation

### CocoaPods

DTTextField is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:

```ruby
pod 'DTTextField'
```

### Swift Package Manager

Click `File` -> `Add Packages...`, enter [DTTextField repo's URL](https://github.com/iDhaval/DTTextField).

```swift
https://github.com/iDhaval/DTTextField
```

## Usage

1. Open a storyboard or Xib file.
2. Drag and drop a `UITextField` to a ViewController.
3. In Identity Inspector, replace the class from `UITextField` to `DTTextField` and the module to `DTTextField`.

## Properties

| Property name | Type | Remark |
| ------------- |------------- | ----- |
| errorMessage | String | Add your error message to this property|
| errorFont | UIFont | Change font of error text |
| errorTextColor | UIColor | Change color of error text |
| paddingYErrorLabel | CGFloat | Error text top padding |
| floatPlaceholderColor | UIColor | To change float placeholder color |
| floatPlaceholderActiveColor | UIColor | To change float placeholder color while TextField is active(First responder)|
| floatPlaceholderFont | UIFont | Change font of float placeholder |
| paddingYFloatLabel | CGFloat | float placeholder top padding |
| placeholderColor | UIColor | change placeholder color |
| animateFloatPlaceholder | Bool | animate float placeholder label |
| hideErrorWhenEditing | Bool | hide error label when typing |
| floatingDisplayStatus | enum | maintain display status always, never, defaults |

### Important Properties

| Property name | Type | Remark |
| ------------- |------------- | ----- |
| dtLayer | CALayer | If you want to formate DTTextField than use dtLayer property instead of layer (e.g. background color) |
| borderColor | UIColor | Change border color of DTTextField |
| canShowBorder | Bool | Toggle border of DTTextField |
| dtborderStyle | enum | none, rounded , sqare , top , bottom , left , right |

## Methods

| Method Name | Remark |
| ------------|--------|
| showError | to show error message |
| hideError | to hide error message |

## Note

Don't give height constraint to DTTextField otherwise it won't work properly.

## TODO
* Add inbuilt validation

## Author

Dhaval Thanki :sunglasses:

## License

```DTTextField``` is available under the MIT license. See the [LICENSE](https://github.com/iDhaval/DTTextField/blob/master/LICENSE) file for more info.