Foundation 中的新功能

Foundation 中的新功能

探索 Foundation 的最新更新如何帮助您改进 app 的本地化和国际化支持。了解专为 Swift 设计的新 AttributedString，并学习如何使用 Markdown 将样式应用于您的本地化字符串。探索语法协议引擎，它会自动修复本地化的字符串，从而使它们与语法性别和复数形式匹配。我们还将向您介绍迄今为止的改进和数字格式化，这些功能可简化复杂的要求，同时提高性能。

资源
- Foundation
- - 高清视频
  - 标清视频
相关视频

WWDC23
- 揭秘语法一致性的本质
WWDC22
- 深入了解 Swift 正则表达式
WWDC21
下载

你好我叫托尼我是Foundation团队的一名工程师欢迎来到《Foundation的新功能》 Foundation框架为所有app 和框架提供基本功能它有很多功能包括从文件处理到网络和通知的所有内容今天我想专注于所有app都需要的东西：国际化和本地化在今年发布的版本中我们在这个API中取得了一些有史以来最大的改进我们从低阶开始重新思考Swift中的 AttributedString是什么我们为Swift重新构建了格式化程序使它们更快更容易使用并增加了新功能最后我们有一个全新的功能叫做自动语法一致它大量地减少了需要提供的本地化字符串的数量同时使代码更简单让我们直接进入 AttributedStrings AttributedString是字符一组范围和字典的组合 AttributedStrings允许你将属性也就是键值对与字符串的特定范围产生关联最常见的属性由SDK定义但你也可以创建自己的属性你经常会在支持富文本的API中找到AttributedStrings 让我们看个例子这是我正在开发的一个app 叫做Caffé 菜单很简单我选择我想要的食物、大小和数量最后它会给我一张收据上面列出了我订购的所有东西在底部我决定增加一段简短的感谢词这是一个AttributedString 部分字符串为粗体部分为斜体最后一个字带有连结正如你在此处所看到的属性可以重叠从Foundation一开始我们就有了一个引用类型叫做NSAttributedString 今年我们引入了一个新的结构 AttributedString 它充分利用了 Swift为我们提供的所有功能首先它是一种值类型它还具有与Swift String 相同的字符计数行为作为我们致力于简化编写包容性软件的承诺的一部分 AttributedString 现在已完全可本地化最后它的构建考虑了安全和保障这既包括使用强类型的编译时的安全性也包括使用Codable 解压缩期间的安全性让我们简单介绍一下你可以使用新的AttributedString做什么
我们要建立我们的感谢信息首先我们使用一个简单的初始化程序创建AttributedString 我想在整个字符串上设置一个属性这就像设置字体属性一样简单在AttributedString结构中所有属性都可以直接使用并且它们使用正确的类型例如此属性是SwiftUI字体接下来我们创建另一个 AttributedString 这是对我们网站的引用因此我们将链接属性设置为URL 这里我在整个字符串上设置字体和链接稍后我们会研究如何更改字符串的一部分另一个有用的工具是 AttributeContainer 这是一个你可以在没有字符串的情况下单独保存属性和值的地方在这里我创建了一个容器并设置了一些属性取决于我的信息的重要性最后我将这些属性合并到两个AttributedStrings中如前面所述 AttributedString是字符、范围和字典的组合 AttributedString 本身不是这些事物的任何一个集合相反为了访问这些属性它具有我们所谓的视图两个最重要的视图是字符提供对字符串的访问和执行提供对属性的访问这些视图是Swift集合这代表你熟悉的数组类型的函数也可以在这里使用让我们再看一个例子假设我们的设计师叫我们在感谢信息中增加一点活力把所有标点符号都变成有趣的橘色要做到这一点首先我需要找到 AttributedString中标点符号的位置像其他Swift集合一样 AttributedString视图使用索引索引只是集合中某个元素的位置为了通过索引进行叠代我使用标准库索引函数接下来我使用函数 isPunctuation来检查这个字符是否是需要更改的字符最后我使用AttributedString的另一个功能切片将一个属性仅应用于整个字符串的一个子范围范围从这个索引开始一直持续到下一个索引即一个字符现在标点符号是橘色的让我们看另一个视图执行执行是特定属性的起始位置、长度和值我们可以从计算信息中的所有执行开始这将叠代字符串中每个连续范围的属性值在这个字符串中有四次执行每次执行的每个属性都有一个值或无字符和执行的范围可以互换因此你可以找到属性的字符串反之亦然在这里我在字符视图的下标中使用属性的范围将结果转换为独立字符串
通过关注特定属性来查看执行通常是最有用的在这里我们使用关键路径链接来合并链接属性结果集合的每个元素都会给我们链接属性的值而不考虑可能在字符串中设置的其他属性如果我们只看连结我们有三个执行：第一次它没有设置；第二次被设置为一个值；第三次句子中的最后一个句号这里不再设置叠代执行为我们提供了一个值和范围的元组由于这些值是类型安全的我们可以使用一个API 比如方案存在于URL上而不用强制转换或担心类型错误我在这里检查 AttributedString中的每个连结是否都是https 另一种有用的技术是查找子字符串并使用该范围来编辑字符或属性比方说我想将“访问”一词替换为更具有怀旧氛围的东西首先我查找子字符串的范围接下来我使用该范围仅在该子范围上设置属性和字符结果是一个有六次执行的 AttributedString 就像这样接下来我们来谈谈本地化 AttributedString 是完全可本地化的我们还在Objective-C中为NSAttributedString 增加了本地化支持 AttributedStrings位于 app的字符串文件中就像一个普通的常规字符串在Swift中我们现在支持使用字符串插值来本地化字符串和AttributedString格式就像SwiftUI的文本视图一样这里有个简单的例子这个函数返回一个本地化的字符串该字符串是用用户的文档名订制的不是使用像%@或%d 这样的格式说明符来调用格式函数你现在可以直接传入值相同的方法也适用于 AttributedString
Xcode可以使用编译程序从这些新的初始化器中生成字符串文件要打开它进入Build设置查找本地化设置然后打开使用编译程序提取Swift字符串你可能想知道本地化的AttributedString 是如何获取其属性的我很高兴地告诉你我们已经为 AttributedString 增加了对Markdown的支持这是在SwiftUI文本中使用本地化 AttributedString的例子我从一个普通的字符串开始通过在文本周围增加两个星号我强烈强调它 SwiftUI将其显示为粗体我可以使用下划线来强调文本 SwiftUI会显示为斜体我们也支持连结这是本地化人员为不同语言提供自定义URL的好机会我们还支持其他内联样式例如删除线和代码语音最后让我们谈谈归档 AttributedStrings 首先我们需要能够与 NSAttributedString 引用类型相互转换 AttributedStrings 可以是数据模型的一部分这代表我们要能够对它们进行编码和译码最后我们想要在Markdown中指定自定义属性的方法这些操作都是相互关联的让我们从转换开始
我们都写过很多使用 NSAttributedString的代码所以我们简化了从结构到类类型的转换这个视图有 NSAttributedString属性要进行转换只需将我们的结构 AttributedString 传递给 NSAttributedString初始化器对于SDK一部分的属性这就是我需要做的现在让我们看看编码和译码这是一个包含来自我们Caffé app收据的结构体同样我使用了 SwiftUI、UIKit、AppKit和 Foundation提供的属性这代表AttributedString的默认 Codable实现就是我所需要的我只是将Codable一致性增加到收据上就完成了让我们更进一步增加对自定义属性编码的支持我们将从属性本身开始讨论属性由两部分组成：键和值键是一种符合新的 AttributedStringKey 协议的类型这定义了它需要什么类型的值以及用于归档的名称此键还可以符合其他协议以自定义值的编码或译码方式假设我们想要定义一个 AttributedString的范围以具有一些额外的颜色这种彩虹效应分为三个层次：简单、有趣或极端我们将使用枚举来表示该值并将名称设置为彩虹定义类型和名称是该协议的唯一要求现在假设我们要将此属性设为Codable 以便它成为编码的 AttributedString的一部分我所要做的就是增加Codable一致性就像这样最后假设我们希望彩虹级别成为我们本地化字符串的一部分这代表它可以应用于字符串的右边无论在哪里在任何语言中我们只需要再选择一份符合协议的文件当我们说一个属性是Markdown可解码的那我们就可以直接从Markdown解码它并将它插入到AttributedString中所需要的只是该值是Codable 接下来我们来看看Markdown的自定义属性语法在第一个例子中我们引用了一个连结它使用方括号作为连结文本括号表示链接目标即URL 在第二个例子中我们有一个对图像的引用它以一个感叹号开头然后使用方括号表示图像描述并使用括号表示图像来源前两个例子在Markdown中很常见第三个例子展示了我们的自定义属性的语法它以插入符号开头然后使用方括号表示文本并使用括号表示其属性属性用JSON5表示 JSON5与JSON兼容允许使用不带引号的键注释和一些其他功能对于像这样的人性化字符串来说这是一个很好的匹配我们还在Foundation中为其他JSON API增加了JSON5支持因为自定义属性使用JSON 任何可以用 JSONDecoder解码的东西都会自动与新的自定义Markdown语法兼容这里我们有一个属性两个属性、一个字符串和一个数字以及一个具有多个属性的属性这里只有一个额外的部分就是我们如何把Markdown中的这些名称连接到Swift类型这部分称为属性范围作用域是一组属性键从JSON或Markdown解码时作用域很有用因为它们告诉我们希望找到哪些属性、它们的名称以及如何解码它们我们为Foundation UIKit、AppKit 和SwiftUI分别定义了一个作用域你也可以定义自己的属性作用域让我们为Caffé App 定义一个作用域我们将作用域嵌套在 AttributeScopes中并使其符合AttributeScope协议然后我们需要做的就是用“let”列出作用域内的属性到目前为止我们只有 RainbowAttribute 接下来我们将在我们的内部包含SwiftUI作用域除了我们自己的属性之外这还允许所有这些属性作用域递归嵌套因此这也包括Foundation属性为我们的新范围定义一个属性是很有用的这允许我们在函数中使用键路径语法该函数将作用域作为参数最后我们现在可以从自定义 Markdown 加载我们本地化的彩色 AttributedString 你还将发现用于归档和转换 NSAttributedString的作用域函数这允许在每个步骤中自定义行为这是Caffé app的第一个屏幕你可以在标题中看到我们自定义的彩虹属性在本地化字符串从Markdown转换为 AttributedString后 app会找到属性并将有趣的效果应用于该字符串范围
由于该属性来自我们的本地化字符串文件因此它适用于Caffé支持的所有语言例如西班牙语不过我们才刚刚开始我们还有一个全新的格式化程序API 格式化程序是另一个长期存在的 Foundation功能负责获取数据如数字、日期、时间等并将其转换为本地化的和用户可表示的字符串格式化程序由相当多的配置数据支持因此缓存和重用它们是一种常见的模式但是 app由许多不同的代码组成在所有格式化程序之间共享程序可能并不总是有意义的此外由于人们阅读日期和时间的方式有很多种加上我们作为app作者希望以符合我们设计的方式呈现这些数据因此存在很多边缘情况今年我们通过从头开始重新思考我们的格式化程序API 来提高性能和可用性简而言之我们的新API专注于格式让我们看一下来自地震这个示范app的这段代码在这里我们可以看到缓存模式的作用它有两个步骤首先创建并配置一个格式化程序接下来给格式化程序我们的日期并获得一个字符串怎样还能更简单？好让我们先删除创建我们自己的日期格式化程序的要求很容易忘记这需要缓存这将导致表中的每个单元格重新创建相同的格式化程序接下来是格式化步骤我们不需要将日期传送给格式化程序而是使用日期本身现在只有一行代码了你只需指定所需的格式即可让我们进一步讨论这个数字格式它的代码并不多但它隐藏了一些复杂性并且有一些需要注意的陷阱如果参数不是浮点数你会得到完全错误的输出读者必须了解格式化浮点数的特殊语法以及一组只是字符串常量的修饰符我们认为这段代码更容易理解维护和阅读它使用一般的Swift函数来准确指定我们希望的数字格式你还可以获得自动完成和类型安全我们已将这种新方法应用于 Foundation中的所有十个格式化程序我们清理并简化了界面进行了更改以帮助避免常见的陷阱并在此过程中增加了一系列新功能让我们详细了解两种最流行的格式化类型：日期和数字日期格式是关于使用日历和时区将绝对时间点转换为人们可以理解的日期更重要的是它考虑了人类对他们喜欢的日期格式的所有偏好我们将这些偏好称为语言环境让我们来看看格式化日期所需的少量代码首先我将使用Date.now 获取当前时间点接下来我调用格式化函数就是这样当然正如我们刚刚在示范中看到的日期格式有很多选项所以让我们把它展开一点
格式化函数可以配置为只显示日期或时间这两个观点都有几个选项可供选择这个新格式化API的一个重要目标是在创建正确格式时提供尽可能多的编译时间帮助使用魔法字符串值格式化是出了名的容易产生错误格式在正常情况下看起来是正确的但在边缘情况下会产生完全错误的值比如在年底这也是我们的默认格式这是询问日期和时间样式的简短版本就像这样对于无参数和简单样式版本我们都为你选择默认格式但是如果你想真正自定义日期只需从这里增加你关心的字段在此示范中我通过将字段附加到样式来构建格式我只想要年、日和月其他可能包括时、分秒等输出格式将根据用户的语言环境自动调整这些字段也是可配置的在本例中我将月份更改为宽格式这代表打印完整的月份名称使用此API 也可以轻松格式化日期的一部分这里我只想要工作日日期也可以格式化为不同的样式这里我选择使用ISO8601格式和ISO8601 但只用年、月、日并用破折号隔开通过这些示范格式化模式变得清晰我们从要格式化的值开始我们调用格式化函数参数是样式每种类型可能有不只一种样式例如日期既有日期时间又有ISO8601 该样式可用于默认配置或自定义配置此格式化API通过指定字段列表来运作其中一些字段有额外的选项你提供的字段顺序并不重要每个字段只是告诉格式化程序在最终输出中应该包含哪些值我们为API的最短版本选择了一个合理的默认值即那些没有参数或只有样式名称的版本一旦开始向其中增加字段输出就会变成自定义并只反映你选择显示的内容有点像UI中的占位符文本
还有一个新的API 用于格式化两个彼此相关的日期这里有些例子
首先在一个范围内格式化两个日期你可以只使用带有两个日期的一般Swift范围语法格式化范围允许配置显示日期和时间就像我们对单个日期所做的一样你可以将此范围格式化为持续时间或组件或相对于当前的单个日期格式化的另一个新功能是属性输出这使你可以找到格式化程序将格式化值的特定部分重新排列以适应用户偏好后放置的位置当然这使用了我们的新结构 AttributedString 将样式应用于格式化输出会出现在各种地方在watchOS上许多复杂的操作都是格式化字符串由于Apple Watch是一种个人设备因此考虑到用户的偏好很重要但它也是我们想要应用某种设计语言的地方例如为日期的一部分赋予用户选择的颜色在SwiftUI中设置这个是非常有趣的让我们在这个示范中一起看一下在这里我有我的Caffé 配套app的起点它会显示你的下一杯免费咖啡的时间我有一个SwiftUI视图它只显示一个格式化的日期
我在格式上设置了语言环境这样我就可以在这里用我的SwiftUI预览来控制它
这是一个很好的开始但我想对它做更多自定义让我们首先更具体地对我的app自定义我只关心分时和工作日好看起来还不错现在让我们增加一点颜色首先我们将返回类型更改为 AttributedString 并请求属性输出
接下来我们将使用属性容器这些可以保存属性而不附加到字符串中的任何特定字符我们将为工作日属性创建一个日期格式的输出它设置在包含工作日的字符串范围内
接下来我们将为要设置的颜色属性创建一个容器
最后我们将使用 AttributedString函数将与第一个容器中的属性匹配的属性替换为AttributedString中第二个容器中的值
因为AttributedString 是一种值类型而替换是一个变异函数所以我们需要将 “let”更改为“var”
看起来很棒更好的是它适用于所有语言环境让我们在预览中增加更多内容以进行仔细检查
你可以在这里看到无论工作日在这些语言环境的格式化日期中的哪个位置它都是橘色的让我们继续了解更多新的格式化程序API 现在我们已经了解如何将日期转换为字符串接下来我们讨论如何将字符串转换为日期日期现在有一个接受策略参数的初始化器该策略用于告诉解析器在输入中期望哪些字段对于日期格式也是一种策略这对于往返日期很有用例如在文本字段中既能显示输出又允许用户输入新日期的下面是一个往返的例子你会注意到解析可能抛出问题这是因为根据输入解析可能会失败某些策略具有更高级的解析选项在这里我们解析一个固定格式当从服务器接受到日期格式时这个格式很有用要使用它请使用格式字符串初始化策略不过我们不使用魔法字符串值而是使用字符串插值在本例中我们期望格式为年-月-日的字符串每个插值都由字段清楚地标识并且每个插值都准确地指定了预期的格式其中一个非常好的地方是自动完成体验如果我想使用不同的日期格式自动完成会向我显示有效选项以及有关每个选项含义的文件不更多的是猜测你应该使用多少个Y字符来解析一年让我们来看看数字数字格式化是关于将整数或浮点值转换为人类可以阅读的内容与所有格式一样它考虑了数字显示方式的偏好这包括从使用的数字类型到用于对数字进行分组的字符的所有内容与日期格式一样无需额外参数即可轻松获得出色的输出
有许多受支持的选项和输出我们在这里显示百分比科学记数法和货币最后让我们将几种格式放在一起列表格式化现在只是格式化一个数组此成员样式参数指定数组中每个元素的格式样式这些是数字所以我想使用百分比输出对于每个用户的语言环境都是正确的到目前为止我们一直专注于直接格式化值 SwiftUI还支持将格式样式附加到TextField 由于格式样式具有关于它们所格式化的值种类的类型信息我们可以使用可读但安全的语法来计算我收据上的小费百分比让我们再看看我们的Caffé app 看看有多少地方显示了格式我们对成分使用列表格式我们对价格使用货币格式我们对数量使用数字格式并在订单按钮中本地化计数我们不能忘记你在角落里看到的日期格式你会发现到处都是格式化输出我们认为这个新的API也会让你的app 变得简单甚至有趣还有很多资源可以帮助你处理本地化字符串和格式化程序我们还有两个关于这个主题的课程《本地化你的SwiftUI app》和《简化你的本地化字符串》接下来我们来讨论一个叫做自动语法一致性的新功能西班牙语等语言的本地化人员表达自然翻译的能力有限有时会导致尴尬的对话这些语言需要通过转换以实现不同词性之间的性别和复数一致性有时甚至需要了解用户的首选称呼英语也有这个特点名词的单复数形式不同我讲了很多语言术语让我们来看一个例子在我的Caffé app中我可以选择食物大小和数量我选择了一份小沙拉
现在我的朋友说她也钥所以我将计数增加到二在英语中 “沙拉”这个词必须改变以匹配数字二这就是所谓的一致性也就是说这句话中的单词必须相互匹配在英语中用复数形式固定单词是一种常见的约定现在让我们将我们的app 切换到西班牙语并订购一份ensalada pequeña 或一份小沙拉
当我为我的朋友点餐时这个点餐按钮需要和英语一样有复数形式但有一点变化在西班牙语中形容词pequeña 和名词ensalada都必须与计数dos一致因此该按钮不是 ensalada pequeña 而是ensaladas pequeñas 接下来我要点饮料对于这句话按钮不仅需要正确的复数形式还需要在这些词的语法性别一致果汁 jugo 是男性化的形容词pequeño也必须匹配为了像这样正确本地化文本我们最终会遇到组合爆炸每种食物、大小和数量的组合都需要不同的本地化字符串在代码中它通常最终看起来像这样我们需要切换每个项目然后切换每个大小依此类推还有一个stringsdict文件它可以将这些字符串中的每一个正确复数以进行计数现在通过利用键盘建议的相同技术我们创建了一个新的API 可以轻松处理所有这些情况和更多情况我们将此功能称为自动语法一致因为系统会自动修复本地化的字符串使其具有正确的语法现在代码变得简单多了你可以将数量、大小和食物组合在一个字符串中自动语法一致将使用称为屈折变化的过程为你修复字符串让我们分析一下为了进行屈折变化我们需要知道字符串的哪一部分需要被修正幸运的是我们在Swift中有一个类型可以做到这一点 AttributedString 和Markdown中的自定义属性在此字符串中我使用该语法的屈折变化属性来包装食物、大小和计数该属性的值为真当我们导出该项目的本地化时我们将获得一个字符串文件其中包含我们的注释字符串以及源代码中的其他本地化字符串例如食物的名称和大小这是拉丁美洲西班牙语的字符串本地化器使用了参数重新排序语法 %1、%3、%2 因为像“小”或“大” 这样的形容词放在西班牙语中的名词之前他们保留自定义属性语法来改变字符串的这个区域并提供食物和大小的翻译自动语法引擎负责修正其余部分某些语言不仅要本地化文本的单词之间的一致性而且在该文本与读者之间的一致性自动语法一致也可以帮助解决这个问题例如让我们看一下备忘录的欢迎屏幕在英语中我们说“欢迎使用备忘录” 在西班牙语中我们说“Te damos la bienvenid a aNotas” 或“我们欢迎你使用备忘录” 我们希望在西班牙语方面与在英语方面有相同的体验但是在西班牙语中 “bienvenido”一词必须与用户首选的称呼词相匹配这个数与可能是几种选择中的一种这个选择会改变文本使用正确的称呼会带来更加个性化和包容性的体验在今年的版本中我们让使用西班牙语的人可以指定他们的称呼在语言和地区设置中有一个新的称呼选项当你选择它时你可以选择你的偏好也可以选择与所有app共享在这里你可以在备忘录中看到新的欢迎屏幕用于表示女性化称呼这里是一个男性化的称呼如果我们不知道或用户不想指定我们保留原始字符串作为替代我们之前看到的相同的屈折变化属性也用于引用用户的本地化字符串中在我们的“欢迎来到”案例中我们将屈折变化属性应用于单词bienvenido 英文字符串不需要更改我还可以增加一个屈折变化替代选像这是引擎在没有关于用户首选项的信息时使用的替换字符串今年我们支持西班牙语和英语的自动一致性我们已在整个操作系统的多个地方采用例如备忘录中的欢迎屏幕你也可以在你的app中采用它所需的代码更改大多只是删除大量逻辑来选择不同的字符串关于如何屈折变化的指令是本地化字符串本身的一部分允许本地化人员更好地控制字符串在他们的语言中的显示方式让我们来看看我们的 Caffé app中的自动语法一致让我们来看看Caffé app的英语版本我先从点披萨开始我想要一个大的数量一请注意按钮上的文本是如何从零个大披萨变成一个大披萨的这是自动完成的如果我选择二它会再次修正我只要一个在此屏幕的底部订单按钮已更改为一个项目喝点东西如何？小杯就好只要一杯请注意按钮如何从“项目” 改为复数的“项目” 该字符串已自动更改让我们来看看
这是我们的收据它列出了我们的比萨和果汁以及格式化的价格底部是我们的AttributedString 带有自定义字体和网站链接让我们回到Xcode并查看源代码我将从食物细节视图开始
这是显示大小选择屏幕的视图让我们增加一个新的尺寸这样我们就可以看到如何只需要我们为西班牙语增加一个本地化字符串而不是为每种食物、每种大小和每种计数增加一个字符串这一行显示了列表列表来自我们的模型对象我们去那里看看
尺寸枚举已经有小和大我将为我们最饥饿的客户增加一个新尺寸称为“特大” 为此我将增加一个新案例以及一个本地化字符串
现在我只需要为特大的尺寸增加价格对于这个示范我只是将它们放在初始化程序中
让我们再看看我们的视图
预览中是我们的新尺寸我们的源代码已经包含了一个英文字符串我现在只需要一个西班牙语版本为了生成新字符串我将使用编译程序为“特大”找到新的本地化字符串为此我选择了产品导出本地化并保存了西班牙语字符串
现在让我们为西班牙语增加翻译
我可以过滤我们的新字符串并输入我们的西班牙语单词
接下来我导入这些本地化语言放入我的app中
现在我要再次执行我们的app 但用西班牙语版本为此我选择了产品方案编辑方案在选项中我可以选择我想要测试的语言
然后执行你可以从我们的标题中看出我们现在以西班牙语执行我们再点一次吧从沙拉开始请注意当我更改数量时订单按钮已修正我们新的特大尺寸是正确的复数两份沙拉另外它与“ensalada”的语法性别相匹配所有这些都只有一个字符串今年Foundation中有很多很棒的新功能它们已经准备好让你今天在你的app中试用 AttributedString提供了一个快速易于使用且Swift优先的界面用于将键值对增加到字符串的范围内你可以在文本中使用SwiftUI 并开始在本地化字符串中使用Markdown 我们新的格式化器API 将重点放在格式上简化你的代码并提高性能在app中呈现数据的所有地方使用格式最后自动语法一致会智能地修正本地化的字符串以便它们匹配语法性别、计数和用户自己的称谓我希望你会喜欢这些新功能我们期待在你的app找到它们谢谢你 [音乐]

