为什么 LocalizedStringKey 的行为取决于我是否将字符串插值传递给其初始化程序?

Swe*_*per 5 string-interpolation swift swiftui localizedstringkey

在尝试回答这个问题时,我发现了一个奇怪的行为。

Text(LocalizedStringKey("Hello \(Image(systemName: "globe"))"))
Run Code Online (Sandbox Code Playgroud)

显示一个地球仪,但是

Text(LocalizedStringKey("Hello {world}".replacingOccurrences(of: "{world}", with: "\(Image(systemName: "globe"))")))
Text(LocalizedStringKey("Hello" + "\(Image(systemName: "globe"))"))
Run Code Online (Sandbox Code Playgroud)

显示“Hello”,然后是一堆 SwiftUI 内部术语。

一个更简单的例子是:

let x = "\(Image(systemName: "globe"))"
print(LocalizedStringKey.init(x))
print(LocalizedStringKey.init("\(Image(systemName: "globe"))"))
Run Code Online (Sandbox Code Playgroud)

我传递给的值LocalizedStringKey.init应该是相同的"\(Image(systemName: "globe"))",但是第一个打印

LocalizedStringKey(key: "%@", hasFormatting: true, arguments: [...])

和第二张照片

LocalizedStringKey(key: "Image(provider: SwiftUI.ImageProviderBox<SwiftUI.Image.(unknown context at $7ff91ccb3380).NamedImageProvider>)", hasFormatting: false, arguments: [])

似乎LocalizedStringKey.init改变其行为取决于我传递的参数是否是(内插的)字符串文字。

据我所知,这两个调用正在LocalizedStringKey.init调用相同的初始化程序。中只有一个无参数标签初始化程序LocalizedStringKey,它采用String.

如果还有一个接受 a 的初始化程序LocalizedStringKey,结果会更容易理解。毕竟LocalizedStringKey 有自定义的字符串插值规则,而且是专门针对的。Image但据我所知,这是唯一没有参数标签的初始化程序。

如果初始化器的参数是 ,这也可以理解@autoclosure () -> String。如果我传入的表达式被延迟求值,则该方法可能能够通过某种我未知的方式“窥视”闭包内部。但该参数不是自动关闭。

这里似乎发生的是,编译器正在创建一个LocalizedStringKeykey您传入的插值相同的模式,即使参数是 String!

这里到底发生了什么?我是否在某处错过了隐藏的初始化程序?

jrt*_*ton 10

TL;DR:您所看到的行为来自ExpressibleByStringInterpolation. 但请继续阅读以获得更多乐趣!

LocalizedStringKey如果您纯粹将其视为一种方便,允许 SwiftUI 界面元素在使用字符串文字时“免费”本地化,那么就更容易理解了。只有一个实时您可以直接使用它。

考虑Text。有两个相关的初始化器:

init(_ key: LocalizedStringKey, tableName: String? = nil, bundle: Bundle? = nil, comment: StaticString? = nil)
Run Code Online (Sandbox Code Playgroud)

它将尝试本地化传入的文本,并且

init<S>(_ content: S) where S : StringProtocol
Run Code Online (Sandbox Code Playgroud)

这将显示字符串而不改变它。

如果您调用Text("Hello"),则使用哪个初始值设定项?

字符串文字符合StringProtocol,但LocalizedStringKey也是ExpressibleByStringLiteral。编译器不知道选择哪一个。

为了获得“自由”本地化,StringProtocol初始化程序被标记为@_disfavoredOverload,这告诉编译器假设字符串文字是 aLocalizableStringKey而不是 a String

因此,Text("Hello")Text(LocalizedStringKey("Hello"))是等价的。

let string = "Hello"
Text(string)
Run Code Online (Sandbox Code Playgroud)

在这种情况下,不存在冲突 - 编译器使用StringProtocol初始值设定项并且字符串未本地化。

这和你的问题有什么关系?LocalizedStringKey也是 ExpressibleByStringInterpolation这就是您的“隐藏初始化程序”的来源。但与上面的示例一样,只有当您使用单个内插字符串对其进行初始化时,这才会发挥作用。

Text("Hello \(Image(systemName: "globe"))")
Run Code Online (Sandbox Code Playgroud)

您正在传递一个插值字符串,因此编译器可以处理它并将图像添加到插值中。

Text("Hello {world}".replacingOccurrences(of: "{world}", with: "\(Image(systemName: "globe"))"))
Run Code Online (Sandbox Code Playgroud)

在这里,replacingOccurrences(of:首先评估,这意味着您的参数是 a String,它不被视为通过字符串插值表示的 LocalizedStringKey 。您实质上看到的是图像的描述。

其中的示例也发生了类似的情况+。这隐式地生成了String,因此您失去了为您提供的特殊图像插值LocalizedStringKey

对于您的最后一个代码示例:

let x = "\(Image(systemName: "globe"))"
print(LocalizedStringKey.init(x))
print(LocalizedStringKey.init("\(Image(systemName: "globe"))"))
Run Code Online (Sandbox Code Playgroud)

x是包含图像描述的字符串。请记住,只有LocalizedStringKey拥有真正理解和表达的魔力Image。任何其他字符串插值都将回退到插值对象的描述。

LocalizedStringKey第一个初始化程序传递一个字符串(它被视为键,如果您在运行时生成键并希望使用它们进行查找,那么这是您真正直接使用的唯一一次)。

第二个初始化程序正在使用ExpressibleByStringInterpolation并将LocalizedStringKey.StringInterpolation图像插入到其内部存储中,然后可以通过 进行渲染Text