Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rstudio/shinyvalidate
Input validation package for the Shiny web framework
https://github.com/rstudio/shinyvalidate
shiny ui validation
Last synced: 13 days ago
JSON representation
Input validation package for the Shiny web framework
- Host: GitHub
- URL: https://github.com/rstudio/shinyvalidate
- Owner: rstudio
- License: other
- Created: 2020-07-23T00:20:44.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-10-05T22:12:28.000Z (about 1 year ago)
- Last Synced: 2024-09-26T16:18:46.768Z (about 1 month ago)
- Topics: shiny, ui, validation
- Language: JavaScript
- Homepage: https://rstudio.github.io/shinyvalidate/
- Size: 1.91 MB
- Stars: 108
- Watchers: 11
- Forks: 8
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-shiny-extensions - shinyvalidate - Add input validation capabilities to Shiny. (UI Components / Feedback / Alert / Notification)
- jimsghstars - rstudio/shinyvalidate - Input validation package for the Shiny web framework (JavaScript)
README
# shinyvalidate
[](https://CRAN.R-project.org/package=shinyvalidate)
[](https://github.com/rstudio/shinyvalidate/actions)
[](https://lifecycle.r-lib.org/articles/stages.html)
## Overview
shinyvalidate adds input validation capabilities to [Shiny](https://shiny.posit.co/).
## Installation
Install the latest CRAN release:
``` {.r}
install.packages("shinyvalidate")
```
Or, you can install the latest development version from GitHub using the `remotes` package.
``` {.r}
remotes::install_github("rstudio/shinyvalidate")
```
## Basic usage
To add validation to your Shiny app, you need to:
1. Create an InputValidator object: `iv <- InputValidator$new()`
2. Add one or more validation rules to the InputValidator: `iv$add_rule("title", sv_required())`
3. Turn the validator on: `iv$enable()`
That's all you need to do to get validation messages to show up. Here is a simple example:
``` r
library(shiny)
library(shinyvalidate)
ui <- fluidPage(
textInput("name", "Name"),
textInput("email", "Email")
)
server <- function(input, output, session) {
iv <- InputValidator$new()
iv$add_rule("name", sv_required())
iv$add_rule("email", sv_required())
iv$add_rule("email", sv_email())
iv$enable()
}
shinyApp(ui, server)
```
To learn about other features of shinyvalidate, including deferred validation, programmatically accessing validation results, and validating Shiny modules, see [*Introduction to shinyvalidate*](https://rstudio.github.io/shinyvalidate/articles/shinyvalidate.html).
## Input widget compatibility
shinyvalidate should work with all of the inputs that are included in Shiny. It will also work with most custom inputs that follow Bootstrap 3 or 4 conventions. Other types of custom inputs can include their own logic for displaying shinyvalidate error messages; see the article [*Displaying validation errors*](https://rstudio.github.io/shinyvalidate/articles/displaying.html) to learn more.
## Prior art
- [Shiny's built-in validation](https://shiny.rstudio.com/articles/validation.html). The `shiny::validate()` function fits naturally with Shiny's reactive programming model, but has limited usefulness because it only shows validation feedback in downstream reactive outputs, instead of providing the feedback next to the incorrect input, where users expect it.
- [shinyFeedback](https://github.com/merlinoa/shinyFeedback) by [@merlinoa](https://github.com/merlinoa), who graciously provided feedback on the design of shinyvalidate. Compared to shinyFeedback, shinyvalidate aims to have a more concise but less flexible R API; and on the UI side, shinyFeedback displays richer feedback on a hard-coded set of components, while shinyvalidate feedback is minimalist but aims to support a larger set of components and is extensible for custom inputs.