课程章节介绍
同学们,咱们今天来聊聊Lightning Web Components里一个特别实用的小功能:自定义标签。你知道吗?多语言应用的基础,往往就是这些看似不起眼的小标签。它们其实就是存储在Salesforce里的文本值,可以被翻译成任何Salesforce支持的语言。这样一来,咱们的LWC组件就能自动根据用户的母语,显示出正确的内容,省去了手动判断语言、拼凑字符串的麻烦。
那在代码里怎么用呢?很简单,你只需要从 `@salesforce/label` 这个模块导入标签,格式是 `命名空间.标签名称`,注意中间有个点号。这个命名空间的格式跟托管包、Visualforce还有其他Salesforce技术里用的一模一样,保持了一致性,也方便咱们理解。
在组件的HTML模板里,你用这个标签就像使用普通的JavaScript属性一样,直接把它写在花括号里,它就能显示出对应的翻译文本。
那么这些标签文件本身是怎么组织的呢?在DX项目里,标签文件用的是一个特定的XML格式:文件名以 `.labels-meta.xml` 结尾,根元素是 `CustomLabels`,里面包含一个或多个 `labels` 元素,每个标签都有 `fullName`(全称)、`value`(默认值)、`language`(语言)、`protected`(是否受保护)和 `shortDescription`(简短描述)这些字段。你在写的时候,按照这个格式来就没问题。
最后一个贴心的地方:这些标签文件可以放在 `force-app/main/default` 目录下的任何位置,你可以根据自己的项目结构灵活地组织它们,不用拘泥于某个固定文件夹,非常自由。
好了,自定义标签就这么简单,大家理解了吗?自己动手创建几个标签,感受一下多语言支持的便捷吧。
关键词
LWC
Lightning Web Components
Salesforce