UIKit-cross-platform 常用控件实战UILabel、Button、UIImageView 与 UIScrollView 教程【免费下载链接】UIKit-cross-platformCross-platform Swift implementation of UIKit, mostly for Android项目地址: https://gitcode.com/gh_mirrors/ui/UIKit-cross-platformUIKit-cross-platform 是一个用 Swift 编写的跨平台 UI 框架核心目标就是让同一套 UIKit 代码同时跑在 iOS 与 Android 上兼顾原生性能与只写一次的开发效率。这篇面向新手的 UIKit-cross-platform 控件实战教程将带你从零掌握UILabel、Button、UIImageView 与 UIScrollView四大最常用控件的创建、配置与组合技巧帮你快速迈出跨平台 Swift 开发的第一步。为什么先从这四个常用控件入手在任何一个 App 界面里这四类控件几乎无处不在文字靠 UILabel、点击靠 Button、图片靠 UIImageView、滚动列表则靠 UIScrollView。它们也是 UIKit-cross-platform 中实现度最高、API 与 iOS 最接近的一批控件学会它们就等于学会了这套框架 80% 的日常用法。控件核心职责对应源码UILabel展示单行或多行文本UILabel.swiftButton可点击、可配置多状态标题与颜色Button.swiftUIImageView渲染图片并控制缩放模式UIImageView.swiftUIScrollView可滚动内容区域与滚动指示器UIScrollView.swift快速创建一个 UILabel 文本标签UILabel 是最基础的文本控件用法与 iOS 完全一致创建实例 → 设置text、font、textColor、textAlignment→ 添加到视图层级即可。let label UILabel() label.text Hello, UIKit-cross-platform label.font .systemFont(ofSize: 30) label.textColor .darkGray label.sizeToFit() label.center view.center view.addSubview(label)几个新手容易忽略的细节sizeToFit()很关键不调用它label 的 frame 默认是.zero文字可能不显示。多行文本设置numberOfLines 0即可自动换行。富文本支持attributedText可实现一段文字里混排不同字体的复杂排版。所有属性变化都会自动触发setNeedsDisplay()重绘不需要手动刷新见 UILabel.swift。Button 按钮点击事件绑定方法Button 是本框架中一个很有特色的控件它刻意没有包装 UIButton而是基于UIControl 手势识别器实现API 更干净、也没有 Objective-C selector 的负担。最常用的是onPress闭包回调let button Button() button.setTitle(点击我, for: .normal) button.setTitleColor(.white, for: .normal) button.sizeToFit() button.center view.center button.onPress { print(按钮被点击了) } view.addSubview(button)按状态配置按钮的标题与颜色Button 支持与 iOS 一致的状态驱动配置setTitle、setTitleColor、setImage都可以针对.normal、.highlighted、.selected等不同状态单独设置框架会自动根据当前状态切换显示内容实现见 Button.swiftbutton.setTitle(普通状态, for: .normal) button.setTitle(按下状态, for: .highlighted) button.setTitleColor(.blue, for: .normal) button.setTitleColor(.red, for: .highlighted)提示想让按钮同时显示图标 文字用setImage(_:for:)即可布局时会自动按水平对齐方式排布。UIImageView 图片显示与缩放模式实战UIImageView 通过image属性加载图片并映射到layer.contents进行 GPU 渲染。创建方式非常直观let imageView UIImageView(image: UIImage(named: my_image)) imageView.frame CGRect(x: 20, y: 100, width: 200, height: 120) imageView.contentMode .scaleAspectFit view.addSubview(imageView)四种最常用的 contentMode 场景contentMode效果适用场景.scaleToFill拉伸填满需要铺满背景.scaleAspectFit等比缩放完整显示展示头像、商品图.scaleAspectFill等比缩放裁剪填满封面图、轮播图.center保持原尺寸居中小图标ImageView 内部通过layer.contentsGravity实现这些模式切换成本极低见 UIImageView.swift。注意设置图片后它的bounds会自动取图片原始尺寸需要显示尺寸时记得手动设置 frame。UIScrollView 滚动容器搭建与配置UIScrollView 是构建可滚动页面的基石支持手势拖动、惯性减速、滚动指示器并内置了越界回弹的边界检查。核心配置只有三个概念contentSize内容总尺寸、contentOffset当前偏移、contentInset内容边距。let scrollView UIScrollView(frame: view.bounds) scrollView.contentSize CGSize(width: view.frame.width, height: 1200) scrollView.contentInset UIEdgeInsets(top: 20, left: 0, bottom: 20, right: 0) view.addSubview(scrollView)监听滚动状态的最佳方法实现UIScrollViewDelegate即可感知滚动生命周期协议定义见 UIScrollView.swiftextension MyViewController: UIScrollViewDelegate { func scrollViewDidScroll(_ scrollView: UIScrollView) { // 实时获取滚动偏移 print(scrollView.contentOffset) } func scrollViewWillBeginDragging(_ scrollView: UIScrollView) { // 用户开始拖动 } }新手常见坑忘记设置contentSize时内容不会滚动滚动指示器可通过showsVerticalScrollIndicator/showsHorizontalScrollIndicator控制需要闪烁提示时调用flashScrollIndicators()。组合实战搭建一个可滚动的信息页把四个控件组合起来做一个带标题、图片、按钮和可滚动正文的页面——这也是官方 Demo 的思路可参考 samples/getting-started/DemoApp/ViewController.swiftlet scrollView UIScrollView(frame: view.bounds) scrollView.contentSize CGSize(width: view.frame.width, height: 900) view.addSubview(scrollView) // 标题 let title UILabel() title.text 今日推荐 title.font .systemFont(ofSize: 24, weight: .bold) title.sizeToFit() title.frame.origin CGPoint(x: 20, y: 30) scrollView.addSubview(title) // 封面图 let cover UIImageView(image: UIImage(named: cover)) cover.frame CGRect(x: 20, y: 90, width: view.frame.width - 40, height: 300) cover.contentMode .scaleAspectFill scrollView.addSubview(cover) // 按钮 let action Button() action.setTitle(立即查看, for: .normal) action.sizeToFit() action.frame.origin CGPoint(x: 20, y: 420) action.onPress { /* 跳转或弹窗 */ } scrollView.addSubview(action)要点回顾内容一定要加在 scrollView 上而不是 view 上按钮等交互控件放在滚动容器内同样能正常响应点击。常见问题速查表症状原因解决办法Label 文字不显示未设置 frame 或未调用 sizeToFit设置尺寸后再 addSubview按钮点击无响应忘记绑定 onPress检查是否设置了button.onPress { ... }图片变形contentMode 不对改用.scaleAspectFit或.scaleAspectFillScrollView 滚不动contentSize 等于或小于可视区域把 contentSize 高度设为内容实际总高度控件位置不在预期处父视图层级放错确认 addSubview 的接收者是目标容器总结与下一步学习建议通过本篇 UIKit-cross-platform 控件实战你已经掌握了 UILabel、Button、UIImageView、UIScrollView 的创建、配置与组合方法——这些能力足以支撑你搭建一个完整的单页面 App。框架的其余控件如 UINavigationController、UIAlertController 等大多遵循同样的与 iOS 对齐设计哲学学会举一反三即可快速迁移。想深入源码或动手实践可以克隆仓库到本地git clone https://gitcode.com/gh_mirrors/ui/UIKit-cross-platform接着打开 samples/getting-started 下的 DemoAppiOS / Mac / Android 三端工程齐全配合 UIKitTests 中的测试用例如 UIScrollViewTests.swift对照学习相信你很快就能写出一套代码、双端运行的跨平台 Swift 应用。【免费下载链接】UIKit-cross-platformCross-platform Swift implementation of UIKit, mostly for Android项目地址: https://gitcode.com/gh_mirrors/ui/UIKit-cross-platform创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 UIKit-cross-platform 常用控件实战：UILabel、Button、UIImageView 与 UIScrollView 教程
UIKit-cross-platform 常用控件实战UILabel、Button、UIImageView 与 UIScrollView 教程【免费下载链接】UIKit-cross-platformCross-platform Swift implementation of UIKit, mostly for Android项目地址: https://gitcode.com/gh_mirrors/ui/UIKit-cross-platformUIKit-cross-platform 是一个用 Swift 编写的跨平台 UI 框架核心目标就是让同一套 UIKit 代码同时跑在 iOS 与 Android 上兼顾原生性能与只写一次的开发效率。这篇面向新手的 UIKit-cross-platform 控件实战教程将带你从零掌握UILabel、Button、UIImageView 与 UIScrollView四大最常用控件的创建、配置与组合技巧帮你快速迈出跨平台 Swift 开发的第一步。为什么先从这四个常用控件入手在任何一个 App 界面里这四类控件几乎无处不在文字靠 UILabel、点击靠 Button、图片靠 UIImageView、滚动列表则靠 UIScrollView。它们也是 UIKit-cross-platform 中实现度最高、API 与 iOS 最接近的一批控件学会它们就等于学会了这套框架 80% 的日常用法。控件核心职责对应源码UILabel展示单行或多行文本UILabel.swiftButton可点击、可配置多状态标题与颜色Button.swiftUIImageView渲染图片并控制缩放模式UIImageView.swiftUIScrollView可滚动内容区域与滚动指示器UIScrollView.swift快速创建一个 UILabel 文本标签UILabel 是最基础的文本控件用法与 iOS 完全一致创建实例 → 设置text、font、textColor、textAlignment→ 添加到视图层级即可。let label UILabel() label.text Hello, UIKit-cross-platform label.font .systemFont(ofSize: 30) label.textColor .darkGray label.sizeToFit() label.center view.center view.addSubview(label)几个新手容易忽略的细节sizeToFit()很关键不调用它label 的 frame 默认是.zero文字可能不显示。多行文本设置numberOfLines 0即可自动换行。富文本支持attributedText可实现一段文字里混排不同字体的复杂排版。所有属性变化都会自动触发setNeedsDisplay()重绘不需要手动刷新见 UILabel.swift。Button 按钮点击事件绑定方法Button 是本框架中一个很有特色的控件它刻意没有包装 UIButton而是基于UIControl 手势识别器实现API 更干净、也没有 Objective-C selector 的负担。最常用的是onPress闭包回调let button Button() button.setTitle(点击我, for: .normal) button.setTitleColor(.white, for: .normal) button.sizeToFit() button.center view.center button.onPress { print(按钮被点击了) } view.addSubview(button)按状态配置按钮的标题与颜色Button 支持与 iOS 一致的状态驱动配置setTitle、setTitleColor、setImage都可以针对.normal、.highlighted、.selected等不同状态单独设置框架会自动根据当前状态切换显示内容实现见 Button.swiftbutton.setTitle(普通状态, for: .normal) button.setTitle(按下状态, for: .highlighted) button.setTitleColor(.blue, for: .normal) button.setTitleColor(.red, for: .highlighted)提示想让按钮同时显示图标 文字用setImage(_:for:)即可布局时会自动按水平对齐方式排布。UIImageView 图片显示与缩放模式实战UIImageView 通过image属性加载图片并映射到layer.contents进行 GPU 渲染。创建方式非常直观let imageView UIImageView(image: UIImage(named: my_image)) imageView.frame CGRect(x: 20, y: 100, width: 200, height: 120) imageView.contentMode .scaleAspectFit view.addSubview(imageView)四种最常用的 contentMode 场景contentMode效果适用场景.scaleToFill拉伸填满需要铺满背景.scaleAspectFit等比缩放完整显示展示头像、商品图.scaleAspectFill等比缩放裁剪填满封面图、轮播图.center保持原尺寸居中小图标ImageView 内部通过layer.contentsGravity实现这些模式切换成本极低见 UIImageView.swift。注意设置图片后它的bounds会自动取图片原始尺寸需要显示尺寸时记得手动设置 frame。UIScrollView 滚动容器搭建与配置UIScrollView 是构建可滚动页面的基石支持手势拖动、惯性减速、滚动指示器并内置了越界回弹的边界检查。核心配置只有三个概念contentSize内容总尺寸、contentOffset当前偏移、contentInset内容边距。let scrollView UIScrollView(frame: view.bounds) scrollView.contentSize CGSize(width: view.frame.width, height: 1200) scrollView.contentInset UIEdgeInsets(top: 20, left: 0, bottom: 20, right: 0) view.addSubview(scrollView)监听滚动状态的最佳方法实现UIScrollViewDelegate即可感知滚动生命周期协议定义见 UIScrollView.swiftextension MyViewController: UIScrollViewDelegate { func scrollViewDidScroll(_ scrollView: UIScrollView) { // 实时获取滚动偏移 print(scrollView.contentOffset) } func scrollViewWillBeginDragging(_ scrollView: UIScrollView) { // 用户开始拖动 } }新手常见坑忘记设置contentSize时内容不会滚动滚动指示器可通过showsVerticalScrollIndicator/showsHorizontalScrollIndicator控制需要闪烁提示时调用flashScrollIndicators()。组合实战搭建一个可滚动的信息页把四个控件组合起来做一个带标题、图片、按钮和可滚动正文的页面——这也是官方 Demo 的思路可参考 samples/getting-started/DemoApp/ViewController.swiftlet scrollView UIScrollView(frame: view.bounds) scrollView.contentSize CGSize(width: view.frame.width, height: 900) view.addSubview(scrollView) // 标题 let title UILabel() title.text 今日推荐 title.font .systemFont(ofSize: 24, weight: .bold) title.sizeToFit() title.frame.origin CGPoint(x: 20, y: 30) scrollView.addSubview(title) // 封面图 let cover UIImageView(image: UIImage(named: cover)) cover.frame CGRect(x: 20, y: 90, width: view.frame.width - 40, height: 300) cover.contentMode .scaleAspectFill scrollView.addSubview(cover) // 按钮 let action Button() action.setTitle(立即查看, for: .normal) action.sizeToFit() action.frame.origin CGPoint(x: 20, y: 420) action.onPress { /* 跳转或弹窗 */ } scrollView.addSubview(action)要点回顾内容一定要加在 scrollView 上而不是 view 上按钮等交互控件放在滚动容器内同样能正常响应点击。常见问题速查表症状原因解决办法Label 文字不显示未设置 frame 或未调用 sizeToFit设置尺寸后再 addSubview按钮点击无响应忘记绑定 onPress检查是否设置了button.onPress { ... }图片变形contentMode 不对改用.scaleAspectFit或.scaleAspectFillScrollView 滚不动contentSize 等于或小于可视区域把 contentSize 高度设为内容实际总高度控件位置不在预期处父视图层级放错确认 addSubview 的接收者是目标容器总结与下一步学习建议通过本篇 UIKit-cross-platform 控件实战你已经掌握了 UILabel、Button、UIImageView、UIScrollView 的创建、配置与组合方法——这些能力足以支撑你搭建一个完整的单页面 App。框架的其余控件如 UINavigationController、UIAlertController 等大多遵循同样的与 iOS 对齐设计哲学学会举一反三即可快速迁移。想深入源码或动手实践可以克隆仓库到本地git clone https://gitcode.com/gh_mirrors/ui/UIKit-cross-platform接着打开 samples/getting-started 下的 DemoAppiOS / Mac / Android 三端工程齐全配合 UIKitTests 中的测试用例如 UIScrollViewTests.swift对照学习相信你很快就能写出一套代码、双端运行的跨平台 Swift 应用。【免费下载链接】UIKit-cross-platformCross-platform Swift implementation of UIKit, mostly for Android项目地址: https://gitcode.com/gh_mirrors/ui/UIKit-cross-platform创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考