Latest 0.1.2
Homepage https://github.com/wequick/Less
License MIT
Platforms ios 7.0
Authors

Pbind

CI Status
Version
License
Platform

Pbind, a data binder with Plist.

Example

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

Installation

Pbind is available through CocoaPods. To install
it, simply add the following line to your Podfile:

pod "Pbind"

Plist Reference

Key Value Description
properties Dictionary keyed values for self
tagproperties Array keyed values for tagged subviews (array index map to subview’s tag, start at 1), recommended way to config subviews.
subproperties Array keyed values for subviews (array index map to subview’s index, start at 0)

Each property is composed of key and value. The key descripts owner’s key path, the value for the key can be any constants of plist or an Rainbow-Expression.

Plist Key (Left column of Plist)

usage: [tag][key]
  1. Tag

    Tag Parse to Desctiption e.g.
    @property for UIView’s defined key hidden
    + Addition key for UIView’s undefined key +mykey
    ! Control event for UIControl only !change (UIControlEventValueChanged)
    !click (UIControlEventTouchUpInside)

Plist Value (Right column of Plist)

  1. Constant (@see PBValueParser)

    Tag Parse to e.g.
    # UIColor #FF00FF
    ## CGColor ##FF00FF
    @ Subscript @[1,2,3]; @{title:1}
    : Enum :left = NSTextAlignmentLeft
    {{ Rect {{0,0},{1080,44}
    { Size|Point|EdgeInsets {1080,44} | {0,2,0,2}
    {F: Font {F:MicrosoftYaHei,bold,14}
    {F:itailc,14}
    {F:14}

    For matching the screen size, the pixel value of Rect, Size and Font will be automatically scale by your sketch width. The default sketch width is 1080, you can specify it by [Pbind setSketchWidth:].

    After you do this, you can directly use the pixel value marked in the sketch by your UI designer.

    1.1 Enum

    Name Map to
    :left NSTextAlignmentLeft
    :right NSTextAlignmentRight
    :center NSTextAlignmentCenter
    :√ UITableViewCellAccessoryCheckmark
    :i UITableViewCellAccessoryDetailButton
    :> UITableViewCellAccessoryDisclosureIndicator
    :value1 UITableViewCellStyleValue1
    :value2 UITableViewCellStyleValue2
    :subtitle UITableViewCellStyleSubtitle

    1.1.1 User-defined Enum

    /* e.g.
     *  - plist: :your_enum1
     *  - output: 1
     *  - plist: :your_enum2
     *  - output: 2
     */
    [PBValueParser registerEnums:@{@"{your_enum1}": @1,
                                   @"{your_enum2{": @2}];
  2. Variable (@see PBExpression)

    usage: [unary-operator][tag][accessory][variable][logic-operator][rvalue][:][rvalueOfNot]

    2.1 Tag (@see PBVariableMapper)

    Tag Map to e.g.
    $ root view data $records
    . target view .frame.size
    .$ target view data .$name
    @ active controller @title
    > PBForm input text >birth
    >@ PBForm input value >@birth

    2.1.1 User-defined Variable Tag

    User-defined tag accepts one-char only, as if you defined D, then you can use $D. in plist.

    /* e.g.
     *  - plist: $D.userInfo
     *  - mapto: [[NSUserDefaults standardDefaults] valueForKey:@"userInfo"]
     */
    [PBVariableMapper registerTag:'D' withMapper:^id(id data, id target) {
        return [NSUserDefaults standardDefaults];
    }];

    2.2 Operator

    Operator Description e.g.
    ! logic not !$success
    negative or minus -$height; $count-1
    < less than $count<2
    > greater than $count>7
    = or == equal to $count=3; $count==3
    != not equal to $count!=2
    <= less equal $count<=7
    >= greater equal $count>=3
    + plus $count+2
    * times $count*7
    / devide $count/3
    ?: test $value?:2; $flag?1:2

    2.3 Accessory flags

    Accessory Description e.g.
    _ one-way binding (data->view) $_selected
    __ duplex binding (data<->view) $__tabIndex
    ~ set value with animated ~$contentSize
  3. Formatter (@see PBMutableExpression)

    usage: %[tag:option]( format ),$arg1,$arg2,...

    3.1 Tag

    Tag Description e.g.
    string format %(goods:%@, money:%.2f),$title,$money
    JS javascript evaluator %JS(‘goods:’ + $1 + ‘, money:’ + $2),$title,$money
    AT attributed string Not available now

    3.1.1 User-defined Format Tag (@see PBVariableEvaluator)

    /* e.g. Format string to array
     *  - plist: %S2A(/),$str
     *  - input: str="a/b/c"
     *  - output: @[@"a",@"b",@"c"]
     */
    [PBVariableEvaluator registerTag:@"S2A" withFormatterer:^id(NSString *format, id value) {
        return [value componentsSeparatedByString:format];
    }];

    3.1.2 Javascript Evaluator (@see PBVariableEvaluator)

    Pbind use JavascriptCore to evaluate js.

    To use Javascript Evaluator, simply declare %JS( scripts ),vars in plist. Pbind will pass the variables as $1, $2$N to the scripts.

    Futher more, you can define the return value type by an option like %JS:type, the type here is default to string and can also be bool, int32, date, rect and etc. They are refer to [JSValue toXx].

    3.1.3 String Formatter (@see PBString, PBStringFormatter)

    Flag Description e.g.
    # Number format, accepts NSNumber arg %(%#.2f),$number
    J Json, accepts NSDictionary, NSArray arg %(%J),$dict
    <t> Date format, accepts NSDate, NSNumber arg %(%<t:yyyy-MM-dd>),$date
    <T> Date template, accepts NSDate, NSNumber arg %(%<T:MMMy>),$date
    <UE> URL Encoded, accepts NSString arg %(%<UE>),$param
    <UEJ> Encoded Json, accepts NSDictionary, NSArray arg %(%<UEJ>),$dict

    3.1.4 User-defined Format Flag (@see PBStringFormatter)

    /* e.g. Format array to string
     *  - plist: %(%<A2S:/>),$arr
     *  - input: [email protected][@"a",@"b",@"c"]
     *  - output: "a/b/c"
     */
    [PBStringFormatter registerTag:@"A2S" withFormatterer:^NSString *(NSString *format, id value) {
        return [value componentsJoinedByString:format];
    }];

License

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

Latest podspec

{
    "name": "Less",
    "version": "0.1.2",
    "summary": "A tiny MVVM framework that use Plist to build UIs and Databindings.",
    "description": "Less code, more efficient. Less is a tiny MVVM framework that use Plist to build UIs and Databindings.",
    "homepage": "https://github.com/wequick/Less",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "galenlin": "[email protected]"
    },
    "source": {
        "git": "https://github.com/wequick/Less.git",
        "tag": "0.1.2"
    },
    "social_media_url": "https://weibo.com/galenlin",
    "platforms": {
        "ios": "7.0"
    },
    "source_files": "Less/Classes/**/*"
}

Pin It on Pinterest

Share This