Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/MoZhouqi/KMPlaceholderTextView

A UITextView subclass that adds support for multiline placeholder written in Swift.
https://github.com/MoZhouqi/KMPlaceholderTextView

placeholder placeholdertextview swift uitextview

Last synced: about 1 month ago
JSON representation

A UITextView subclass that adds support for multiline placeholder written in Swift.

Awesome Lists containing this project

README

        

KMPlaceholderTextView
============

A UITextView subclass that adds support for multiline placeholder written in Swift.

![PlaceholderTextView](https://raw.githubusercontent.com/MoZhouqi/KMPlaceholderTextView/master/Screenshots/preview.gif)

## Usage

You can set the value of the `placeholder` property just like using UITextField.

### Interface Builder

![Storyboard](https://raw.githubusercontent.com/MoZhouqi/KMPlaceholderTextView/master/Screenshots/storyboard-setting.gif)

1. Drag a UITextView object onto the canvas.
2. In the Identity inspector, set the Custom Class name to `KMPlaceholderTextView`.
3. In the Attributes inspector, you can change the value of the `placeholder` property directly.

### Code

```swift
let placeholderTextView = KMPlaceholderTextView(frame: view.bounds)
placeholderTextView.placeholder = "What's on your mind?"
view.addSubview(placeholderTextView)
```
## Installation

### CocoaPods

You can install the latest release version of CocoaPods with the following command:

```bash
$ gem install cocoapods
```

Simply add the following line to your Podfile:

```ruby
platform :ios, '8.0'
use_frameworks!

target '' do
pod 'KMPlaceholderTextView', '~> 1.4.0'
end
```

Then, run the following command:

```bash
$ pod install
```

If you are encountering the following warning when using Xcode 8, please make sure to set the Module in the identity inspector of your `KMPlaceholderTextView` in the interface builder to `KMPlaceholderTextView` as well:

> warning: IB Designables: Using class UITextView for object with custom class because the class KMPlaceholderTextView does not exist

### Carthage

[Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage with [Homebrew](http://brew.sh/) using the following command:

```bash
$ brew update
$ brew install carthage
```

To integrate KMPlaceholderTextView into your Xcode project using Carthage, specify it in your `Cartfile`:

```ogdl
github "MoZhouqi/KMPlaceholderTextView" >= 1.4
```

## Requirements

- iOS 7.0+
- Xcode 10

## License

KMPlaceholderTextView is released under the MIT license. See LICENSE for details.