为 SPA 实施 React 组件 implementing-a-react-component-for-spa
单页应用程序 (SPA) 可以为网站用户提供引人入胜的良好体验。开发人员希望能够使用SPA框架构建站点，而作者则希望在AEM中无缝编辑使用SPA框架构建的站点的内容。
SPA创作功能提供了一个全面的解决方案，可在AEM中支持SPA。 本文提供了一个示例，说明如何调整现有的简单React组件以与AEM SPA Editor一起使用。
简介 introduction
由于AEM要求在SPA和SPA编辑器之间签订简单而轻量的合同，因此获取现有的Javascript应用程序并对其进行改编以用于AEM中的SPA非常简单。
本文说明了We.Retail Journal示例SPA上天气组件的示例。
您应该熟悉 适用于AEM的SPA应用程序的结构 阅读本文之前。
天气组件 the-weather-component
天气组件位于We.Retail Journal应用程序的左上角。 它显示定义位置的当前天气，并动态提取天气数据。
使用天气小组件 using-the-weather-widget
在SPA编辑器中创作SPA内容时，天气组件会显示为任何其他AEM组件（带有工具栏且可编辑）。
与任何其他AEM组件一样，可以在对话框中更新城市。
将保留更改，并且组件会使用新天气数据自动更新自身。
天气组件实施 weather-component-implementation
天气组件实际上基于一个公开提供的React组件，称为 React Open Weather，已在We.Retail Journal示例SPA应用程序中改为用作组件。
以下是NPM文档中关于React Open Weather组件用法的片段。
查看自定义天气组件的代码( Weather.js):
-
16号线:根据需要加载React Open Weather小组件。
-
46号线:的
MapTo函数将此AEM组件与相应的SPA组件关联，以便在React编辑器中对其进行编辑。 -
第22-29行:的
EditConfig定义，检查城市是否已填充，并定义值（如果为空）。 -
第31-44行:天气组件将
Component类和提供React Open Weather组件的NPM使用文档中定义的所需数据，并渲染组件。
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~ Copyright 2018 Adobe Systems Incorporated
~
~ Licensed under the Apache License, Version 2.0 (the "License");
~ you may not use this file except in compliance with the License.
~ You may obtain a copy of the License at
~
~ https://www.apache.org/licenses/LICENSE-2.0
~
~ Unless required by applicable law or agreed to in writing, software
~ distributed under the License is distributed on an "AS IS" BASIS,
~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
~ See the License for the specific language governing permissions and
~ limitations under the License.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
import React, {Component} from 'react';
import ReactWeather from 'react-open-weather';
import {MapTo} from '@adobe/aem-react-editable-components';
require('./Weather.css');
const WeatherEditConfig = {
emptyLabel: 'Weather',
isEmpty: function() {
return !this.props || !this.props.cq_model || !this.props.cq_model.city || this.props.cq_model.city.trim().length < 1;
}
};
class Weather extends Component {
render() {
let apiKey = "12345678901234567890";
let city;
if (this.props.cq_model) {
city = this.props.cq_model.city;
return <ReactWeather key={'react-weather' + Date.now()} forecast="today" apikey={apiKey} type="city" city={city} />
}
return null;
}
}
MapTo('we-retail-journal/global/components/weather')(Weather, WeatherEditConfig);
尽管后端组件必须已存在，但前端开发人员可以利用We.Retail Journal SPA中的React Open Weather组件，而且只需极少的编码。
后续步骤 next-step
有关开发SPA for AEM的更多信息，请参阅文章 开发SPA for AEM.