smile / magento2-react

模块,用于将React添加到Magento 2 KO前端

安装次数: 56,397

依赖者: 0

建议者: 0

安全性: 0

星标: 4

关注者: 2

分支: 11

语言:JavaScript

类型:magento2-component

16.12.2 2023-06-06 08:08 UTC

README

本模块是基于Yireo制作的POC进行友好的分支,Yireo制作的POC在此处可用: https://github.com/yireo-training/Yireo_React

非常感谢Yireo和Jessie Reitsma为这个实现奠定了第一步。

为基于Knockout的Magento 2前端添加React

当前的Magento 2前端基于Knockout、RequireJS和ES5代码。

然而,着眼于即将到来的PWA迁移,现在已经在现有的Magento 2前端中添加React组件。

此Magento模块作为基础模块,为类似Yireo_ReactMinicartYireo_ReactMenu的模块提供通用的Webpack配置。

先决条件

本模块需要

它包含什么

  • 将React集成到Magento中的基本集成,允许构建React组件
  • 这还集成了所有由Magento PWA Studio提供的Peregrine组件,以实现更好的可重用性。
  • 允许构建组件的Webpack配置。

安装

使用以下命令将此模块安装到Magento 2中

composer require smile/magento2-react
bin/magento module:enable Smile_React
bin/magento setup:upgrade

composer安装应该已经将package.jsonwebpack.config.js文件复制到您的Magento根目录。如果不是这种情况,您可以手动复制它们。

接下来,安装所有包

yarn install

接下来,您可以通过Webpack在各种模块中构建React源代码

yarn dev

或者,您也可以将这两个文件复制到另一个文件夹,并使用MAGENTO_ROOT变量

MAGENTO_ROOT=/var/www/html yarn dev

用法

此模块没有实际的功能。它只提供其他React模块的配置文件。

请参阅Yireo_ReactMenu模块中的示例组件。

目标是创建一个包含view/frontend/react_source文件夹的模块,或者创建一个包含react_source文件夹的主题,并让这个Webpack配置识别这些文件以创建单个包。还支持动态包(使用import()函数调用)。

主题通过全局变量进行标识

MAGENTO_THEME=Magento/luma yarn dev

实验性

此模块是实验性的,仅供愿意投入时间进行开发的开发者使用。这并不意味着它需要很多努力,它仅仅意味着该项目需要对React基础知识有所了解。