其他分享
首页 > 其他分享> > 自定义组件(Pluggable Widget)开发入门篇

自定义组件(Pluggable Widget)开发入门篇

作者:互联网

摘要

本篇介绍如何构建一个Pluggable Widget,手把手教你从零开始做自己的Pluggable Widget。通过本篇,您将学习构建Pluggable Widget 的环境搭建,学习制作一个动态数据绑定并能进行数据回传的Text input 组件。
官方教学中文版,附送教学源码
链接:https://pan.baidu.com/s/1mz0Z293Cvsy4W9ZBJxfqiw
提取码:SIMX

Pluggable Widget

1. 环境安装:以window操作系统为例

Node.js安装:

自定义组件的相关依赖通过node.js来管理。
首先在打开URL:Node.js 中文网 (nodejs.cn)
1.png
具体安装教程请参考:https://blog.csdn.net/qq_38162116/article/details/118576023

Yeoman 安装

简介:
Yeoman 是一个通用的脚手架系统,允许创建任何的 app 。它可以迅速搭建一个新项目,并且简化现有项目的维护。
Yeoman 构建的项目与语言无关。 它可以构建任何语言的项目 (Web, Java, Python, C#, 等)。
Yeoman 本身不能做任何操作。 每个操作都是由 generators 基本插件在 Yeoman 环境中完成的。 这里有很多公共的 generators, 您可以很轻松地创建一个 generator 去匹配任何工作流。 Yeoman 总是可以为您需要的脚手架工具作出正确的选择。

打开控制台 powershell
安装Yeoman指令:
npm install -g yo

Mendix Pluggable Widget安装

Mendix Pluggable Widget是构建自定义组件的重要生成工具,帮我们导入相关依赖,安装Mendix Pluggable Widget Generator 指令:
npm install -g @mendix/generator-widget
下载一个IDE编辑软件——此处推荐Microsoft Visual Studio Code:https://code.visualstudio.com/
当安装好环境后,您可以向自己确认以下几个问题的答案:

2. 在开始制作自定义组件前,需要完成的工作

1.在Mendix Studio Pro中 创建一个空的Mendix 项目,这个项目的目的是测试自定义组件。2.png
2. 在如图所示点击Show App Directory in Explorer,找到 Project文件夹
3.png
3. 在下图目录中建立一个文件夹来存放创建Pluggable Widget,如 plug_Widget_WorkArea(此处可自定义名称)
4.png
4. 创建自定义组件项目
通过指令进入我们刚刚创建的文件夹,输入指令:
yo @mendix/widget TextBox
5.png
上图出现后,生成器会问您几个问题,问题的答案参考下面:

3. 开发组件

3.1自定义组件功能:

动态展示在text box 输入的string。在自定义组件中输入删除,也会同时影响textbox 的string。
功能的简单预览实现可参考文章 ,以mendix的方式实现
https://mendix.bbscloud.com/post/fa7017202ada44729a9c849b60aa641b

3.2 自定义组件预览

首先要了解Pluggable Widget Property Types - 自定义组件的属性类型。您可以参考此网站:https://docs.mendix.com/apidocs-mxsdk/apidocs/pluggable-widgets-property-types
在开发之前,先通过指令 npm run build构建widget
10.png

然后在mendix项目中,选择App - Synchronze App Directory,就可以在tool box中找到刚刚我们构建的自定义组件的名称。
11.png
把Enter to Action Widget拖进 home_web.page文件中的data view组件中。
12.png
双击这个自定义组件,查看项目生成的基本属性。这里可以看到基本属性有Default value,它的描述是 Sample text input。
13.png

3.3 自定义组件编辑

首先编辑展示在Mendix studio Pro的UI(如下图所示)。
13.png
在EnterToAction.xml文件中编辑输入

                <caption>attribute</caption> 
                <description>The attribute connect to the text box</description>
                <attributeTypes>
                    <attributeType name="String"/>

                </attributeTypes>
            </property>
            <property key="action" type="action">
                <caption>On Enter</caption>
                <description>Action to be performed when enter key is pressed</description>
            </property> 

上面xml 文件代码若要深入理解它的涵义,您可参考:https://docs.mendix.com/apidocs-mxsdk/apidocs/pluggable-widgets-property-types#action
14.png
编辑完成后,重复章节 - 自定义组件预览后,右键点击自定义组件 - 更新自定义组件
15.png
双击自定义组件检查UI
16.png
为自定义组件配置属性,运行检查效果
17.png

3.4 实现数据绑定 Data Binding

数据获取,需要对React进行系统学习,此案例希望参考代码的注释部分。
首先需要主要编辑的两个文件是

<?xml version="1.0" encoding="utf-8"?>
<widget id="mendix.entertoaction.EnterToAction" pluginWidget="true" needsEntityContext="true" offlineCapable="true" supportedPlatform="Web"
    xmlns="http://www.mendix.com/widget/1.0/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mendix.com/widget/1.0/ ../node_modules/mendix/custom_widget.xsd">
    <name>Enter To Action</name>
    <description>Trigger an action when the user hits the enter key in a text input</description>
    <icon/>
    <properties>
        <propertyGroup caption="General">
            <!-- <property key="sampleText" type="string" required="false">
                <caption>Default value</caption>
                <description>Sample text input</description>
            </property> -->
            <systemProperty key="Label"/>
            <property key="attribute" type="attribute" >
                <caption>attribute</caption>
                <description>The attribute connect to the text box</description>
                <attributeTypes>
                    <attributeType name="String"/>

                </attributeTypes>
            </property>
            <property key="action" type="action">
                <caption>On Enter</caption>
                <description>Action to be performed when enter key is pressed</description>
            </property>
        </propertyGroup>
    </properties>
</widget>

EnterToAction.jsx文件代码如下:

import { Component, createElement } from "react";

import "./ui/EnterToAction.css";

export default class EnterToAction extends Component {
    constructor(props){//当你实现自定义组件,需要实现多个method的时候,首先你需要创建构造方法
        super(props);
        this.handleChange=this.handleChange.bind(this);
        this.handleKeyPress= this.handleKeyPress.bind(this);
    }
    handleChange(event){
        const{attribute}=this.props;
        attribute.setValue(event.target.value);//当自定义组件内地数据改变,实现数据回传到mendix提供的textbox中
    }
      //action 接口实现如下:
            
            // export interface ActionValue {
            //     readonly canExecute: boolean;
            //     readonly isExecuting: boolean;
            //     execute(): void;
            // }
    handleKeyPress(event){//实现按键Enter,执行action,action包括调用微流纳流等;
        const{action}=  this.props;
        if(event.which===13 && action.canExecute){
            action.execute();
          
        }

    }
    render() {
        const{attribute}= this.props;//获得数据从EnterToAction.xml的属性
      return(<input
        type="text"
        className={'form-control ${this.props.class}'}//设置UI style
        value={attribute.value}//显示从EnterToAction.xml的属性获得的数据。
        onChange={this.handleChange}//调用当value变化时的方法
        onKeyPress={this.handleKeyPress}//调用按Enter键时的方法。
       />) ;
    }
}

3.5 Demo展示

在完成对以上代码编辑后,这里通过在Terminal终端执行npm run build或者npm run dev进行调试工作。
实现效果如下图所示:
TextBoxHelloWorld.gif

更多信息,请访问以下链接:

Mendix公众号

Mendix官网:https://www.mendix.com/zh/

Mendix中国论坛:https://forum.mendix.tencent-cloud.com/

Mendix行业解决方案:https://solutions.mendix.com/

Mendix平台指南:https://www.mendix.com/evaluation-guide/

Mendix动画展示:https://www.mendix.com/demos/

谢谢阅读!

标签:Widget,自定义,mendix,入门篇,https,Mendix,组件
来源: https://blog.csdn.net/Mendix/article/details/118754155