Style.ag

继承关系

Style

简介

样式

API

keyboard(number offset)

对目标view位移，让其位于键盘上方。

keyboardDismiss(boolean auto)

收起键盘

watch(string var, function callback)

观察对象

ID(string id)

设置视图id

style(table style)

设置视图样式

subs(View subview)

添加子视图

subviews(View subview)

添加子视图

bind(function func)

绑定函数

alpha(number value)

设置视图透明度，范围 0 ~ 1

⚠️ 在iOS,当透明度小于0.1之后，将无法响应事件

borderWidth(number value)

设置视图的边框宽度

borderColor(Color color)

设置视图的边框颜色

borderColor(number red, number green, number blue, number alpha)

设置视图的边框颜色

borderColor(number hex, number alpha)

设置视图的边框颜色

bgColor(Color color)

设置视图的背景颜色

bgColor(number red, number green, number blue, number alpha)

设置视图的背景颜色

bgColor(number hex, number alpha)

设置视图的背景颜色

cornerRadius(number radius)

设置视图的圆角半径

cornerRadius(number radius, RectCorner corner)

设置圆角半径，根据不同的位置

⚠️ 不能与阴影连用

clipToChildren(boolean isClip)

设置子视图是否在view的边界内绘制

⚠️ clipToChildren只能对parent使用，parent会遍历子View，让所有子View都统一clip。注：parent自己不生效，需要调用parent的parent才行。

notClip(boolean noClip)

设置圆角后，是否切割，默认切割false；优化性能使用

⚠️ iOS空实现，仅Android可用，Android sdk1.5.0 默认切割子View。可以改用addCornerMask()绘制圆角遮罩

cornerRadius(number cornerRadius, Color maskColor, RectCorner corners)

以覆盖一张中间透明周边含有指定颜色圆角的图片的方式实现圆角效果

⚠️ 这是一种提高圆角切割性能的方案，对于子视图超出父视图显示的情况，不建议使用该方式。

gradientColor(Color startColor, Color endColor, boolean isVertical)

设置线性渐变色

gradientColor(Color startColor, Color endColor, GradientType type)

设置线性渐变色，支持正向反向

enabled(boolean usable)

设置当前视图是否可以响应用户的点击，触摸等交互事件

⚠️ 该属性关闭后，不仅会导致自身无法响应事件，而且子视图也无法响应事件。所以当业务中遇到某些控件无法响应，可以考虑是否是自身或父视图禁用了用户交互。

onClick(function callback)

设置点击事件回调

⚠️ iOS采用的是手势监听，所以要注意事件冲突，在冲突时可使用touchEnd方法

onLongPress(function callback)

设置长按回调

cancelFocus()

取消焦点

anchorPoint(number x, number y)

锚点，动画作用的位置，从0~1的比例，在视图中对应位置

rotation(number rotate, boolean notAdding)

旋转视图

scale(number x, number y, boolean add)

缩放视图

⚠️ 参数c是iOS平台隐藏参数，默认不要传

translation(number x, number y, boolean add)

位移视图

⚠️ 参数c是iOS隐藏属性，默认不要传

transformIdentity()

重置Transform

removeAllAnimation()

移除视图上的帧动画

snapshot(string filename)

视图截屏

⚠️ 请在界面绘制完毕后，再进行截图操作

addBlurEffect()

添加高斯模糊

⚠️ iOS有效，Android空实现

removeBlurEffect()

移除高斯模糊

⚠️ iOS有效，Android空实现

openRipple(boolean open)

设置点击时的效果

⚠️ Android上为波纹效果，iOS上是一种灰色高亮

canEndEditing(boolean open)

设置是否开启点击收起键盘功能

bgImage(string imageName)

给视图设置背景图片

⚠️ 背景图片只支持本地资源

shadow(Size shadowOffset, number shadowRadius, number opacity)

设置视图阴影

⚠️ 1.cornerRadius+Shadow 使用时: 2)Android 给子View使用Shadow，子View不能充满容器，否则阴影被Parent切割 2.setCornerRadiusWithDirection 禁止与Shadow连用; 3.阴影的View有Z轴高度，会遮挡没有Z轴高度的同层View

onDetachedView(function callback)

子视图从父视图移除时的回调

startAnimation(CanvasAnimation animation)

开始画布动画(CanvasAnimation)，不会影响布局

⚠️ 不可使用FrameAnimation和Animation

clearAnimation()

停止View里的画布动画

⚠️ 非画布动画不会停止

width(number size)

设置视图宽度

widthPercent(number sizePercent)

设置视图宽度百分比

maxWidth(number value)

设置最大宽度

minWidth(number value)

设置最小宽度

maxWidth(number value)

设置最大宽度

minWidth(number value)

设置最小宽度

height(number size)

设置视图高度

heightPercent(number sizePercent)

设置视图高度百分比

maxHeight(number value)

设置最大高度

minHeight(number value)

设置最小高度

maxHeight(number value)

设置最大高度

minHeight(number value)

设置最小高度

margin(number top, number right, number bottom, number left)

设置视图的外边距

top(number value)

设置视图的上外边距

left(number value)

设置视图的左外边距

bottom(number value)

设置视图的下外边距

right(number value)

设置视图的右外边距

padding(number top, number right, number bottom, number left)

设置视图的内边距

paddingTop(number value)

设置视图的上内边距

paddingLeft(number value)

设置视图的左内边距

paddingBottom(number value)

设置视图的下内边距

paddingRight(number value)

设置视图的右内边距

positionTop(number value)

设置视图的上边位置

positionLeft(number value)

设置视图的左边位置

positionBottom(number value)

设置视图的下边位置

positionRight(number value)

设置视图的右边位置

positionType(PositionType value)

设置位置的类型

crossSelf(CrossAxis align)

设置视图在交叉轴上对齐方式

crossSelf(CrossAxis align)

设置视图在交叉轴上对齐方式

basis(number value)

设置视图在主轴上的默认大小

grow(number value)

视图在主轴上剩余空间的填充值

shrink(number value)

父级没有剩余空间，则此元素的收缩因子

display(boolean value)

视图是否可见

text(string content)

设置文本内容

textAlign(TextAlign align)

设置文字对齐方式，参见TextAlign

fontSize(number size)

设置字体大小

textColor(Color color)

设置文字颜色

lines(number num)

设置展示的最大行数，默认只展示一行

⚠️ 0代表最大行数不限制。当lines传入0时，Label的BreakMode会强制改为Clipping切割模式

breakMode(BreakMode mode)

设置文字截断样式，参见BreakMode的枚举值

⚠️ 在多行情况下，当设置Start或Middle时，会强制改为Clipping切割模式

styleText(StyleString styleString)

设置富文本，详情参见StyleString

⚠️ iOS设置该属性会清空之前设置的属性

padding(number top, number right, number bottom, number left)

设置文字内容距边界距离

setTextFontStyle(FontStyle style)

设置字体样式

fontNameSize(string name, number size)

设置自定义字体

setWrapContent(boolean isWrap)

包裹内容，即大小按照文本内容自适应, setWrapContent(true)与width(MeasurementType.WRAP_CONTENT) && height(MeasurementType.WRAP_CONTENT)等效

⚠️ 当label同时设置setWrapContent方法及width(10):height(10)的情况下，展示效果取决于设置的先后顺序。如：当label设置了setWrapContent(true)之后设置width(10):height(10)，label宽度为10、高度为10；当设置width(10):height(10)固定宽高后设置WrapContent,即以setWrapContent设置为准