信使 Web builder 低代码前端框架

信使 Web builder 是基于 Material 的 Angular 低代码前端框架，丰富的组件库可提供优秀的数字创新体验，
通过拖拽可视化配置快速构建现代化响应式UI、多主题、多语言的 Web 页面，包含美观的后台管理主题，拥有完整的前端解决方案。

https://builder.design

Web Builder · 信使小程序 · UI Storybook · 知乎 · English

观看演示视频

奥陌陌是已知的第一颗经过太阳系的星际天体，意为"远方信使"。

web builder

功能点	说明
Layout builder	动态 layout，基于 TailwindCss 的动态组件，支持静态数据和 API 数据来源
组件编辑	删除、复制 JSON、编辑组件数据、拖动上下排列
媒体库	可在前台批量上传、查看、更新媒体库
小程序数据维护	通过 builder 管理小程序的页面和组件
页面历史版本	当提交、清空、加载示例等覆盖操作时新增历史版本
草稿检测	当前内容有最新时，提醒是否拉取最新
丰富的模板库、示例库	基于模板库选择模板，快速生成页面
复制整个页面的 JSON	可直接复制 json，部署到后台发布
动画	支持通用的AOS页面滚动动画和高细粒度的GSAP动画
切换全宽	方便大屏编辑，减少干扰
快速生成页面	根据一定的规则从组件库中生成页面
多主题切换预览	预览在多主题下的组件显示情况
暗黑风格	支持切换浅色风格和暗黑风格，专注内容创作
页面预览	调转到新窗口查看真实的页面
响应式预览	可切换不同设备尺寸查看页面响应式排版

Web builder 管理微信小程序的页面和组件

信使小程序是基于 Taro+NutUI 的小程序，Vue3拥有更好的编辑开发体验，
在Web builder中通过拖拽可视化配置，小程序可动态构建页面。
Github 开源地址

对应版本

Web builder	Angular	Node	TS
v9	v18	v18+	v5.4
v8	v17	v18+	v5.2
v7	v16	v16+	v4.9.3
v6	v14	v14.15.0	v4.6
v5	v12	v14	v4
<=v4	v11	v14	v4

开源目的

项目非常适合初学者学习或者进阶，它涵盖了绝大部分 Angular 技术知识点，但并不仅限于以下内容。

TailwindCss
服务端渲染（SSR）
懒加载，Inject 依赖注入
路由守卫
请求拦截缓存
动态组件
动态表单
动态表格
多主题
自定义指令
自定义管道 pipe
自定义 icon
数据图表
Rxjs
Storybook
Typescript
Provider
地图应用
分析：谷歌分析、微软 Clarity
信使 UI 在 Drupal 前后端分离中的应用

技术选型

前端：Angular + Material + TailwindCss
动态表单：ngx-formly
web 动画：aos 页面滚动动画，gsap 细粒度定制化动画
图表：Echarts
视频：Video.js
文件生成：jspdf 生成 pdf，html2canvas 生成图像，file-saver 下载文件，jszip 压缩文件
编辑器：quill, ang-jsoneditor, vs monaco-editor
幻灯片：swiper
字体图标：material design icons + 自定义 svg icon
加密：crypto-js
工具函数：lodash-es
测试预览：storybook
web 服务：Nginx
后端：Drupal(推荐)，通过 Drupal 的 views 视图可灵活配置动态组件、动态 api；

开发指南

安装 npm install

代码下载或者 clone 项目到本地：git clone git@github.com:biaogebusy/web-builder.git
请使用 npm install 安装，严格安装 package-lock.json 锁版本安装，依赖较多，请多等待，使用 yarn 或者 pnpm 会有报错；

本地开发

npm start

开发环境设置

// src/environments/environment.ts
export const environment: IEnvironment = {
  apiUrl: "http://localhost:4200",
  production: false,
  port: 4200,
  cache: false,
  drupalProxy: false,
  multiLang: true,
  langs: [
    {
      label: "中文",
      langCode: "zh-hans",
      prefix: "/",
      default: true,
    },
    {
      label: "EN",
      langCode: "en",
      prefix: "/en",
    },
  ],
};

apiUrl: 是整个应用的 Base api 参数；
production: 为 false 时，页面的内容 api 将调用本地 json 文件，true 时将会调用线上接口；
port: 自定义 Node 端口；
cache: 是否开启 api 请求缓存；
drupalProxy: 对应后端为 drupal，统一使用 Drupal 来登录登出；
multiLang: 应用是否是多语言；

路由守卫配置

默认会读取 /api/v1/config 的全局配置信息，这里主要是查看该站点是否是开放还是需要登录的，文件路径src/app/core/guards/auth.guard.ts，本地开发时可注释掉大概 35 行reture true;；

本地开发环境 Proxy 代理

为了体验一致，本地默认配置体验站的API代理，配置文件config/proxy.config.js，根据实际情况进行配置；

const PROXY_CONFIG = [
  {
    context: ['/api', '/user', '/sites'],
    target: 'https://builder.design',
    secure: false,
    changeOrigin: true,
  },
];

module.exports = PROXY_CONFIG;

页面数据加载逻辑

页面在浏览器打开访问时，应用会订阅 url 的变化，根据url进行接口的数据读取，根据接口返回的数据渲染页面组件：

export function pageContentFactory(activateRoute: ActivatedRoute, contentService: ContentService, contentState: ContentState): Observable<IPage | object | boolean> {
  const $pageContent = (new BehaviorSubject() < IPage) | object | (boolean > false);
  activateRoute.url.subscribe(async (url) => {
    const page = await contentService.loadPageContent().toPromise();
    $pageContent.next(page);
    contentState.pageConfig$.next(page.config);
  });
  return $pageContent;
}

loadPageContent(pageUrl = this.pageUrl): Observable<IPage> {
    const { lang, path } = this.getUrlPath(pageUrl);

    if (environment.production) {
      const landingPath = '/api/v3/landingPage?content=';
      const pageUrlParams = `${this.apiUrl}${lang}${landingPath}${path}`;
      return this.http.get<any>(pageUrlParams).pipe(
        tap((page) => {
          this.updatePage(page);
          this.logContent(pageUrl);
        }),
        catchError(() => {
          return this.http.get<any>(`${this.apiUrl}${landingPath}/404`);
        }),
      );
    } else {
      return this.http
        .get<any>(`${this.apiUrl}/assets/app${lang}${pageUrl}.json`)
        .pipe(
          tap((page) => {
            this.updatePage(page);
          }),
          catchError(() => {
            return this.http.get<any>(`${this.apiUrl}/assets/app/404.json`);
          }),
        );
    }
  }