Home

Supported Bindings

Beacon provides bindings specific for the binding target, for example for the text of a label or text field. The most important categories of such specialized bindings are view bindings. Binding extensions for existing views are integrated as text properties defined in categories (named AKAIBBindingProperties). You use them typically by setting these properties in the properties inspector of Xcode's interface builder.

Beacon also provides some binding types which are specific to the bound value, such as formatter-, font- or predicate bindings. These bindings are typically property bindings. Property bindings are primarily used by view bindings to customize the binding configuration or the binding target.

View Bindings

• UIView
  • styleBinding - customize background color (later other properties)
  • gesturesBinding - create tap gesture recognizer
  • UILabel
    • textBinding - bind a source value to a label's text, configure formatters, etc.
    • fontBinding - dynamic type the easy way
  • UIImageView
    • imageBinding
  • UITableView
  • UIControl
    • enabledBinding
    • UITextField
      • textBinding
      • fontBinding
    • UITextView
      • textBinding
      • fontBinding
    • UIPickerView
      • valueBinding
    • UISwitch
      • stateBinding
    • UISlider
      • valueBinding
    • UIStepper
      • valueBinding
    • UISegmentedControl
      • valueBinding

Property Bindings

• FormatterBinding
  • NumberFormatterBinding
  • DateFormatterBinding
• ...

Binding expressions explained

Binding expressions consist of a primary expression which defines the binding source (where the data is coming from) and attributes which provide additional information which is either required by the binding or which customizes the behavior of the binding. Both are optional, if neither is specified (empty binding expression) no binding will be created.

<bindingExpression> ::= <primaryExpression>? ( '{' <attributeList>? '}' )?

<attributeList> ::= <attribute> | <attributeList> ',' <attribute>

<attribute> ::= <identifier> | <identifier> ':' <bindingExpression>

As you can see, attribute values are also binding expressions, so they can have their own attributes.

For some primary types (enumerations, options and structures) the constant values are specified as parameters in the attribute part of the expression. For these types, attribute values can be specified in addition to parameters, for example: $CGPoint { x:0, y:0, someAttribute:"value" }, where x and y are parameters for the CGPoint and "someAttribute" is an attribute.

Primary expression types

There are two categories of primary expressions, constant expressions and key path expressions. Key path expressions need a binding context to provide their value (arrays may be constant or not, depending on their content).

Key path expressions use a slightly extended syntax, you can prefix them with "$data." or "$root.". $data is the current data context, "$root" is the top-level (form-) data context. See the section about "Data contexts". These are called scopes. If no scope is specified, $data is assumed (unless otherwise specified).

Beacon currently supports the following types

Beacon type	Examples	Objective-C type
KeyPath	name, model.value, $data.name, $root.top	id (any type)
Boolean	$true, $false	NSNumber (BOOL)
Integer	123, -4	NSNumber (long long)
Double	.0, 1., .3e-5	NSNumber (double)
String	"a\nb\tc"	NSString
Class	<NSNumberFormatter>	Class
Enum	$enum.Value, $enum.Type.Value	id (any type)
Options	$options{Value1,V2,V3} $options.Type{Value}	NSNumber (long long)
Array	[ v1{ A1:4 }, v2, $true, "Hey!" ]	NSArray
CGPoint	$CGPoint { x:1, y:2 }	NSValue (CGPoint)
CGSize	$CGSize { w:10, h:20 }, $CGSize{width:1,h2}	NSValue (CGSize)
CGRect	$CGRect { x:1, y:2, w:3, h:4 }	NSValue (CGRect)
CGColor	$CGColor { r:255, g:255, b:255, a:255 }	CGColor
UIColor	$UIColor { r:255, g:255, b:255, a:255 }	UIColor
UIFont	$UIFont { name:"Courier new", size:15.0 }	UIFont

Binding Contexts, Data Contexts

...