2017 © Pedro Peláez
 

library react-laravel

Package to use ReactJS with Laravel

image

talyssonoc/react-laravel

Package to use ReactJS with Laravel

  • Thursday, October 27, 2016
  • by talyssonoc
  • Repository
  • 50 Watchers
  • 873 Stars
  • 4,778 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 92 Forks
  • 14 Open issues
  • 13 Versions
  • 0 % Grown

The README.md

Code Climate Build Status, (*1)

react-laravel

With react-laravel you'll be able to use ReactJS components right from your Blade views, with optional server-side rendering, and use them on the client-side with React due to unobtrusive JavaScript., (*2)

Installation

V8js dependency

It's important to know that react-laravel has an indirect dependency of the v8js PHP extension., (*3)

You can see how to install it here: how to install v8js., (*4)

Composer

Set the minimum-stability of your composer.json to dev, adding this:, (*5)

  "minimum-stability": "dev"

Then run:, (*6)

  $ composer require talyssonoc/react-laravel:0.11

After that you should add this to your providers at the config/app.php file of your Laravel app:, (*7)

  'React\ReactServiceProvider'

And then run:, (*8)

  php artisan vendor:publish

And the react.php file will be available at the config folder of your app., (*9)

Usage

After the installation and configuration, you'll be able to use the @react_component directive in your views., (*10)

The @react_component directive accepts 3 arguments:, (*11)

  @react_component(<componentName>[, props, options])

  //example
  @react_component('Message', [ 'title' => 'Hello, World' ], [ 'prerender' => true ])

  // example using namespaced component
  @react_component('Acme.Message', [ 'title' => 'Hello, World' ], [ 'prerender' => true ])
  • componentName: Is the name of the global variable that holds your component. When using Namespaced Components you may use dot-notation for the component name.
  • props: Associative of the props that'll be passed to your component
  • options: Associative array of options that you can pass to the react-laravel:
    • prerender: Tells react-laravel to render your component server-side, and then just mount it on the client-side. Default to true.
    • tag: The tag of the element that'll hold your component. Default to 'div'.
    • html attributes: Any other valid HTML attribute that will be added to the wrapper element of your component. Example: 'id' => 'my_component'.

All your components should be inside public/js/components.js (you can configure it, see below) and be global., (*12)

You must include react.js, react-dom.js and react_ujs.js (in this order) in your view. You can concatenate these files together using laravel-elixir., (*13)

react-laravel provides a ReactJS installation and the react_us.js file, they'll be at public/vendor/react-laravel folder after you install react-laravel and run:, (*14)

  $ php artisan vendor:publish --force

For using the files provided by react-laravel and your components.js file, add this to your view:, (*15)

  <script src="{{ asset('vendor/react-laravel/react.js') }}"></script>
  <script src="{{ asset('vendor/react-laravel/react-dom.js') }}"></script>
  <script src="{{ asset('js/components.js') }}"></script>
  <script src="{{ asset('vendor/react-laravel/react_ujs.js') }}"></script>

If you'll use a different version from the one provided by react-laravel (see composer.json), you got to configure it (see below)., (*16)

Configurations

You can change settings to react-laravel at the config/react.php file:, (*17)

  return [
    'source' => 'path_for_react.js',
    'dom-source' => 'path_for_react-dom.js',
    'dom-server-source' => 'path_for_react-dom-server.js',
    'components' => [ 'path_for_file_containing_your_components.js' ]
  ];

All of them are optional., (*18)

  • source: defaults to public/vendor/react-laravel/react.js.
  • dom-source: defaults to public/vendor/react-laravel/react-dom.js.
  • dom-server-source: defaults to public/vendor/react-laravel/react-dom-server.js.
  • components: defaults to public/js/components.js. Multiple components files may be specified here.

Your components.js file(s) should also be included at your view, and all your components must be at the window object., (*19)

Thanks

This package is inspired at react-rails., (*20)

The Versions

27/10 2016

dev-master

9999999-dev

Package to use ReactJS with Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Talysson Oliveira

laravel react reactjs

20/01 2016

v0.11

0.11.0.0

Package to use ReactJS with Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Talysson Oliveira

laravel react reactjs

02/10 2015

v0.10.2

0.10.2.0

Package to use ReactJS with Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Talysson Oliveira

laravel react reactjs

25/07 2015

v0.10.1

0.10.1.0

Package to use ReactJS with Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Talysson Oliveira

laravel react reactjs

13/07 2015

v0.10

0.10.0.0

Package to use ReactJS with Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Talysson Oliveira

laravel react reactjs

11/06 2015

v0.9.1

0.9.1.0

Package to use ReactJS with Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Talysson Oliveira

laravel react reactjs

27/05 2015

v0.9

0.9.0.0

Package to use ReactJS with Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Talysson Oliveira

laravel react reactjs

09/05 2015

v0.8

0.8.0.0

Package to use ReactJS with Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Talysson Oliveira

laravel react reactjs

23/04 2015

v0.7

0.7.0.0

Package to use ReactJS with Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Talysson Oliveira

laravel react reactjs

21/04 2015

v0.5

0.5.0.0

Package to use ReactJS with Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Talysson Oliveira

laravel react reactjs

19/04 2015

v0.3

0.3.0.0

Package to use ReactJS with Laravel

  Sources   Download

MIT

The Requires

 

The Development Requires

by Talysson Oliveira

laravel react reactjs

11/04 2015

v0.2

0.2.0.0

Package to use ReactJS with Laravel

  Sources   Download

MIT

The Requires

 

by Talysson Oliveira

laravel react reactjs

09/04 2015

v0.1

0.1.0.0

Package to use ReactJS with Laravel

  Sources   Download

MIT

The Requires

 

by Avatar talyssonoc