Skip to content

Commit 7737b17

Browse files
Merge pull request #25 from react-R/update-readme
update readme to add discussion of inputs
2 parents 5d7fee7 + 35f2103 commit 7737b17

File tree

6 files changed

+81
-64
lines changed

6 files changed

+81
-64
lines changed

README.Rmd

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,9 +17,9 @@ knitr::opts_chunk$set(
1717

1818
[![CRAN_Status_Badge](https://www.r-pkg.org/badges/version/reactR)](https://cran.r-project.org/package=reactR)
1919
[![Travis-CI Build Status](https://travis-ci.org/react-R/reactR.svg?branch=master)](https://travis-ci.org/react-R/reactR)
20+
[![Slack Status](https://reactr-slackin.herokuapp.com/badge.svg)](https://reactr-slackin.herokuapp.com/)
2021

21-
22-
`reactR` provides a set of convenience functions for using [`React`](https://facebook.github.io/react) in `R` with `htmlwidget` constructor templates and local JavaScript dependencies. The `React` ecosystem is rich with components that can enhance `R` web and Shiny apps. `scaffoldReactWidget()` helps build `htmlwidgets` to integrate these `React` components as `R` `htmlwidgets`. The local dependency functions are modeled after the `html_dependency_*` functions from RStudio's [`rmarkdown`](https://github.com/rstudio/rmarkdown) package.
22+
`reactR` provides a set of convenience functions for using [`React`](https://facebook.github.io/react) in `R` with `htmlwidget` constructor templates and local JavaScript dependencies. The `React` ecosystem is rich with components that can enhance `R` web and Shiny apps. `scaffoldReactWidget()` helps build `htmlwidgets` to integrate these `React` components as `R` `htmlwidgets`. `scaffoldReactShinyInput()` does the same for `Shiny` inputs. The local dependency functions are modeled after the `html_dependency_*` functions from RStudio's [`rmarkdown`](https://github.com/rstudio/rmarkdown) package.
2323

2424
## Installation
2525

@@ -34,12 +34,14 @@ devtools::install_github("react-R/reactR")
3434

3535
To wrap a `React` component as an `htmlwidget`, please see the tutorial [htmlwidgets with reactR](https://react-r.github.io/reactR/articles/intro_htmlwidgets.html). Also, there are a variety of examples in the [react-R Github organization](https://github.com/react-R).
3636

37-
## Shiny?
37+
## Shiny Outputs and Inputs
3838

39-
Currently, `htmlwidgets` built with `reactR` work well in Shiny as outputs. In the next version we hope to have a mechanism for input in Shiny contexts.
39+
`htmlwidgets` built with `reactR` work well in Shiny as outputs. In version `0.4.0` Alan Dipert has added the ability to easily create React-based official `Shiny` inputs with helpers and scaffolds. Please see the [tutorial](https://react-r.github.io/reactR/articles/intro_inputs.html) for more details.
4040

4141
## Examples
4242

43+
Below are examples of using `reactR` directly.
44+
4345
```R
4446
library(reactR)
4547
library(htmltools)

README.md

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,19 @@
66
[![CRAN\_Status\_Badge](https://www.r-pkg.org/badges/version/reactR)](https://cran.r-project.org/package=reactR)
77
[![Travis-CI Build
88
Status](https://travis-ci.org/react-R/reactR.svg?branch=master)](https://travis-ci.org/react-R/reactR)
9-
[![Slack Status](https://reactr-slackin.herokuapp.com/badge.svg)](https://reactr-slackin.herokuapp.com/)
9+
[![Slack
10+
Status](https://reactr-slackin.herokuapp.com/badge.svg)](https://reactr-slackin.herokuapp.com/)
1011

1112
`reactR` provides a set of convenience functions for using
1213
[`React`](https://facebook.github.io/react) in `R` with `htmlwidget`
1314
constructor templates and local JavaScript dependencies. The `React`
1415
ecosystem is rich with components that can enhance `R` web and Shiny
1516
apps. `scaffoldReactWidget()` helps build `htmlwidgets` to integrate
16-
these `React` components as `R` `htmlwidgets`. The local dependency
17-
functions are modeled after the `html_dependency_*` functions from
18-
RStudio’s [`rmarkdown`](https://github.com/rstudio/rmarkdown) package.
17+
these `React` components as `R` `htmlwidgets`.
18+
`scaffoldReactShinyInput()` does the same for `Shiny` inputs. The local
19+
dependency functions are modeled after the `html_dependency_*` functions
20+
from RStudio’s [`rmarkdown`](https://github.com/rstudio/rmarkdown)
21+
package.
1922

2023
## Installation
2124

@@ -35,14 +38,19 @@ reactR](https://react-r.github.io/reactR/articles/intro_htmlwidgets.html).
3538
Also, there are a variety of examples in the [react-R Github
3639
organization](https://github.com/react-R).
3740

38-
## Shiny?
41+
## Shiny Outputs and Inputs
3942

40-
Currently, `htmlwidgets` built with `reactR` work well in Shiny as
41-
outputs. In the next version we hope to have a mechanism for input in
42-
Shiny contexts.
43+
`htmlwidgets` built with `reactR` work well in Shiny as outputs. In
44+
version `0.4.0` Alan Dipert has added the ability to easily create
45+
React-based official `Shiny` inputs with helpers and scaffolds. Please
46+
see the
47+
[tutorial](https://react-r.github.io/reactR/articles/intro_inputs.html)
48+
for more details.
4349

4450
## Examples
4551

52+
Below are examples of using `reactR` directly.
53+
4654
``` r
4755
library(reactR)
4856
library(htmltools)
@@ -93,7 +101,3 @@ We welcome contributors and would love your participation. Please note
93101
that this project is released with a [Contributor Code of
94102
Conduct](CONDUCT.md). By participating in this project you agree to
95103
abide by the terms.
96-
97-
## Community
98-
99-
We operate a [Slack](https://slack.com) workspace you are [more than welcome to join](http://reactr-slackin.herokuapp.com/).

docs/articles/intro_htmlwidgets.html

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)