STMAssembleView使用教程

最新推荐文章于 2024-08-29 07:49:37 发布

祝晋遥

最新推荐文章于 2024-08-29 07:49:37 发布

阅读量309

点赞数 3

本文链接：https://blog.csdn.net/gitblog_00949/article/details/141546645

版权

STMAssembleView使用教程

STMAssembleView制作一个类似苹果VFL(Visual Format Language)的格式化语言来描述类似UIStackView那种布局思路，并解析生成页面项目地址:https://gitcode.com/gh_mirrors/st/STMAssembleView

项目介绍

STMAssembleView 是一个 iOS 开源库，旨在提供一种类似 Apple 的 Visual Format Language (VFL) 的简化语法，用于描述类似于 UIStackView 的布局逻辑，并自动解析这些描述生成实际的界面布局。通过这种创新的方式，开发者可以用更加直观且易于理解的字符串格式定义视图层次结构，大大提高了界面构建的灵活性和效率。项目遵循 MIT 许可证，并适用于 iOS 9.0 及以上版本。

项目快速启动

要快速开始使用 STMAssembleView，首先需要集成该项目到你的 Xcode 工程中。推荐使用 CocoaPods 来管理依赖：

# Podfile
pod 'STMAssembleView', '~> 1.2'

安装完毕后，在需要使用的 Swift 文件中导入库：

import STMAssembleView

接下来，你可以通过 STMAssembleView 提供的语法来创建布局。例如，下面的代码示例展示了如何构造一个简单的界面布局：

let assembleString = """
vc(padding:20) [
    %@(height:90),       // 垂直方向上的一个视图，高度为90
    %@(height:36, backColor:UIColor.gray.withAlphaComponent(0.5), radius:8, 
        backBorderWidth:1, backBorderColor: UIColor.white, backPaddingHorizontal:80, backPaddingVertical:10,
        button:clickButton),  // 自定义属性，可能代表一个按钮
    %@(height:25),
    %@(ignoreAlignment:top, isFill:1, height:16)
]
"""
let assembleView = STMAssembleView.assemble(with: assembleString, target: self)
view.addSubview(assembleView)

这里的 assembleString 定义了一个垂直排列（vc）的视图容器，包含了不同特性的子视图。

应用案例和最佳实践

案例一：动态布局调整

利用 STMAssembleView 的灵活特性，可以根据屏幕尺寸或数据变化动态地调整界面布局。例如，根据设备的宽度改变列数：

func adjustLayout(for screenWidth: CGFloat) {
    let columnCount = screenWidth < 375 ? 1 : 2 // 简单示例，确定列数
    let layoutDesc = "hc(l margin:10) [\n"
    for i in 0..<dataArray.count {
        if i % columnCount == 0 && i != 0 {
            layoutDesc.append("]")
            layoutDesc.append("\nhc(l margin:10) [\n")
        }
        let itemDesc = "%@(width:150, height:150, cornerRadius:10)"
        layoutDesc.append(itemDesc)
        if i != dataArray.count - 1 {
            layoutDesc.append(", ")
        }
    }
    layoutDesc.append("]")
    assembleView.assemble(with: layoutDesc)
}