Skip to main content

快速开始

本篇文档将带领大家快速借助宜搭自定义页面能力搭建一个简单 Demo 并发布上线,Demo 效果如下所示:

通过上面的效果我们可以看到,当用户在输入框中输入姓名并点击生成按钮,程序将自动生成问候语并打印在按钮下方,我们会尽可能详细的讲解每一个步骤,如果用户在这个过程中对于宜搭的产品功能有所疑惑,欢迎移步至 宜搭使用手册 进行查看,下面我们就从 0 开始来实现上面的 Demo 效果。

tip

用户可以通过访问 Hello 示例 查看真实效果,同时用户也可以访问 自定义组件设计器 查看具体实现。

步骤 1:创建宜搭应用

首先我们需要在宜搭工作台中创建一个应用 (详见 使用手册),如果您已有可用的应用则可以跳过本步,如下所示,我们创建一个名为 demo 示例 的空白应用:

步骤 2:创建自定义页面

接下来我们需要创建一个自定义页面来实现 Demo 的功能,如下所示,当前我们还不需要用到页面模板,因此在选择模板环节可以点击 跳过 按钮直接进入自定义页面设计器:

宜搭的自定义页面设计器如下所示,具体功能介绍详见 设计器文档,开发者可以在进入设计器后修改当前页面的名称:

步骤 3:拖入组件并配置属性

我们的 Demo 示例非常简单,总共包含三个组件,开发者可以从组件库面板中将组件先拖入画布,用户也可以前往 组件文档 查看更多组件配置能力:

  • 输入框- 用于输入姓名,我们将组件的 标题 属性设置为"姓名";
  • 按钮- 用于获取用户输入姓名并生成问候语,我们将按钮组件的 标题 属性设置为"生成";
  • 文本- 用于显示问候语,为了美观我们在样式面板中设置上边距:20px,字体大小:20px,如下所示;

步骤 4:创建全局变量

从这一步我们要开始实现逻辑部分了,首先,我们需要创建一个全局变量用于存储问候语(全局变量使用详见 全局变量文档),如下所示,我们创建一个名为helloWord的全局变量:

步骤 5:绑定按钮点击事件

我们需要当用户点击按钮时获取输入框的内容,并生成问候语打印在下方,接下来我们将讲解如何绑定事件并生成问候语:

1.给按钮绑定点击事件,如下所示,绑定后我们会在动作面板自动生成一个 JS 函数(用户也可以自定义函数名);

2.使用 getValue API 获取输入框的内容,宜搭提供了非常丰富的 宜搭JSAPI,如下所示,我们根据输入框组件的唯一标识获取用户输入内容:

3.构造问候语,并使用 setState API 更新全局变量的内容触发页面重新渲染,onClick 的全部代码如下所示:

export function onClick() {
// 获取姓名输入框内容
const name = this.$('textField_kzdxqcod').getValue();

// 更新全局变量
this.setState({
helloWord: `Hello ${name} !`,
});
}

步骤 6:文案绑定数据源变量

最后一步,我们需要将全局变量绑定到文本组件的 内容 属性上进行展示,如下所示:

步骤 7:预览&发布

到目前为止,我们的 Demo 示例就已经开发完成了,用户可以点击设计器右上角的 预览 按钮进行预览:

完成预览后点击 保存 按钮保存页面,接下来便可以通过点击应用右上角的访问按钮,访问我们搭建的 Demo 页面了:

最后

到此我们已经完成了快速开始 Demo 示例的制作,用户可以通过访问 Hello 示例 查看效果,通过本示例用户可以初步了解宜搭自定义页面的基本使用流程,如果想了解更加复杂的示例教程,可以移步到 TodoMVC 教程 进行查看。

This doc is generated using machine translation. Any discrepancies or differences created in the translation are not binding and have no legal effect for compliance or enforcement purposes.
Copyright © 2024钉钉(中国)信息技术有限公司和/或其关联公司浙ICP备18037475号-4