iOS 上的 CSS 样式协议 VKCssProtocol
CSS 产生的想法
早先,写过一阵子 RN,前一阵子写微信小程序,深深地觉得 CSS 这个东西写起来很爽,样式与界面完全隔离,写好一套一套的样式CSS Class
然后,在写界面 HTML 的时候直接对界面元素,无论是什么 HTML 标签,什么控件,只要指定CSS Class
的名字就能自动生效。
样式和界面完全隔离解耦
样式之间可以自由任意排列组合创建新 CSS Class
对任意界面元素指定样式 Class 名就能自动生效
客户端场景
UI 出 App 设计图也会有一套标准 UI 库
不同的底色,字号,字色,圆角,字体,阴影等等样式属性相互组合
UI 有时候更换整体设计风格的时候,所有项目中用到的标准组件,应该随着 UI 设计一起变为最新的设计效果
标准 UI 库扩展延伸一下,就是客户端主题风格,换肤等系统
工厂模式
看到上面的设计需求,相信很多人第一时间想到的都是客户端里构建一套工厂模式
由工厂模式统一生成 UI 设计的标准控件
所有需要使用标注控件的地方都用工厂去生成
当 UI 需要整体修改样式属性,修改工厂模式的构造方法就能实现整体应用新效果
我不是很喜欢这种模式
写法不统一,必须让使用者使用工厂的构造方法来创建标准 UI,非标准 UI 写法就随意了
耦合性比较强,必须引入工厂模块
Css 样式,Protocol 协议
希望引入 Css 的样式思想,让样式与界面分离
将 UI 给的统一标准设计图,专心的写成
.css
文件可以动态下发,可以动态替换,动态更新效果。
希望像 iOS Protocol 协议那样工作
不管控件是 Label Button Image View,CSSClass 都可以直接指定一个协议名字,样式功能就自动生效
不管控件是用工厂创建的,还是 Xib 拖线的,还是手写代码写的,都能无缝接入这个 cssprotocol
xxview.protocol = "cssclassname1 cssclassname2"
这种感觉协议可以同时指定多个样式,以空格区分,样式之间自由组合
我不想动态修改界面元素布局,动态创建全新的界面
大家都知道,CSS 有一个很大的用途就是用于界面布局,并且 css 的布局写法和 iOS 原生的布局写法有很大的区别,所以在这里我想强调一点,我这里写的 cssprotocol,不想包含任何跟布局有关,只是单纯的动态配置外观样式,丝毫不影响布局。
原因是,项目里总会存在着各种各样的布局方式,有 frame 布局,有 masonry autolayout,也有 XIB 拖线 autolayout,我希望我写的东西能让使用的人很快的在自己项目里接入,而不是一下删掉旧的布局方案,全都替换成我的。
我希望使用者直接在现有的代码里,无论是哪种方式实现的界面,取到 UIView,直接指定 cssprotocol,就自动样式生效了,不要让使用者需要大规模改动现有代码。
同理,我也没想让这一套能够动态的创建 UI,真要动态创建原生 UI,直接用 samurai reactnative weex 好了。
还原我的初衷,我还是希望原生开发者能在不改变自己的项目的情况下,很快的接入这个工具,对于主题样式能够控制的更灵活和方便。
题外话:
我就很不喜欢 ASDK 的设计,一整套异步渲染,flexbox 页面布局,网络,缓存,滚动控制等等一堆完整解决方案杂糅在一起,让使用者的代价异常的高,哪怕提供了 UIKit 转 ASNode 的简单入口也无法改变这一笨重无比的事实
其实 ASDK 每一个 feature,单看源码,单独拆出来模块,学习思想,吸收进入自己的项目都是很好地。
VKCssProtocol
整个项目的代码,以及使用 demo,都在上面
这其实是一个为 native 开发准备的工具,是 OC 的代码,OC 的实现,别被 CSS 的名字欺骗了╮(╯_╰)╭
对于这样的 iOS 客户端开发的场景,多少会有一定的帮助
UI 出 App 设计图有一套标准 UI 库,包括大中小标题,大中小按钮,bar 配色,分割线等
每种标准样式都含有不同的底色,字号,字色,圆角,字体,阴影等等样式属性,属性之间相互自有组合
UI 有时候更换整体设计风格的时候,所有项目中用到的标准组件,应该随着 UI 设计一起动态生效为最新的设计效果
客户端主题风格切换,换肤等系统
基本用法
简单的看一个 GIF 吧,左边就是 CSS 代码,后续我会给出目前已支持的 CSS 列表,在这里写完后,右侧可以实时看到 css 效果,可以看到我准备了 2 个 view 样式,准备了 2 个文字样式,然后四个 UI 进行排列组合,任意交叉组合,实现各种灵活的设计
先在项目里创建.css 文件
然后在里面写 Css 代码,这里我粘个样例
在 iOS 项目代码里加载 Css
在 didFinishLaunch or 某个你打算加载整体 Css 文件的位置
对任意 UI 指定协议
上面的 UI 创建可以用任意方法创建,frame,autolayout,xib,随便创建
只需要对指定的 UI 对象,赋值 cssClass 属性,就可以指定 css 协议,就直接生效了,
可以对一个 UI 对象,指定多个 cssClass 协议,他们一起组合生效,优先级按最后生效的算
加载 CSS 的 API
加载 css 主要依赖的是VKCssClassManager
这个类,但提供了 4 个宏,可以快速方便的加载 css
VKLoadBundleCss(@"cssDemo");
加载 bundle 内文件名为 cssDemo 的.css 文件
VKLoadPathCss(@"xxx/xxx.css");
加载路径 path 下的 css 文件
@loadBundleCss(@"cssDemo");
等同于 VKLoadBundleCss,模拟了 @语法糖
@loadPathCss(@"xxx/xxx.css");
等同于 VKLoadPathCss,模拟了 @语法糖
吐槽:
模拟 @selector()这种的 OC 语法糖的方案真 TM 坑爹
凡是这种 @loadBundleCss 的宏,是无法获得 xcode 提供的代码自动补全的
直接使用 VKLoadBundleCss,是可以获得 xcode 代码自动补全的
跟 RAC 的 @strongify @weakify 一样,无法获得代码自动补全
这真的是一种只有装 B,没球用的,看起来很 pro 的写法
指定 cssClass
上面贴过代码,我对所有的 UIView 都扩写了一个 category,里面新增了一个属性cssClass
,对这个属性赋值,就相当于给这个 UIView 对象指定所遵从的 cssClass 协议,可以同时指定多个 cssClass 协议,用空格分开。
一个 cssClass 其实是一系列样式属性 style 的集合,将这一系列样式属性组合在一起,起个名字就是 cssClass 了,样给一个 UI 指定了 cssClass 就相当于一组 style 都生效了。
指定 cssStyle
如果使用者并不打算专门写一个 cssClass,只是打算简单的使用这个工具给一个 ui 赋值一个或几个 style,这也是支持的(嗯,常规的 html 组件也是可以写 class 属性和 style 属性的嘛)
我扩写的 category 里,还新增了一个属性cssStyle
,对这个属性赋值,就相当于给这个 UIView 对象不创建一个 cssClass,直接写一个或多个 style 使之生效
相当于你把一个或多个 style 写法,用空格分开,直接赋值给 cssStyle 即可
目前支持的 style
background-color:orange;
View 的背景色样式,冒号后是颜色参数,可以直接输入颜色英文 or #ffffff 这样的十六进制色值color:#ffffff
如果含有文字,文字的颜色,冒号后是颜色参数,可以直接输入颜色英文 or #ffffff 这样的十六进制色值font-size: 20px ;
如果含有文字,文字的字体大小,冒号后面是字号参数border-color:red
View 的边框颜色,等同于 layer.borderColor,冒号后是颜色参数,可以直接输入颜色英文 or #ffffff 这样的十六进制色值border-width: 2px
View 的边框宽度,等同于 layer.borderWidth,冒号后是宽度参数text-align: center
如果含有文字,文字的左右居中对齐,等同于 TextAlignment,参数可以输入 left center right justifyborder-radius: 2px
View 的边框圆角,等同于 layer.cornerRadius,冒号后面是半径参数text: abcdefg
如果含有文字,文字的内容,后面参数是字符串font-family: fontname
如果含有文字,文字的字体,等同于 UIFont fontWithName 的 name,也可以直接输入 systemFont,boldSystemFont,italicSystemFont 三个快捷输入background-image: imagenamed
如果含有 image,image 的名字,等同于 UIImage 的 imageNamed 的 nametext-shadow: 2px
如果含有文字,文字的阴影宽度,后面是数字参数text-transform:uppercase
如果含有文字,文字的变化,包含 uppercase,lowercase,capitalize 三个值,全小写,全大写,首字母大写text-decoration:underline
如果含有文字,文字加特殊处理,包含 underline,line-through 两个值,下划线,删除线border-top: 3px solid #9AFF02
对 UIView 进行上右下左的单独边线处理,这个值是上边线,第一个参数是宽度,solid 后面是颜色border-right: 3px solid #9AFF02
对 UIView 进行上右下左的单独边线处理,这个值是右边线,第一个参数是宽度,solid 后面是颜色border-bottom: 3px solid #9AFF02
对 UIView 进行上右下左的单独边线处理,这个值是下边线,第一个参数是宽度,solid 后面是颜色border-left: 3px solid #9AFF02
对 UIView 进行上右下左的单独边线处理,这个值是左边线,第一个参数是宽度,solid 后面是颜色
支持灵活扩展
上面提到的每一个 style 都是一个模块化组件,如果希望扩展新的 style,只需要遵循并且实现模块化协议即可轻松地在整个框架里,加入全新的 style 模块
以background-color
这个 style 模块为例
随便新建一个继承自 NSObject 的类,让这个类遵从<VKCssStyleProtocol>
协议
然后在.m 文件实现里,先使用VK_REGISTE_ATTRIBUTE()
宏向框架注册,然后必须实现 2 个类方法协议
+styleName: 实现这个协议决定于你写 css 的时候冒号前的名字
+setTarget: styleValue: 实现这个协议决定于你如何解读 css 里面冒号后面的参数,并且处理传入的 target,也就是目标 UIView
动态更新样式
VKCssClassManager
这个类负责管理所有的 css 样式表,我们希望这个 css 文件就好像配置表一样,可以动态下发,这样在未来发版之后,也能改变 app 的主题样式,自然就需要一套刷新机制
上面是VKCssClassManager
的接口,由于 bundle 里的 css 文件是不可更新的,因此刷新机制与 readBundleCssFile 没啥关系,只有通过 readCssFilePath 路径加载的刷新机制才有意义
reloadCssFile 的用处就是沿着原路径重新加载 css,使用场景是新的 css 覆盖了旧 CSS 路径不变,在 reloadCssFile 的时候会自动触发 clearCssFile;
clearCssFile 的用处是让 cssClassManager 清空目前所管理的所有 class;
在不直接使用 reloadCssFile 的情况下,可以先执行 clearCssFile,再执行 readCssFilePath,从而实现清空 css 后加载新路径的 css 文件
HotReloader
大家在 Gif 里看到了像 playground 一样,无需编译和重新运行,每改一行代码,界面就立刻实时生效的效果,主要是额外写了一个插件HotReloader
由于 HotReloader 的设计初衷是给调试,高效的实时看效果用的,因此整个 HotReloader 通过编译控制,所有函数只有在模拟器编译的情况下才有效,真机下 HotReloader 回自动失效
这个 HotReloader 不是必须的,你完全可以不使用它,整个 CssProtocol 一样可以 work
想要使用它需要先 import 头文件#import "VKCssHotReloader.h"
,然后在准备加载 Css 的地方用预编译控制,控制模拟器下加载 css 的代码变为 hotReloader 监听 Css
这个绝对路径一定要填 Mac 的磁盘文件路径哟,用过 JSPatchPlaygroundTool 的一定不会陌生
做完这件事之后还要注意 2 个事情
在你打算开启调试的地方调用
[VKCssHotReloader startHotReloader];
(比如某个界面的 ViewDidLoad)在你打算停止调试的地方调用
[VKCssHotReloader endHotReloader];
(比如某个界面的 dealloc)
为什么要这么做,因为一旦当你 startHotReloader 的时候,所有进行过 cssClass,cssStyle 设置的 view 都会被建立一个监听,因此会造成 View 对象的额外持有导致的不释放,因此当你不打算 HotReload 了就要关闭这个监听 endHotReloader
因为这样的设计有可能造成使用不当的内存 Leak,所以对 HotReloader 的所有代码都进行了编译控制,只有模拟器下才会工作,真机 orRelease 包下,无论你怎么忘记写 endHotReloader 都不会造成 Leak
补充
整个结构大体如这样,采用模块化的设计之后,就是有需求完全按着自己的意愿任意扩充新支持的 style 属性了。
不过有一点要补充的是
由于最近比较忙,这玩意都拖了半个月才凑合写完,我目前已经支持的很多属性,其实实现并不是很优雅
比如
border-top
border-bottom
border-right
border-left
font-weight
四边独立边线凑合用比较 low 的方法做了,只是图快,以后这四个模块还得再好好雕琢一下
字体加重这个模块,用的 stroke 结果会把字体变镂空,反正没啥工夫好好细弄一下
评论