A community-driven DSL for creating user interfaces on the iphone.
By including the
Teacup module, you can easily create layouts that adhere to
the iOS user interface guidelines, and it's an easy way to assign labels,
delegators, and datasources.
The goal is not to simply rename CocoaTouch method names, but to offer a rubyesque (well, actually a rubymotion-esque) way to create an interface.
Using stylesheets and layouts, it makes coding an iOS app like designing a website with HTML and CSS.
Check out a working sample app here!
$ gem install teacup --pre # --pre means this is a *pre-release* version.
Then add the teacup library to your Rakefile, just after motion itself:
$:.unshift("/Library/RubyMotion/lib") require 'motion/project' require 'teacup'
class SomeController < UIViewController def viewDidLoad @field = UITextField.new @field.height = 50 @field.width = 200 view.addSubview(@field) @search = UITextField.new @search.height = 50 @search.width = 200 @search.placeholder = 'Find something...' view.addSubview(@search) true end end
# Stylesheet Teacup::StyleSheet.new(:IPhone) do style :field, height: 50, width: 200 style :search, extends: :field, placeholder: 'Foo...' end # Controller class SomeController < UIViewController def viewDidLoad view.addSubview(Teacup.style(:field, UITextField.new)) view.addSubview(Teacup.style(:search)) true end end
Current version: v0.0.0 (or see
Last milestone: Pick a name
Next milestone: Pick a DSL
teacup, being a community project, moves in "spurts" of decision making and coding. Only the name — both the least and most important part :-) — is decided.
We would love suggestions of any sort, and we're always free over at the
#teacuprb channel on
Ideas that proposals should keep in mind
- output will conform, unless explicitly disabled to the iOS HIG
should provide a few useful layouts (see readme for layout proposals):
- basic: vertically arranged "things", or
- form: label/input combinations arranged in a table
- navbar: with ability to customize the buttons that get placed at the top
- tabbar: similar, but with the tabs at the bottom instead of nav at the top
- splitview: A splitview controller (for iPad Apps) with sane navigation defaults, nice loading webviews and JSON to populate the items in the popover menu
layouts should have ways of placing things relative to edges, so placing a label or nav at the "bottom" that spans the entire width should be easy. (This means we'll need to check for ipad or iphone.)
- actions are either blocks, defined inline, or target/action combos (e.g.
target: self, action: :my_method)
- there should be a consistent "styling" language, preferably in a separate file, something that could be handed to a designer. this is the BIG item!
- teacup should take a little
configblock for easy configuration
- Ideally, there should be some way to "inherit" styles in this language. So you can define a basic layout for all platforms and then tweak (see readme for style proposals)
Please, do not hesitate to report any bugs you find with our source at the Issues page.