Swift:参数标签命名约定?

标签 swift user-interface naming-conventions naming

假设我想使用一个函数隐藏/显示一个 UI 元素。正确的命名方式是什么?

func changeRefreshControlVisibilityTo(_ isVisible: Bool) {}

func changeRefreshControlVisibility(to isVisible: Bool) {}

人们对此有想法和/或引用吗?谢谢!

最佳答案

我个人不会选择这两个。 change 部分对我来说似乎是多余的,特别是考虑到这样一个事实,它可能不会真正改变任何东西 - 比方说,当前可见性是 false 你仍然可以设置false 作为该方法的参数。

所以如果你想坚持 change 这个词,也许是这样的:

func changeRefreshControlVisibility() {}

或者对我来说,更好的是:

func toggleRefreshControlVisibility() {}

就够了吗?

如果您想公开交流使用此方法后可见性的值(value),为什么不简单地:

func setRefreshControlVisible(_ isVisible: Bool) {}

无论如何,Swift 的 API 设计指南相当简短:

https://swift.org/documentation/api-design-guidelines/

所以我的总体印象是,你应该选择最适合你/你的团队的东西。

关于Swift:参数标签命名约定?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/44906267/

相关文章:

macos - 使用 Swift "why"做一些委托(delegate)函数需要覆盖 func

arrays - 快速比较 NSArray 和 NSString?

ios - Swift 对 Java 的 Runnable 的模拟

java - 如何从 Java 中的图形中读取坐标?

Perl 模块命名约定

python - Django:顶级项目文件夹 = root(好听的短名称),非顶级项目文件夹 = ? (需要好听的短名)

objective-c - 如何在 Swift 中引用类?

java - 在 Java GUI 中显示 com 端口数据

java - 有关如何使用 YUI 开发 Java Web 应用程序界面的信息

maven-2 - Maven 工件和 groupId 命名