func attributedStringBasics(important: Bool) {
    var thanks = AttributedString("Thank you!")
    thanks.font = .body.bold()

    var website = AttributedString("Please visit our website.")
    website.font = .body.italic()
    website.link = URL(string: "http://www.example.com")

    var container = AttributeContainer()
    if important {
        container.foregroundColor = .red
        container.underlineColor = .primary
    } else {
        container.foregroundColor = .primary
    }

    thanks.mergeAttributes(container)
    website.mergeAttributes(container)

    print(thanks)
    print(website)
}

4:24 - Attributed String Characters

func attributedStringCharacters() {
    var message = AttributedString(localized: "Thank you! _Please visit our [website](http://www.example.com)._")
    let characterView = message.characters
    for i in characterView.indices where characterView[i].isPunctuation {
        message[i..<characterView.index(after: i)].foregroundColor = .orange
    }

    print(message)
}

5:12 - Attributed String Runs (Part 1)

func attributedStringRuns() {
    let message = AttributedString(localized: "Thank you! _Please visit our [website](http://www.example.com)._")
    let runCount = message.runs.count
    // runCount is 4
    print(runCount)

    let firstRun = message.runs.first!
    let firstString = String(message.characters[firstRun.range])
    // firstString is "Thank you!"
    print(firstString)
}

