Skip to main content

创建 Hello World Lightning Web 组件

注意

注意

用中文(简体)学习?在中文(简体)Trailhead Playground 中开始挑战,用括号中提供的译文完成挑战。仅复制并粘贴英文值,因为挑战验证基于英文数据。如果在中文(简体)组织中没有成功通过挑战,我们建议您 (1) 将区域设置切换为美国,(2) 按此处说明将语言切换为英文,(3) 再次单击“检查挑战”按钮。

查看 Trailhead 本地化语言徽章详细了解如何利用 Trailhead 译文。

跟随 Trail Together 进行学习

进行这一步骤时,想要跟专家一起学习吗?观看此视频,它是 Trailhead Live 上 Trail Together 系列的一部分。

(这部分内容从 11:49 开始,如果您想要倒回去再次观看步骤的开头部分可以从这里开始。)

创建 Salesforce DX 项目

现在您已经设置了开发环境,您可以创建一个简单的 Lightning Web 组件。

  1. 在 Visual Studio Code 中,按 Ctrl+Shift+P (Windows) 或 Cmd+Shift+P (macOS) 打开命令面板。
  2. 输入 SFDX
  3. 选择SFDX: Create Project(SFDX:创建项目)
  4. Enter 接受标准选项。
  5. 输入 HelloWorldLightningWebComponent 作为项目名。
  6. Enter 键。
  7. 选择一个文件夹来存储项目。
  8. 单击 Create Project(创建项目)。您应该看到类似这样的基本设置。
    带有新建 HelloWorldLightningWebComponent 文件夹的 Visual Studio Code
备注

如果您收到权限提示 Do you trust the authors of the files in this folder?(是否信任此文件夹中文件的作者?),选择 Yes(是)

授权您的 Trailhead Playground

  1. 在 Visual Studio Code 中,按 Ctrl+Shift+P (Windows) 或 Cmd+Shift+P (macOS) 打开命令面板。
  2. 输入 SFDX
  3. 选择 SFDX: Authorize an Org(SFDX:授权一个组织)
  4. Enter 接受项目默认登录 URL 选项。
  5. Enter 接受默认别名。
    这会在单独的浏览器窗口中打开 Salesforce 登录界面。
  6. 使用您的 Trailhead Playground 凭据登录。
  7. 如果系统提示是否允许访问,请单击 Allow(允许)
    允许访问对话
  8. 在浏览器中进行身份验证后,CLI 会记住您的凭据。成功消息应如下所示:
    授权一个组织的成功消息

创建 Lightning Web 组件

  1. 在 Visual Studio Code 中,按 Ctrl+Shift+P (Windows) 或 Cmd+Shift+P (macOS) 打开命令面板。
  2. 输入 SFDX
  3. 选择 SFDX:创建 Lightning Web 组件.
  4. 输入新组件的名称 helloWorld
  5. Enter 接受默认 force-app/main/default/lwc.
  6. Enter 键。
  7. 在 Visual Studio Code 中查看新创建的文件。
    Visual Studio Code 中的 Lightning Web 组件文件层次结构
  8. 在 HTML 文件 helloWorld.html 中,复制并粘贴以下代码。
    <template>
      <lightning-card title="HelloWorld" icon-name="custom:custom14">
        <div class="slds-m-around_medium">
          <p>Hello, {greeting}!</p>
          <lightning-input label="Name" value={greeting} onchange={changeHandler}></lightning-input>
        </div>
      </lightning-card>
    </template>
  9. 保存文件。
  10. 在 JavaScript 文件 helloWorld.js 中,复制并粘贴以下代码。
    import { LightningElement } from 'lwc';
    export default class HelloWorld extends LightningElement {
            greeting = 'World';
            changeHandler(event) {
            this.greeting = event.target.value;
            }
    }
  11. 保存文件。
  12. 在 XML 文件 helloWorld.js-meta.xml 中,复制并粘贴以下代码。
    <?xml version="1.0" encoding="UTF-8"?>
    <LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata" fqn="helloWorld">
        <apiVersion>58.0</apiVersion>
        <isExposed>true</isExposed>
        <targets>
        <target>lightning__AppPage</target>
        <target>lightning__RecordPage</target>
        <target>lightning__HomePage</target>
        </targets>
    </LightningComponentBundle>
  13. 保存文件。

部署到您的 Trailhead Playground

  1. 右键单击 force-app/main 下的 default(默认)文件夹。
    右键单击默认文件夹后,选项列表中已选择 SFDX: Deploy Source to Org(SFDX:将源部署到组织)。
  2. 单击 SFDX: Deploy Source to Org(SFDX:将源部署到组织)
  3. 在集成终端的 Output(输出)选项卡中,查看部署的结果。如果命令成功运行,则已部署源消息会列出上传到组织的三个文件。

在 Lightning Experience 中添加组件到应用程序

  1. 在 Visual Studio Code 中,按 Ctrl+Shift+P (Windows) 或 Cmd+Shift+P (macOS) 打开命令面板。
  2. 输入 SFDX
  3. 选择 SFDX: Open Default Org(SFDX:打开默认组织)
    这会在单独的浏览器中打开 Trailhead Playground。
  4. 单击 设置 然后选择 Setup(设置)
  5. 在 Quick Find(快速查找)中,输入 Home,然后在 Feature Setting(功能设置)部分选择 Home(主页)
  6. 对于 Advanced Seller Home(高级卖方主页),将设置切换为 Inactive(未启用)
  7. 从应用程序启动器 (),找到并选择 Sales(销售)
  8. 单击 设置 然后选择 Edit Page(编辑页面)
  9. helloWorld Lightning web 组件从 Lightning 组件列表的自定义区域拖动到页面画布的顶部。 
    Lightning 应用程序生成器,右栏带有 Lightning Web 组件 HelloWorld。
  10. 单击 Save(保存)
  11. 单击 Activate(激活)
  12. 单击 Assign as Org Default(分配为组织默认设置)
  13. 单击 Save(保存)
  14. 再次单击 Save(保存),然后单击 返回 返回页面。
  15. 刷新页面以查看新组件。

带有 HelloWorld Lightning Web 组件的主页。

您已经正式完成了首个 Lightning Web 组件!

接下来做什么?

查看 https://developer.salesforce.com/code-samples-and-sdks 上的代码示例和 SDK向 helloWorld 组件添加更多内容,查看其他示例组件并自行构建组件!实践过程中,请使用组件引用来了解有关如何对 Lightning Web 组件进行编码的更多信息。

在 Salesforce 帮助中分享 Trailhead 反馈

我们很想听听您使用 Trailhead 的经验——您现在可以随时从 Salesforce 帮助网站访问新的反馈表单。

了解更多 继续分享反馈