开源项目低代码表单设计器FcDesigner扩展自定义的容器组件.例如col

开源项目低代码表单设计器FcDesigner中的容器组件可以帮助您实现更灵活的布局设计。在这里,我们以一个简单的 Col 容器组件为例,来演示如何定义和使用它。

源码地址: Github | Gitee | 文档

定义组件

首先,我们创建一个 Col 组件,该组件可以容纳其他组件,并显示说明信息。

vue 复制代码
<template>
  <div class="col">
    <div>
      <slot></slot>
    </div>
    <span>slot是拖入组件的回显区域</span>
  </div>
</template>

<script setup>
import { defineProps } from 'vue';

const props = defineProps({
  span: { type: Number, default: 12 }
});
</script>

<style scoped>
.col {
  border: 1px solid #ddd;
  padding: 10px;
  box-sizing: border-box;
  position: relative;
}
</style>
  • <slot></slot>: 插槽用于放置拖入的组件。
  • props: span: 控制容器的宽度。

导入并挂载自定义组件

接下来需要将自定义的 Col 组件导入到 formCreateDesigner,并进行挂载。

js 复制代码
// 导入自定义组件
import Col from './Col.vue';
import FcDesigner from '@form-create/designer';

// 挂载自定义组件
FcDesigner.component('Col', Col); // 在 FcDesigner 中注册
// 或者全局挂载到 Vue 实例
// app.component('Col', Col);

定义组件的拖拽规则

为 Col 容器组件定义拖拽规则,以便能够在设计器中被拖拽和配置。

js 复制代码
const colRule = {
  menu: 'layout', // 插入菜单位置
  icon: 'icon-col', // 图标
  label: '格子', // 名称
  name: 'col', // 唯一ID
  drag: true, // 允许拖拽
  inside: true, // 操作按钮显示在内部
  mask: false, // 容器组件不显示遮罩
  rule() {
    return {
      type: 'Col',
      props: { span: 12 },
      children: [] // 包含的子组件
    };
  },
  props(_, { t }) {
    return [
      {
        type: 'slider',
        title: '宽度',
        field: 'span',
        value: 12,
        props: { min: 0, max: 24 } // Span 的取值范围
      }
    ];
  }
};

配置说明:

  • menu: 将组件放置在布局菜单中。
  • icon: 菜单中的组件图标。
  • label: 组件的显示名称。
  • name: 组件的唯一标识符。
  • drag: 允许组件在设计器中被拖动。
  • inside: 操作按钮在组件内部显示。
  • mask: 禁用遮罩显示。
  • rule: 定义组件的基础规则及其内部子组件。
  • props: 用于配置组件属性,使用滑块来调整宽度。

挂载组件的拖拽规则

将拖拽规则添加至设计器中,以启用组件的拖拽功能。

js 复制代码
// 在您的组件生命周期中,常见于 mounted() 方法中挂载规则
this.$refs.designer.addComponent(colRule);

通过这些步骤,您可以创建一个灵活的容器组件,并将其集成到设计器中。这使得组件的管理和布局更加高效和有序。如果需要,可以进一步扩展组件功能或样式,以适应复杂的业务需求。

相关推荐
冬奇Lab13 小时前
一天一个开源项目(第262篇):AG-UI —— 把 AI Agent 接进前端的开放协议,和 MCP、A2A 并列的第三块拼图
人工智能·开源
孟健16 小时前
用T3 Code手机远程控制Claude Code完成周报总结实测
开源·ai编程·claude
字节跳动开源17 小时前
小红书/抖音图文排版利器——一个杂志风skill
人工智能·开源·设计
tryCbest19 小时前
Vue3—— 第 18 篇:Vue 2 到 Vue 3 迁移指南——升级避坑全记录
前端·vue.js
anyup20 小时前
自带 uni-app x 页面级能力,uView Pro X 8 个开箱即用的工具函数
前端·vue.js·uni-app
FungLeo1 天前
成为全栈·Vue 管理后台篇·可折叠侧栏与移动抽屉:后台导航的响应式实现
前端·javascript·vue.js·侧边栏·响应式布局·无障碍·移动端导航
Eyfcom1 天前
〖物流低代码实战 03〗物流中台的服务编排与协议转换:从“点对点调用”到“可视化编排”
低代码·快递系统·物流低代码实战
ClouGence1 天前
自动化测试定位不到元素怎么办?
selenium·低代码·测试
思特奇时空智能1 天前
大规模点要素地图渲染性能优化实践
vue.js·arcgis·性能优化·node.js·html·gis·webgl
FungLeo1 天前
成为全栈·Vue 管理后台篇·Biome、类型检查、构建和API 代理如何组成质量门禁
前端·javascript·vue.js·typescript·vite·前端工程化·biome