5:49 - Attributed String Runs (Part 2)

func attributedStringRuns2() {
    let message = AttributedString(localized: "Thank you! _Please visit our [website](http://www.example.com)._")

    let linkRunCount = message.runs[\.link].count
    // linkRunCount is 3
    print(linkRunCount)

    var insecureLinks: [URL] = []
    for (value, range) in message.runs[\.link] {
        if let v = value, v.scheme != "https" {
            insecureLinks.append(v)
        }
    }
    // insecureLinks is [http://www.example.com]
    print(insecureLinks)
}

6:36 - Attributed String Mutation

func attributedStringMutation() {
    var message = AttributedString(localized: "Thank you! _Please visit our [website](http://www.example.com)._")

    if let range = message.range(of: "visit") {
        message[range].font = .body.italic().bold()
        message.characters.replaceSubrange(range, with: "surf")
    }

    print(message)
}

7:29 - Localized Strings

func prompt(for document: String) -> String {
    String(localized: "Would you like to save the document “\(document)”?")
}

func attributedPrompt(for document: String) -> AttributedString {
    AttributedString(localized: "Would you like to save the document “\(document)”?")
}

9:34 - Codable Attributed Strings

struct FoodItem: Codable {
    // Placeholder type to demonstrate concept
    var name: String
}

