Less code, more efficient!

Example

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

Installation

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

pod "Less"

Plist Reference

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 LSValueParser)

   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 [Prism 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
    */
   [LSValueParser registerEnums:@{@"{your_enum1}": @1,
                                  @"{your_enum2{": @2}];
   

2. Variable (@see LSExpression)

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

   2.1 Tag (@see LSVariableMapper)

   Tag	Map to	e.g.
   $	root view data	$records
   .	target view	.frame.size
   .$	target view data	.$name
   @	active controller	@title
   >	LSForm input text	>birth
   >@	LSForm 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"]
    */
   [LSVariableMapper 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 LSMutableExpression)

   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 LSVariableEvaluator)

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

   3.1.2 Javascript Evaluator (@see LSVariableEvaluator)

   Prism use JavascriptCore to evaluate js.

   To use Javascript Evaluator, simply declare %JS( scripts ),vars in plist. Prism 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 LSString, LSStringFormatter)

   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 LSStringFormatter)

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

Author

galenlin, [email protected]

License

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