LGButtonLight 1.0.3

LGButtonLight 1.0.3

Jassim维护。



  • 作者:
  • Lorenzo Greco

logo

build platform license Version

这是一个完全可定制的 UIControl 子类,允许您创建美丽的按钮,无需编写任何代码。

预览

您将能够使用界面构建器创建这样的按钮

preview

此外,您还可以用于异步操作。

async

安装

要使用 CocoaPods 将 LGButton 集成到您的 Xcode 项目中,请在您的 Podfile 中指定它

use_frameworks!

pod 'LGButton'

图标和图像

您可以将图像/图标添加到按钮中,图标来自不同的现成字体图标集合,图像可以直接从您的项目资源文件夹导入。

您可以在按钮标题的左侧和/或右侧自定义图标/图像。

图标

图标由SwiftIconFont集成管理,因此您可以通过从最受欢迎的字体图标集合中选择来轻松添加和自定义按钮图标。特别是

集合 字体名称 速查表
Font Awesome fa 列表
Ion Icons io 列表
Octicons oc 列表
Open Iconic ic 列表
Material Icon ma 列表
Themify ti 列表
Map Icons mi 列表

为了使用字体图标,您需要设置以下主属性:

  • 图标字体名称:您可以从上表中选择一个值,不同的值将被忽略(请注意,并非所有的图标都可能可用,因为此库可能不会在字体库更新后立即更新)。

  • 图标字符串:从cheatsheet中获取的图标名称,不带集合前缀。

因此,如果您想使用来自Font Awesome的fa-align-left,则图标字体名称将为fa,而图标字符串将为align-left

图片

为了使用您的资源文件夹中的图片,请设置图片源属性。

注意:如果设置了图片源,则将忽略同侧关于字体图标的任何其他属性。

用法

将一个UIView对象拖放到您的视图控制器中,并设置其类和模块为LGButton

class

通过使用界面构建器设置属性来自定义您的按钮。

properties_1 properties_2

支持的属性

属性 描述 默认值
Bg Color 主要背景颜色 clear
显示触摸反馈 是否应显示触摸反馈 true
渐变起始颜色 渐变背景的第一种颜色 nil
渐变结束颜色 渐变背景的第二种颜色 nil
渐变结束颜色 渐变背景的第二种颜色 nil
Gradient Horizontal 渐变应水平还是垂直 false
Gradient Rotation 设置渐变旋转角度(从-360到360度) 0
Corner Radius 圆角半径 0.0
Fully Rounded Corners 应用等于高度/2的圆角半径 false
Border Color 边框颜色 white
Border Width 边框宽度 0.0
Title Color 标题颜色 white
Title String 标题字符串 EMPTY_STRING
Title Font Name 标题字体名称 nil
Title Font Size 标题字体大小 14.0
Vertical orientation 如果为true,则左图标将放置在顶部,右图标将放置在底部 false
Left Icon String 左图标名称(从cheatsheet中获取) EMPTY_STRING
Left Icon Font Name 左图标字体名称(从上表获取) EMPTY_STRING
左图标字体大小 左侧图标字体大小 14.0
左图标颜色 左侧图标颜色 white
左图片源 左侧资源资产名称 nil
左图片高度 左侧图片高度 20.0
左图片宽度 左侧图片宽度 20.0
左图片颜色 左侧图片色调颜色 nil
右图标字符串 右侧图标的名称(来自快捷表) EMPTY_STRING
右图标字体名称 右侧图标字体名称(来自上表) EMPTY_STRING
右图标字体大小 右侧图标字体大小 14.0
右图标颜色 右侧图标颜色 white
右图片源 右侧资源资产名称 nil
右图片高度 右侧图片高度 20.0
右图片宽度 右侧图片宽度 20.0
右图片颜色 右侧图片色调颜色 nil
标题图标间距 标题与图片/图标之间的间距 16.0
顶部间距 内部顶部间距 8.0
底部间距 内部底部间距 8.0
铅直间距 内部铅直间距 16.0
尾随间距 内部尾随间距 16.0
阴影偏移 阴影偏移量 (0,0)
阴影半径 阴影半径大小 0.0
阴影透明度 阴影透明度值 1.0
阴影颜色 阴影颜色值 黑色
加载旋转条颜色 加载旋转条的颜色 white
加载字符串 加载消息文本 EMPTY_STRING
加载字体名称 加载消息字体名称 EMPTY_STRING
加载字体大小 加载消息字体大小 14.0
左对齐 true 如果按钮项应对齐到左侧。这需要按钮具有固定宽度 false
右对齐 true 如果按钮项应对齐到右侧。这需要按钮具有固定宽度 false

如果您想查看更多,可以下载演示项目。

问题

请随意提交问题和功能请求。

贡献

我们非常欢迎贡献。您的贡献可能包括修复错误或/和新增功能。

请遵循“Fork-and-pull”Git工作流程(更多信息请参阅此处)。

  1. Fork 仓库在GitHub上
  2. Clone 项目到您的机器上
  3. Commit 变更为您自己的分支
  4. Push 您的工作回到您自己的Fork
  5. 提交一个 Pull request 以便我可以审查您的更改

注意:在提交pull request之前,请确保合并最新的“upstream”更新!

作者

Lorenzo Greco

致谢

使用SwiftIconFont项目来提供可用图标。

许可协议

MIT License

Copyright (c) 2017 Lorenzo Greco

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

LGButtonLight