Supported Data Types & Form Factor Configuration

同学们，我们今天来讲两个在开发Lightning Web Components时非常实用的基础要点，一个是数据类型映射，另一个是外形配置。这些在流与你的组件交互时特别关键，我会结合例子一点点讲清楚。 首先，我们看数据类型映射表。它其实是定义了流和LWC之间完整兼容的类型集合。意思就是说，当你在流的逻辑里往你的组件传值，或者组件往回返值时，必须遵守这些类型规则，不然就会出错。 第一个要记住的是关于sObject对象。在映射里你不能只写一个泛泛的“Object”，必须注明具体的对象API名称，比如Account（就是客户）、Case（案例）。假如你传一个联系方式，就要点明是Contact对象。这样平台才知道怎么处理字段。 第二，布尔类型在映射里很灵活，可以接受多种“真”和“假”的格式。比如true或者false没问题，用字符串"true"、"false"也行，有些地方还能用1表示真，0表示假。但我们还是建议尽量用标准的true/false。 第三，遇到多选列表字段时，要把它转成逗号分隔的字符串来传递。比方说，你有个多选列表选了“选项A”和“选项B”，那么在映射里就应该写成"选项A,选项B"，中间用英文逗号分开，不要加空格。这样组件就能正确解析。 最后，日期时间类型，必须严格遵循ISO 8601格式。举个具体的例子：2024年1月1日中午12点整，要写成"2024-01-01T12:00:00.000Z"，带上时区标志。这一点千万注意，否则时间处理会乱掉。 现在讲完映射，我们来说外形配置。外形配置是用在targetConfigs里的supportedFormFactors标签，它可以控制你的组件在哪些设备尺寸上可见。简单理解，大屏体型对应桌面端，小屏体型对应手机端。你在声明支持的外形时，就是告诉Salesforce：“我这个组件要展示在桌面上，还是手机上，或者都显示。” 支持的页面类型有区别：应用程序页面和记录页面，这两种目标类型都支持大屏和小屏；但主页类型只支持大屏，小屏不会被显示出来。所以如果你想让组件在手机的主页上出现，那是不行的，主页只想让大屏看到。 这里有一个极其重要的规则，一定要记牢：一旦你的组件已经部署，并且在页面上被使用了，你就只能在supportedFormFactors里添加新的支持外形，而不能删除已有的。比如说，你原来声明了支持大屏和小屏，部署后，只能再添上新外形，但不能把小屏移除掉。因为如果删除，会导致那些已经配置了小屏显示的页面直接抛出错误，破坏用户体验。这是平台的一个保护机制。 因此，我们的最佳实践是：始终为每一个目标类型显式地定义supportedFormFactors，不要偷懒依赖默认值。显式写明你支持Large还是Small，这样既清晰，也避免未来更改时踩进无法删除的坑里。 好了，这两块内容就梳理到这里。希望大家在设计组件与流的交互，以及控制多设备展现时，能够把这些规则用上。下节课我们会看更多的实践案例，今天讲的要点大家多回顾一下。