@cyia/ngx-bridge
TypeScript icon, indicating that this package has built-in type declarations

0.0.7 • Public • Published

在 Angular 中调用任意 React/Vue 库

  • 理论上可以调用任意 React/Vue 库

演示

简介

  • 在 Angular 中调用 React/Vue 库,使 React/Vue 库像(Angular)原生组件一样使用
  • 可以把 Angular 包装成 React/Vue 组件,供 React/Vue 使用

    目前仅 Angular 内

使用

  • 需要在 17.2.0 以上的版本使用
  • react 中为react-outlet,vue 中为vue-outlet
import { VueOutlet } from '@cyia/ngx-bridge/vue-outlet';
@Component({
  imports: [VueOutlet],
  template:``
})
import { ReactOutlet } from '@cyia/ngx-bridge/react-outlet';
@Component({
  imports: [ReactOutlet],
  template:``
})

根组件

  • 相当于 React/Vue 的render(xxx)

root参数默认为是否存在父级react-outlet wrapperToReact调用的组件内如果有outlet,顶级react-outlet需要root设置false(因为被调用,存在父级)

<react-outlet [component]="xxxx" [root]="true" #root></react-outlet>

子组件(children)

  • react-outlet投影中的都叫子组件,包括投影的投影
<!-- 直接子组件,也就是react-outlet的子级 -->
<react-outlet [component]="xxxx" #child></react-outlet>
<!-- 非直接子组件,父级不是react-outlet,但是父级的?级有react-outlet -->
<react-outlet [component]="xxxx" [parent]="root"></react-outlet>

Angular 组件作为 react 子组件(如果需要 react 上下文的情况下)

  • 继承 ComponentInReact
<xxx [parent]="root"></xxx>

Angular 组件作为 React 组件的某个属性传入

  • 视情况传入元素或函数组件
wrapperToReact(xxxx, {}).reactFunctionComponent;
wrapperToReact(xxxx, {}).reactElement;

react 中调用 Angular 组件

  • 虽然开发中尽量减少这种情况出现,但是也没法杜绝
<NgOutletReact component={OutletRefTestComponent}></NgOutletReact>

配置修改

  • 假如您使用 tsx 文件,请修改tsconfig.json
  "compilerOptions": {
    "jsx": "react-jsx"
  },
  • angular.json
 "prerender": false

一般新项目中会自动开启

zone

  • 设计上:React/Vue 环境中任何组件都应该在<root>

  • 设计上:向 ng 发出的任何信号都应该在angular

  • 设计上:任何 ng 组件初始化时都应该在angular

  • 如果你发现某种情况下不符合上面情况,请去提issue,可能是库的原因

已知问题

  • children 是根据投影插入的,这就会导致当出现时是 ng 组件先初始化,然后初始化 React/Vue 组件,然后销毁的时候是 ng 先销毁,再销毁对应的组件
  • 这会导致 Vue 的内置组件Transition在销毁时的动画无法正常播放.可以使用bridge-child控制,但是缺点就是[enable]="false"时内部投影不会消失,仅仅是不被插入

已测试库

react

  • reactflow
  • slate
  • @tiptap
  • react-hot-toast
  • @react-pdf
  • antd
  • react-icons
  • react-spinners
  • react-dnd
  • react-hook-form

vue

  • vue 部分大多数是组件库,有意思的库比较少....
  • ant-design-vue
  • 内置 Transition

关于开源

changelog

0.0.6

  • 销毁交给桥接的库控制(但是投影不会销毁,仅仅是不显示)

    BridgeChild

  • 增加柯里化管道,用于事件传递时传入额外参数

    CurryPipe

0.0.5

  • 支持 vue 库调用
  • 一些导出重命名

0.0.4

  • 修复 zone 相关.

    react => <root>

Package Sidebar

Install

npm i @cyia/ngx-bridge

Weekly Downloads

60

Version

0.0.7

License

none

Unpacked Size

105 kB

Total Files

60

Last publish

Collaborators

  • wszgrcy