smile / magento2-react
模块,用于将React添加到Magento 2 KO前端
Requires
- magento/framework: ^100.1|^101.0|^102.0|^103.0
- magento/magento-composer-installer: *
Requires (Dev)
- composer/composer: *@dev
This package is auto-updated.
Last update: 2024-09-10 16:12:18 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_ReactMinicart和Yireo_ReactMenu的模块提供通用的Webpack配置。
先决条件
本模块需要
- yarn v1.19.1
它包含什么
- 将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.json
和webpack.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基础知识有所了解。