update docs for new version of package

Joseph Damiba · Joseph Damiba · commit fe712e2517ba · 2020-05-20T14:17:28.000-04:00
diff --git a/r/2015-11-19-shapes.Rmd b/r/2015-11-19-shapes.Rmd
@@ -96,5 +96,62 @@ fig <- layout(fig, title = 'Highlighting Regions with Circles',
 fig
 ```
 
+### Drawing Shapes on Cartesian Plots
+
+You can create layout shapes programatically, but you can also draw shapes manually by setting the `dragmode` to one of the shape-drawing modes: `drawline`,`drawopenpath`, `drawclosedpath`, `drawcircle`, or `drawrect`. If you need to switch between different shape-drawing or other dragmodes (panning, selecting, etc.), modebar buttons can be added in the `config` of your figure to select the dragmode. 
+
+If you switch to a different dragmode such as pan or zoom, you will need to select the drawing tool in the modebar to go back to shape drawing.
+
+This shape-drawing feature is particularly interesting for annotating graphs, in particular [image traces](https://plotly.com/r/displaying-images/). 
+
+Once you have drawn shapes, you can select and modify an existing shape by clicking on its boundary (note the arrow pointer). Its fillcolor turns to pink to highlight the activated shape and then you can
+
+- drag and resize it for lines, rectangles and circles/ellipses
+- drag and move individual vertices for closed paths
+- move individual vertices for open paths.
+
+An activated shape is deleted by cliking on the `eraseshape` button.
+
+Drawing or modifying a shape triggers a `relayout` event, which [can be captured by a callback inside a Dash For R application](https://dash.plotly.com/interactive-graphing).
+
+```{r}
+library(plotly)
+
+df <- diamonds[sample(nrow(diamonds), 1000), ]
+
+fig <- plot_ly(df, x = ~carat, y = ~price, text = ~paste("Clarity: ", clarity),
+             mode = "markers", color = ~carat, size = ~carat)
+
+fig <- layout(fig, dragmode="drawrect", xaxis = list(title = 'Click and drag inside the figure to draw a rectangle or select another shape in the modebar'))
+
+fig <- fig %>%
+  config(modeBarButtonsToAdd = list("drawine", "drawopenpath", "drawclosedpath", "drawcircle", "drawrect", "eraseshape" ) )
+
+fig
+
+```
+
+### Style of user-drawn shapes
+
+The layout `newshape` attribute controls the visual appearance of new shapes drawn by the user. `newshape` attributes have the same names as layout shapes.
+
+Note on shape opacity: having a new shape's opacity > 0.5 makes it possible to activate a shape by clicking inside the shape (for opacity <= 0.5 you have to click on the border of the shape), but you cannot start a new shape within an existing shape (which is possible for an opacity <= 0.5).
+
+```{r}
+library(plotly)
+
+df <- diamonds[sample(nrow(diamonds), 1000), ]
+
+fig <- plot_ly(df, x = ~carat, y = ~price, text = ~paste("Clarity: ", clarity),
+             mode = "markers", color = ~carat, size = ~carat)
+
+fig <- layout(fig, dragmode="drawrect", newshape=list(fillcolor="yellow", opacity=0.5), xaxis = list(title = 'Click and drag inside the figure to draw a rectangle or select another shape in the modebar'))
+
+fig <- fig %>%
+  config(modeBarButtonsToAdd = list("drawine", "drawopenpath", "drawclosedpath", "drawcircle", "drawrect", "eraseshape" ) )
+
+fig
+
+```
 ### Reference
 Check out our <b>[reference page](https://plotly.com/r/reference/#layout-shapes)</b> for more information on using shapes!
diff --git a/r/2018-01-29-hover-text-and-formatting.Rmd b/r/2018-01-29-hover-text-and-formatting.Rmd
@@ -35,6 +35,30 @@ fig <- fig %>%
 fig
 ```
 
+#### Unified hovermode
+
+If you set the `hovermode` attribute of your figure's layout to `x unified` or `y unified`), a single hover label will appear, describing one point per trace, for points at the same x (or y) value as the cursor. 
+
+If multiple points in a given trace exist at the same coordinate, only one will get an entry in the hover label. In the line plot below we have forced markers to appear, to make it clearer what can be hovered over:
+
+```{r}
+library(plotly)
+
+trace_0 <- rnorm(100, mean = 5)
+trace_1 <- rnorm(100, mean = 0)
+trace_2 <- rnorm(100, mean = -5)
+x <- c(1:100)
+
+data <- data.frame(x, trace_0, trace_1, trace_2)
+
+fig <- plot_ly(data, x = ~x, y = ~trace_0, name = 'trace 0', type = 'scatter', mode = 'lines') 
+fig <- fig %>% add_trace(y = ~trace_1, name = 'trace 1', mode = 'lines+markers') 
+fig <- fig %>% add_trace(y = ~trace_2, name = 'trace 2', mode = 'markers')
+fig <- fig %>%
+  layout(hovermode = "x unified")
+fig
+```
+
 #### Format Hover Text 
 
 ```{r}
