JarCasting
JarCasting JarCasting

aem react

aem react library and demo

License

License

MIT
Categories

Categories

React User Interface Web Frameworks
GroupId

GroupId

com.sinnerschrader.vw.aem.react
ArtifactId

ArtifactId

aem-react
Last Version

Last Version

0.23.1
Release Date

Release Date
Type

Type

pom
Description

Description

aem react
aem react library and demo
Source Code Management

Source Code Management

https://github.com/sinnerschrader/aem-react.git

Download aem-react

Filename Size
aem-react-0.23.1.pom 19 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.sinnerschrader.vw.aem.react/aem-react/ -->
<dependency>
    <groupId>com.sinnerschrader.vw.aem.react</groupId>
    <artifactId>aem-react</artifactId>
    <version>0.23.1</version>
    <type>pom</type>
</dependency>
// https://jarcasting.com/artifacts/com.sinnerschrader.vw.aem.react/aem-react/
implementation 'com.sinnerschrader.vw.aem.react:aem-react:0.23.1'
// https://jarcasting.com/artifacts/com.sinnerschrader.vw.aem.react/aem-react/
implementation ("com.sinnerschrader.vw.aem.react:aem-react:0.23.1")
'com.sinnerschrader.vw.aem.react:aem-react:pom:0.23.1'
<dependency org="com.sinnerschrader.vw.aem.react" name="aem-react" rev="0.23.1">
  <artifact name="aem-react" type="pom" />
</dependency>
@Grapes(
@Grab(group='com.sinnerschrader.vw.aem.react', module='aem-react', version='0.23.1')
)
libraryDependencies += "com.sinnerschrader.vw.aem.react" % "aem-react" % "0.23.1"
[com.sinnerschrader.vw.aem.react/aem-react "0.23.1"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

  • core
  • generate-typescript-maven-plugin
  • aem-react-api

Adobe Experience Manager ("AEM") components written in React

This project makes it possible to render Adobe Experience Manager ("AEM") components via React.

STATUS

Build Status Maven Central

  • Version: 0.4
  • API is unstable

Documentation

An comprehensive documentation is being developed.

Deploy / install the demo

You can download the demo content package from here and deploy it to your local AEM instance. View the demo

To install the demo locally:

git clone https://github.com/sinnerschrader/aem-react.git

cd aem-react

mvn clean install -PautoInstallPackage -Dgpg.skip=true

##Trouble shooting

Nashorn engine erro: "No such function renderReactComponent"

Check configuration of ReactScriptEngine in webconsole:

  • go to /system/console/configMgr
  • search for "react" in the browser
  • open the configuration of "ReactJs Script Engine Factory"
  • important: jcr path must be "/etc/designs/react-demo/js/react-demo/server.js/jcr:content"
  • if it is not then update it.

Background

Nowadays every web application contains at least some highly interactive ui components that are implemented via javascript in the client.

React is one of the most popular javascript web frameworks today. React makes client-side web application development as easy as good old server side web development because of its "render everthing" ansatz. The developer doesn't need to think about the minimal set of dom manipulations to get to the next state of the ui but instead defines the new state and the framework handles the dom manipulation.

React can be directly used in conjunction with AEM for client-side tasks. Unfortunately that means that the dom that Reactjs handles will not be rendered on the server and thus will not be available on first page load and requires extra work to be indexable by search engines. This project makes it possible to render AEM components with React on the server.

License

MIT

Contribution

Contributions are welcome!

The repository contains the OSGI bundle in the folder core. In the folder demo is a demo project that can be used as a starting point for your own project.

OSGI core bundle

The maven module in ./core contains the implementation of the AEM component type and the pool of nashorn engines.

Demo content package

The maven module in ./demo defines a demo content package that includes some example components and demo pages.

Javascript library

The javascript library is required and integrated by the build tools in the demo project.

Dependencies

  • = Java 8 (Oracle JDK with nashorn engine)

  • = AEM 6.0

com.sinnerschrader.vw.aem.react

SinnerSchrader

We love people who love building things.

Versions

Version
0.23.1
0.23.0
0.22.0