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

Question

在尝试回答 this question 时，我发现了一个奇怪的行为。

Text(LocalizedStringKey("Hello \(Image(systemName: "globe"))"))

显示一个地球，但是

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

显示“Hello”，然后是一堆困惑的 SwiftUI 内部术语。

一个更简单的例子是:

let x = "\(Image(systemName: "globe"))"
print(LocalizedStringKey.init(x))
print(LocalizedStringKey.init("\(Image(systemName: "globe"))"))

我传递给 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 的两次调用正在调用相同的初始化程序。只有one parameter-label-less initialiser在 LocalizedStringKey ，它需要一个 String .

如果还有一个初始化器接受 LocalizedStringKey ，结果会更容易理解。 LocalizedStringKey has custom string interpolation rules , 和 one specifically for Image ， 毕竟。但据我所知，这是唯一没有参数标签的初始化器。

如果初始化器的参数是@autoclosure () -> String也能理解一些.如果我传入的表达式被延迟计算，该方法可能能够通过某种我不知道的方式“窥视”闭包。但该参数不是自动关闭。

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

这里到底发生了什么？我是否在某处遗漏了隐藏的初始化程序？

Answer 1

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

如果您将

LocalizedStringKey 纯粹视为一种便利，以便在使用字符串文字时允许 SwiftUI 界面元素“免费”本地化，那么它会变得更容易理解。您只有一次可以直接使用它。

考虑文本。有两个相关的初始化程序:

init(_ key: LocalizedStringKey, tableName: String? = nil, bundle: Bundle? = nil, comment: StaticString? = nil)

这将尝试本地化传入的文本，并且

init<S>(_ content: S) where S : StringProtocol

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

如果调用 Text("Hello")，使用哪个初始化器？

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

为了获得“免费”本地化，StringProtocol 初始值设定项用 @_disfavoredOverload 标记，它告诉编译器假定字符串文字是 LocalizableStringKey 而不是 String。

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

let string = "Hello"
Text(string)

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

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

Text("Hello \(Image(systemName: "globe"))")

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

Text("Hello {world}".replacingOccurrences(of: "{world}", with: "\(Image(systemName: "globe"))"))

这里，replacingOccurrences(of: 首先被评估，这意味着你的参数是一个 String，它不被视为通过字符串插值表达的 LocalizedStringKey。你'本质上是看到图像的描述。

类似的事情发生在带有 + 的例子中。这隐含地生成了一个 String，因此您失去了 LocalizedStringKey 为您提供的特殊图像插值。

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

let x = "\(Image(systemName: "globe"))"
print(LocalizedStringKey.init(x))
print(LocalizedStringKey.init("\(Image(systemName: "globe"))"))

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

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

第二个初始化器使用 ExpressibleByStringInterpolation 并使用 LocalizedStringKey.StringInterpolation 将图像插入其内部存储，然后可以通过 Text 呈现>.