{"id":13736832,"url":"https://github.com/etiennebacher/shinyfullscreen","last_synced_at":"2025-03-19T23:31:16.593Z","repository":{"id":55086364,"uuid":"320671350","full_name":"etiennebacher/shinyfullscreen","owner":"etiennebacher","description":"Display HTML Elements on Full Screen in 'Shiny' Apps Using 'Screenfull.js'","archived":false,"fork":false,"pushed_at":"2023-04-20T14:31:06.000Z","size":2078,"stargazers_count":33,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-15T00:51:58.617Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/etiennebacher.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-11T19:58:35.000Z","updated_at":"2024-09-21T12:01:05.000Z","dependencies_parsed_at":"2024-10-27T21:39:29.098Z","dependency_job_id":"01ebde46-0648-4c52-b451-cb04c558e578","html_url":"https://github.com/etiennebacher/shinyfullscreen","commit_stats":{"total_commits":29,"total_committers":5,"mean_commits":5.8,"dds":0.3793103448275862,"last_synced_commit":"69221b56ccdeb8f256fb64bfa37299db209cc135"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/etiennebacher%2Fshinyfullscreen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/etiennebacher%2Fshinyfullscreen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/etiennebacher%2Fshinyfullscreen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/etiennebacher%2Fshinyfullscreen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/etiennebacher","download_url":"https://codeload.github.com/etiennebacher/shinyfullscreen/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244524898,"owners_count":20466525,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T03:01:29.473Z","updated_at":"2025-03-19T23:31:16.089Z","avatar_url":"https://github.com/etiennebacher.png","language":"R","funding_links":[],"categories":["Miscellaneous","R"],"sub_categories":["UI Customization"],"readme":"\n# shinyfullscreen\n\n\u003c!-- badges: start --\u003e\n\n[![Codecov.io test coverage](https://codecov.io/gh/etiennebacher/shinyfullscreen/branch/master/graphs/badge.svg)](https://codecov.io/github/etiennebacher/shinyfullscreen) [![R build status](https://github.com/etiennebacher/shinyfullscreen/workflows/R-CMD-check/badge.svg)](https://github.com/etiennebacher/shinyfullscreen/actions) [![CRAN status](https://www.r-pkg.org/badges/version/shinyfullscreen)](https://CRAN.R-project.org/package=shinyfullscreen) ![](https://cranlogs.r-pkg.org/badges/shinyfullscreen)\n[![R-CMD-check](https://github.com/etiennebacher/shinyfullscreen/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/etiennebacher/shinyfullscreen/actions/workflows/R-CMD-check.yaml)\n\u003c!-- badges: end --\u003e\n\nThe goal of `{shinyfullscreen}` is to enable users to put some items on fullscreen. This package is the adaptation in R of [`screenfull.js`](https://github.com/sindresorhus/screenfull.js).\n\n## Table of contents\n\n- [Demos](#demo)\n- [Installation](#installation)\n- [How to use](#howto)\n- [Code of Conduct](#CoC)\n\n\n\u003ch2 id = \"demo\"\u003e Demos \u003c/h2\u003e \n\n* Two plots can be displayed on full screen\n\n![](fullscreen-those2.gif)\n\n* Interactive graphs and custom background color on fullscreen only\n\n![](echarts-bgcolor.gif)\n\n\n\u003ch2 id = \"installation\"\u003e Installation \u003c/h2\u003e \n\nInstall the CRAN version with:\n```r\ninstall.packages(\"shinyfullscreen\")\n```\n\nInstall the development version with:\n\n``` r\n# install.packages(\"devtools\")\ndevtools::install_github(\"etiennebacher/shinyfullscreen\")\n```\n\n\u003ch2 id = \"howto\"\u003e How to use \u003c/h2\u003e \n\nNote that `{shinyfullscreen}` only works when the Shiny app is launched **in the browser**. It won't work in an RStudio window. \n\nThis package provides three functions that are very similar:\n\n* `fullscreen_this()` is useful if you want to enable fullscreen for few elements. Simply wrap this function around the element for which you want to enable fullscreen, and then click on this element when the app runs to display it on fullscreen:\n\n```R\n### Only works in browser\n\nlibrary(shiny)\nlibrary(shinyfullscreen)\n\nui \u003c- fluidPage(\n\n  fullscreen_this(plotOutput(\"plot\"))\n  \n  # Also works with magrittr's pipe\n  # plotOutput(\"plot\") %\u003e%\n  #   fullscreen_this()\n)\n\nserver \u003c- function(input, output, session) {\n  \n  output$plot \u003c- renderPlot(plot(mtcars))\n  \n}\n\nshinyApp(ui, server, options = list(launch.browser = TRUE))\n```\n\n* `fullscreen_those()` is useful if you want to enable fullscreen view for several items without rewriting the same code again and again. Simply write your UI as usual, and then call this function with a list of ids corresponding to the items for which you want to enable fullscreen view. Note that this function has to be called after having created these items:\n\n```R\n### Only works in browser\n\nlibrary(shiny)\nlibrary(shinyfullscreen)\n\nui \u003c- fluidPage(\n  plotOutput(\"plot\"),\n  plotOutput(\"plot2\"),\n  \n  # Has to be placed after plot and plot2\n  fullscreen_those(items = list(\"plot\", \"plot2\"))\n)\n\nserver \u003c- function(input, output, session) {\n  \n  output$plot \u003c- renderPlot(plot(mtcars))\n  output$plot2 \u003c- renderPlot(plot(AirPassengers))\n  \n}\n\nshinyApp(ui, server, options = list(launch.browser = TRUE))\n```\n\n* `fullscreen_all()` allows you to put the whole page in fullscreen mode. Note however that this requires clicking on an HTML element.\n\n```R\n### Only works in browser\n\nlibrary(shiny)\nlibrary(shinyfullscreen)\n\nui \u003c- fluidPage(\n  actionButton(\"page_full\", \"Show page in fullscreen\"),\n  plotOutput(\"plot\"),\n  fullscreen_all(click_id = \"page_full\")\n)\n\nserver \u003c- function(input, output, session) {\n\n  output$plot \u003c- renderPlot(plot(mtcars))\n\n}\n\nshinyApp(ui, server, options = list(launch.browser = TRUE))\n```\n\n\u003ch2 id = \"CoC\"\u003e Code of Conduct \u003c/h2\u003e \n\nPlease note that the shinyfullscreen project is released with a [Contributor Code of Conduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fetiennebacher%2Fshinyfullscreen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fetiennebacher%2Fshinyfullscreen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fetiennebacher%2Fshinyfullscreen/lists"}