假设我想使用一个函数隐藏/显示一个 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/