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

https://github.com/lemonade-hq/lmdfloatinglabeltextfield

Customisable iOS TextField with floating placeholder
https://github.com/lemonade-hq/lmdfloatinglabeltextfield

component ios lemonade textfield

Last synced: 8 months ago
JSON representation

Customisable iOS TextField with floating placeholder

Awesome Lists containing this project

README

          

# LMDFloatingLabelTextField

[![CI Status](http://img.shields.io/travis/talthent-l/LMDFloatingLabelTextField.svg?style=flat)](https://travis-ci.org/talthent-l/LMDFloatingLabelTextField)
[![Version](https://img.shields.io/cocoapods/v/LMDFloatingLabelTextField.svg?style=flat)](http://cocoapods.org/pods/LMDFloatingLabelTextField)
[![License](https://img.shields.io/cocoapods/l/LMDFloatingLabelTextField.svg?style=flat)](http://cocoapods.org/pods/LMDFloatingLabelTextField)
[![Platform](https://img.shields.io/cocoapods/p/LMDFloatingLabelTextField.svg?style=flat)](http://cocoapods.org/pods/LMDFloatingLabelTextField)

## Demo

![alt text](https://github.com/lemonade-hq/LMDTextField/blob/master/Screenshots/demo.gif)

## Demo #2

![alt text](https://github.com/lemonade-hq/LMDTextField/blob/master/Screenshots/demo2.gif)

## Example

To run the example project, clone the repo, and run `pod install` from the Example directory first.

## Installation

### Cocoapods

Install Cocoapods

```bash
$ gem install cocoapods
```

Add `LMDFloatingLabelTextField` in your `Podfile`.

```ruby
use_frameworks!

pod 'LMDFloatingLabelTextField'
```

Install the pod

```bash
$ pod install
```

### Manually

Copy `LMDFloatingLabelTextField` folder to your project. Enjoy.

## Usage

### Interface Builder
- Drag a `UITextField` to you view, and change its class to `LMDFloatingLabelTextField`
![alt text](https://github.com/lemonade-hq/LMDTextField/blob/master/Screenshots/class_rename.png)

- Click Attributes Inspector ![alt text](https://github.com/lemonade-hq/LMDTextField/blob/master/Screenshots/attributesInspector.png)
and notice the new `Progress Bar` section on top

![alt text](https://github.com/lemonade-hq/LMDTextField/blob/master/Screenshots/inspector_attributes.png)

### Code
- Create a new `LMDFloatingLabelTextField`
```swift
let textfield = LMDFloatingLabelTextField(frame: CGRect(x: 0,
y: 0,
width: 200,
height: 48))
```
- Set the values as you like
```swift
textfield.placeholderText = "Email"
textfield.borderColor = .yellow
textfield.errorBorderColor = .cyan
textfield.themeColor = .red
```

- Add `LMDFloatingLabelTextField` to the view
```swift
self.view.addSubview(textfield)
```

That's it!

## Customizable Properties

`placeholderText` - Please make sure you put something here. it will look awful without it.

`placeholderFont` - Default is system(14).

`placeholderSizeFactor` - While editing, placeholder will shrink according to this number. deafult is 0.7.

`placeholderTextColor` - Default is - ![#B7B7B7](https://placehold.it/15/B7B7B7/000000?text=+) `#B7B7B7`

`themeColor` - Replaces tintColor. Carret color. default is ![#FF0083](https://placehold.it/15/FF0083/000000?text=+) `#FF0083`

`borderColor` - Border color while editing. default is ![#4a4a4a](https://placehold.it/15/4a4a4a/000000?text=+) `#4a4a4a`

`errorBorderColor` - Border color on error. default is ![#FF0083](https://placehold.it/15/FF0083/000000?text=+) `#FF0083`

`textFieldTextColor` - Replaces textColor. default is ![#4A4A4A](https://placehold.it/15/4A4A4A/000000?text=+) `#4A4A4A`

`disabledTextColor` - TextColor when textfield is disabled. default is ![#B7B7B7](https://placehold.it/15/B7B7B7/000000?text=+) `#B7B7B7`

`disabledBackgroundColor` - Background color when textfield is disabled. default is ![#f7f7f7](https://placehold.it/15/f7f7f7/000000?text=+) `#f7f7f7`

`enabledBackgroundColor` - Background color when textfield is not disabled. default is ![#FFFFFF](https://placehold.it/15/FFFFFF/000000?text=+) `#FFFFFF`

`error` - Will change border color to `errorBorderColor` regardless of whether the textField is focused or not.

## Author

Tal Cohen, talthent@gmail.com

LEMONADE INC.

## License

LMDFloatingLabelTextField is available under the MIT license. See the LICENSE file for more info.