struct Receipt: Codable {
    var items: [FoodItem]
    var thankYouMessage: AttributedString
}

func codableBasics() {
    let message = AttributedString(localized: "Thank you! _Please visit our [website](http://www.example.com)._")
    let receipt = Receipt(items: [FoodItem(name: "Juice")], thankYouMessage: message)

    let encoded = try! JSONEncoder().encode(receipt)
    let decodedReceipt = try! JSONDecoder().decode(Receipt.self, from: encoded)

    print("\(decodedReceipt.thankYouMessage)")
}

10:42 - Markdown Decodable Attribute

enum RainbowAttribute : CodableAttributedStringKey, MarkdownDecodableAttributedStringKey {
    enum Value : String, Codable {
        case plain
        case fun
        case extreme
    }

    public static var name = "rainbow"
}

11:30 - Custom Markdown Syntax

This text contains [a link](http://www.example.com).

This text contains ![an image](http://www.example.com/my_image.gif).

This text contains ^[an attribute](rainbow: 'extreme').

12:27 - Custom Markdown Attributes

This text contains ^[an attribute](rainbow: 'extreme').

This text contains ^[two attributes](rainbow: 'extreme', otherValue: 42).

This text contains ^[an attribute with 2 properties](someStuff: {key: true, key2: false}).

13:15 - Attribute Scopes

extension AttributeScopes {
    struct CaffeAppAttributes : AttributeScope {
        let rainbow: RainbowAttribute

        let swiftUI: SwiftUIAttributes
    }

    var caffeApp: CaffeAppAttributes.Type { CaffeAppAttributes.self }
}

func customAttributesFromMarkdown() {
    let header = AttributedString(localized: "^[Fast & Delicious](rainbow: 'extreme') Food", including: \.caffeApp)

    print(header)
}

17:28 - Formatting Dates

func formattingDates() {
    // Note: This will use your current date & time plus current locale. Example output is for en_US locale.
    let date = Date.now

    let formatted = date.formatted()
    // example: "6/7/2021, 9:42 AM"
    print(formatted)

    let onlyDate = date.formatted(date: .numeric, time: .omitted)
    // example: "6/7/2021"
    print(onlyDate)

    let onlyTime = date.formatted(date: .omitted, time: .shortened)
    // example: "9:42 AM"
    print(onlyTime)
}

18:16 - Formatting Dates With Styles

func formattingDatesWithStyles() {
    // Note: This will use your current date & time plus current locale. Example output is for en_US locale.
    let date = Date.now

    let formatted = date.formatted(.dateTime)
    // example: "6/7/2021, 9:42 AM"
    print(formatted)
}

18:36 - Formatting Dates - More Examples

func formattingDatesMoreExamples() {
    // Note: This will use your current date & time plus current locale. Example output is for en_US locale.
    let date = Date.now

    let formatted = date.formatted(.dateTime.year().day().month())
    // example: "Jun 7, 2021"
    print(formatted)

    let formattedWide = date.formatted(.dateTime.year().day().month(.wide))
    // example: "June 7, 2021"
    print(formattedWide)

    let formattedWeekday = date.formatted(.dateTime.weekday(.wide))
    // example: "Monday"
    print(formattedWeekday)

    let logFormat = date.formatted(.iso8601)
    // example: "20210607T164200Z"
    print(logFormat)

    let fileNameFormat = date.formatted(.iso8601.year().month().day().dateSeparator(.dash))
    // example: "2021-06-07"
    print(fileNameFormat)
}

20:30 - Formatting Intervals

func formattingIntervals() {
    // Note: This will use your current date & time plus current locale. Example output is for en_US locale.
    let now = Date.now
    // Note on time calculations: This represents the absolute point in time 5000 seconds from now. For calculations that are in terms of hours, days, etc., please use Calendar API.
    let later = now + TimeInterval(5000)

    let range = (now..<later).formatted()
    // example: "6/7/21, 9:42 – 11:05 AM"
    print(range)

    let noDate = (now..<later).formatted(date: .omitted, time: .complete)
    // example: "9:42:00 AM PDT – 11:05:20 AM PDT"
    print(noDate)

    let timeDuration = (now..<later).formatted(.timeDuration)
    // example: "1:23:20"
    print(timeDuration)

    let components = (now..<later).formatted(.components(style: .wide))
    // example: "1 hour, 23 minutes, 20 seconds"
    print(components)

    let relative = later.formatted(.relative(presentation: .named, unitsStyle: .wide))
    // example: "in 1 hour"
    print(relative)
}

21:39 - Demo - SwiftUI and AttributedString

import SwiftUI

struct ContentView: View {
    @State var date = Date.now
    @Environment(\.locale) var locale

    var dateString : AttributedString {
        var str = date.formatted(.dateTime
                                    .minute()
                                    .hour()
                                    .weekday()
                                    .locale(locale)
                                    .attributed)

        let weekday = AttributeContainer
            .dateField(.weekday)

        let color = AttributeContainer
            .foregroundColor(.orange)

        str.replaceAttributes(weekday, with: color)

        return str
    }


    var body: some View {
        VStack {
            Text("Next free coffee")
            Text(dateString).font(.title2)
        }
        .multilineTextAlignment(.center)
    }
}

struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView()
            .environment(\.locale, Locale(identifier: "en_US"))
        ContentView()
            .environment(\.locale, Locale(identifier: "he_IL"))
        ContentView()
            .environment(\.locale, Locale(identifier: "es_ES"))
    }
}

