Skip to content

Commit

Permalink
Merge remote-tracking branch 'origin/main' into 338_datanames_in_vign…
Browse files Browse the repository at this point in the history
…ettes
  • Loading branch information
gogonzo committed Dec 19, 2024
2 parents fa1271f + 52cbc4e commit df437d2
Show file tree
Hide file tree
Showing 4 changed files with 10 additions and 10 deletions.
2 changes: 1 addition & 1 deletion DESCRIPTION
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Type: Package
Package: teal
Title: Exploratory Web Apps for Analyzing Clinical Trials Data
Version: 0.15.2.9095
Version: 0.15.2.9096
Date: 2024-12-19
Authors@R: c(
person("Dawid", "Kaledkowski", , "[email protected]", role = c("aut", "cre"),
Expand Down
2 changes: 1 addition & 1 deletion NEWS.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# teal 0.15.2.9095
# teal 0.15.2.9096

### New features

Expand Down
4 changes: 2 additions & 2 deletions vignettes/data-transform-as-shiny-module.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -12,10 +12,10 @@ vignette: >

## Introduction

[`teal_transform_module()`](https://insightsengineering.github.io/teal/latest-tag/reference/teal_transform_module.html) is a Shiny module that takes `ui` and `server` arguments. When provided, `teal` will execute data transformations for the specified module when it is loaded and whenever the data changes. `server` extend the logic behind data manipulations, where `ui` extends filter panel with new UI elements that orchestrate the transformator inputs.
`teal_transform_module()` is a Shiny module that takes `ui` and `server` arguments. When provided, `teal` will execute data transformations for the specified module when it is loaded and whenever the data changes. `server` extend the logic behind data manipulations, where `ui` extends filter panel with new UI elements that orchestrate the transformator inputs.

`teal` version `0.16` introduced a new, optional argument in `teal::module` named `transformators`.
This argument allows to pass a `list` of `"teal_data_module"` class of objects created using [`teal_transform_module()`](https://insightsengineering.github.io/teal/latest-tag/reference/teal_transform_module.html) function.
This argument allows to pass a `list` of `"teal_data_module"` class of objects created using `teal_transform_module()` function.

The main benefit of `teal_transform_module()` is the ability to transform data before passing it
to the module. This feature allows to extend the regular behavior of existing modules by specifying custom data operations on data inside this module.
Expand Down
12 changes: 6 additions & 6 deletions vignettes/decorate-module-output.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ vignette: >

`teal` is a powerful `shiny`-based framework with built-in modules for interactive data analysis.
This document outlines the customization options available for modifying the output of `teal` modules.
You will learn how to use [`teal_transform_module`](https://insightsengineering.github.io/teal/latest-tag/reference/teal_transform_module.html) to modify and enhance the objects created by `teal::modules()`,
You will learn how to use `teal_transform_module()` to modify and enhance the objects created by `teal::modules()`,
enabling you to tailor the outputs to your specific requirements without rewriting the original module code.

## Decorators
Expand Down Expand Up @@ -48,12 +48,12 @@ created through `teal_transform_module`.

In below chapter we will present how to create the simplest static decorator with just a server part. Later, we will
present examples on more advanced usage, where decorators contain UI. You will also learn about a convenience
function that makes it easier to write decorators, called [`make_teal_transform_server`](https://insightsengineering.github.io/teal/latest-tagx/reference/make_teal_transform_server.html). The chapter ends with an
function that makes it easier to write decorators, called `make_teal_transform_server()`. The chapter ends with an
example module that utilizes decorators and a snippet that uses this module in `teal` application.

### Server

The simplest way to create a decorator is to use [`teal_transform_module`](https://insightsengineering.github.io/teal/latest-tag/reference/teal_transform_module.html) with only `server` argument provided (i.e. without UI part).
The simplest way to create a decorator is to use `teal_transform_module()` with only `server` argument provided (i.e. without UI part).
This approach adds functionality solely to the server code of the module.
In the following example, we assume that the module contains an object (of class `ggplot2`) named `plot`.
We modify the title and x-axis label of plot:
Expand All @@ -79,7 +79,7 @@ static_decorator <- teal_transform_module(

To simplify the repetitive elements of writing new decorators
(e.g., `function(id, data), moduleServer, reactive, within(data, ...)`),
you can use the [`make_teal_transform_server()`](https://insightsengineering.github.io/teal/latest-tag/reference/make_teal_transform_server.html) convenience function, which takes a `language` as input:
you can use the `make_teal_transform_server()` convenience function, which takes a `language` as input:

```{r}
static_decorator_lang <- teal_transform_module(
Expand All @@ -98,7 +98,7 @@ static_decorator_lang <- teal_transform_module(

To create a decorator with user interactivity, you can add (optional) UI part and use it in server accordingly (i.e. a typical `shiny` module).
In the example below, the x-axis title is set dynamically via a `textInput`, allowing users to specify their preferred label.
Note how the input parameters are passed to the [`within`](https://insightsengineering.github.io/teal/latest-tag/reference/teal_data_module.html) function using its `...` argument.
Note how the input parameters are passed to the `within()` function using its `...` argument.

```{r}
interactive_decorator <- teal_transform_module(
Expand Down Expand Up @@ -127,7 +127,7 @@ interactive_decorator <- teal_transform_module(
)
```

As in the earlier examples, [`make_teal_transform_server()`](https://insightsengineering.github.io/teal/latest-tag/reference/make_teal_transform_server.html) can simplify the creation of the server component.
As in the earlier examples, `make_teal_transform_server()` can simplify the creation of the server component.
This wrapper requires you to use `input` object names directly in the expression - note that we have `xlab(x_axis_table)` and not `my_title = input$x_axis_title` together with `xlab(my_title)`.

```{r}
Expand Down

0 comments on commit df437d2

Please sign in to comment.