快捷導(dǎo)航

阿里低代碼框架lowcode-engine設(shè)置默認容器詳解

更新時間：2023年02月27日 09:22:57 作者：杰出D

這篇文章主要為大家介紹了阿里低代碼框架lowcode-engine設(shè)置默認容器詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪

前言

之前我們介紹了lowcode-engine一些基礎(chǔ)相關(guān)內(nèi)容，接下來我們通過引擎實戰(zhàn)一些內(nèi)容，在一些場景當中，我們的默認容器不是頁面，而是需要自定義容器。例如，在常見的低代碼平臺中默認容器是表單容器，通過表單容器類提供布局能力。接下來我們就去實現(xiàn)這個功能。

物料【FormContainer】開發(fā)

該物料組件主要是用來存放所有FormItem,可以設(shè)置列數(shù)。

物料組件

接下來我們看代碼內(nèi)容

export interface IFormContainerProps {
  // 列數(shù)
  cols: number;
}
/**
 * Form容器包裝器。lowcode-engine不支持直接使用hooks組件，需要包裹一層，要不內(nèi)容元素沒辦法直接嵌入
 */
export const FormContainerWrapper = forwardRef<IFormRef | undefined, IFormContainerProps>(function FormContainer({
  cols,
  children
}, ref) {
  const [form] = Form.useForm();
  React.useImperativeHandle(ref, () => {
    return {
      formRef: form
    }
  }, [])
  const getChildren = () => {
    if (React.Children.count(children) <= 1) {
      return children;
    }
    const newArray = groupArray(React.Children.toArray(children), cols);
    return newArray.map(childs => {
      return <Row key={childs?.[0]?.key} gutter={[16, 24]} className={generatorClass('form-container-row')}>
        {
          childs.map(child => {
            const { props } = child;
            const name = props.componentId || props.__id;
            return <Col key={name} span={24 / cols}>
              <Form.Item
                label=""
                name={name}
                rules={[{ required: props.isRequired, message: `${props.title}不能為空！` }]}
              >
                {child}
              </Form.Item>
            </Col>;
          })
        }
      </Row>
    })
  }
  const rootClassNames = classNames(generatorClass('form-container'));
  return (
    <Form form={form} className={rootClassNames}>
      {getChildren()}
    </Form>
  )
});
/**
 * 容器組件
 */
export class FormContainer extends React.Component<IFormContainerProps, any> {
  render() {
    return (
      <FormContainerWrapper {...this.props} />
    )
  }
}

在實現(xiàn)的過程中開始使用的hooks組件，發(fā)現(xiàn)會有問題，我們用class組件包裝了下，就沒什么問題了。后續(xù)遷去看看源碼引擎是怎么加載物料的，再來回答這個問題。

物料Meta信息

上面的物料組件就有一個cols需要配置，對用的setter我們可以使用官方提供的RadioGroupSetter. 由于整個配置模版內(nèi)容比較多，我只把關(guān)鍵點configure配置內(nèi)容說下。

 "configure": {
    "props": [
      {
        "title": {
          "label": {
            "type": "i18n",
            "en-US": "cols",
            "zh-CN": "列數(shù)"
          }
        },
        "name": "cols",
        "setter": {
          "title": "列數(shù)",
          "componentName": "RadioGroupSetter",
          "isRequired": true,
          "props": {
            "options": [{
              "label": "1列",
              "value": 1,
            }, {
              "label": "2列",
              "value": 2,
            }, {
              "label": "3列",
              "value": 3,
            }, {
              "label": "4列",
              "value": 4
            }]
          },
          "initialValue": 1
        }
      }
    ],
    "supports": {
    },
    "component": {
      // 是否是容器組件，如果是容器組件，別的組件可以放置內(nèi)容
      isContainer: true
    },
  }

我們看配置內(nèi)容，一個是設(shè)置setter, 還有比較重要的一點就是在component下需要配置isContainer。如果為true，表示內(nèi)容其它組件可以拖到該容器內(nèi)。

模版內(nèi)容修改

通過研究lowcode-engine，我們可以知道內(nèi)容的渲染是通過schema.json來渲染內(nèi)容。我們只需修改下初始的 schema.json。加上容器組件，模版內(nèi)容為

 "componentName": "Page",
  "id": "node_dockcviv8fo1",
  ...
  "title": "頁面",
  "isLocked": false,
  "condition": true,
  "conditionGroup": "",
  "children": [
    {
      // 容器組件
      "componentName": "FormContainer",
      "id": "node_oclcdgs7nr1",
      "props": {
        "cols": 2
      },
      "hidden": false,
      "title": "",
      "isLocked": false,
      "condition": true,
      "conditionGroup": ""
    }
  ]

我們看引擎的大綱內(nèi)容，默認就有表單組件了。