23:53 - Parsing Dates

func parsingDates() {
    let date = Date.now

    let format = Date.FormatStyle().year().day().month()
    let formatted = date.formatted(format)
    // example: "Jun 7, 2021"
    print(formatted)

    if let date = try? Date(formatted, strategy: format) {
        // example: 2021-06-07 07:00:00 +0000
        print(date)
    }
}

24:23 - Parsing Dates - Strategies

func parsingDatesStrategies() {
    let strategy = Date.ParseStrategy(
        format: "\(year: .defaultDigits)-\(month: .twoDigits)-\(day: .twoDigits)",
        timeZone: TimeZone.current)

    if let date = try? Date("2021-06-07", strategy: strategy) {
        // date is 2021-06-07 07:00:00 +0000
        print(date)
    }
}

25:30 - Formatting Numbers

func formattingNumbers() {
    // Note: This will use your current locale. Example output is for en_US locale.
    let value = 12345

    let formatted = value.formatted()
    // formatted is "12,345"
    print(formatted)
}

25:36 - Formatting Numbers With Styles

func formattingNumbersWithStyles() {
    // Note: This will use your current locale. Example output is for en_US locale.
    let percent = 25
    let percentFormatted = percent.formatted(.percent)
    // percentFormatted is "25%"
    print(percentFormatted)

    let scientific = 42e9
    let scientificFormatted = scientific.formatted(.number.notation(.scientific))
    // scientificFormatted is "4.2E10"
    print(scientificFormatted)

    let price = 29
    let priceFormatted = price.formatted(.currency(code: "usd"))
    // priceFormatted is "$29.00"
    print(priceFormatted)
}

25:47 - Formatting Lists

func formattingLists() {
    // Note: This will use your current locale. Example output is for en_US locale.
    let list = [25, 50, 75].formatted(.list(memberStyle: .percent, type: .or))
    // list is "25%, 50%, or 75%"
    print(list)
}

26:05 - Receipt Tip View

struct ReceiptTipView: View {
    @State var tip = 0.15

    var body: some View {
        HStack {
            Text("Tip")
            Spacer()
            TextField("Amount",
                      value: $tip,
                      format: .percent)
        }
    }
}

29:41 - Automatic Grammar Agreement

func addToOrderEnglish() {
    // Note: This will use your current locale. Example output is for en_US locale.
    let quantity = 2
    let size = "large"
    let food = "salad"

    let message = AttributedString(localized: "Add ^[\(quantity) \(size) \(food)](inflect: true) to your order")
    print(message)
}

正在查找特定内容？在上方输入一个主题，就能直接跳转到相应的精彩内容。

提交你查询的内容时出现错误。请检查互联网连接，然后再试一次。

资源

相关视频

WWDC23

WWDC22

WWDC21