84 lines
3.1 KiB
Markdown
84 lines
3.1 KiB
Markdown
# macOS Float Label Pattern Text Field
|
|
|
|
A macOS Cocoa single-line NSTextField that implements the Float Label Pattern. You can read about the float pattern [here](http://mds.is/float-label-pattern/)
|
|
|
|
  
|
|
 [](https://cocoapods.org) [](https://swift.org/package-manager)
|
|
|
|
## Screenshot
|
|
|
|
|
|
|
|
## Why?
|
|
|
|
I was curious as to whether this pattern would work for a Mac program.
|
|
|
|
## Usage
|
|
|
|
### Directly
|
|
Copy the `DSFFloatLabelledTextField.swift` into your project. This class inherits directly from `NSTextField` so all settings that you make on a text field (eg. alignment) should also apply here.
|
|
|
|
### Cocoapods
|
|
|
|
Add `pod 'DSFFloatLabelledTextControl', :git => 'https://github.com/dagronf/DSFFloatLabelledTextControl'` to your podfile.
|
|
|
|
### Interface builder
|
|
|
|
* Drop in a new Text Field into your canvas and set its class to `DSFFloatLabelledTextField`
|
|
* Set the size and style of your primary font as you would a regular text field
|
|
* Set the size of the secondary font via the attributes inspector for the control
|
|
|
|
### Dynamically
|
|
|
|
```
|
|
{
|
|
let field = DSFFloatLabelledTextField()
|
|
field.placeholderString = "Dynamic Created"
|
|
field.font = NSFont.systemFont(ofSize: 16)
|
|
parentView.addSubview(field)
|
|
|
|
/// Setup autolayout constraints
|
|
}
|
|
|
|
func changeFonts()
|
|
{
|
|
self.floatingLabel!.setFonts(
|
|
primary: NSFont.systemFont(ofSize: 16),
|
|
secondary: NSFont.systemFont(ofSize: 10)
|
|
)
|
|
}
|
|
|
|
```
|
|
|
|
## Credits
|
|
|
|
* Pattern devised by [Matt D. Smith](http://mds.is/matt/)
|
|
* Read about the pattern [here](http://mds.is/float-label-pattern/)
|
|
* [UITextField implementation](https://github.com/jverdi/JVFloatLabeledTextField)
|
|
|
|
## License
|
|
|
|
```
|
|
MIT License
|
|
|
|
Copyright (c) 2020 Darren Ford
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in all
|
|
copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
SOFTWARE.
|
|
```
|