NEWS and an example for initWidth

Author: glin

NEWS.md

@@ -58,6 +58,7 @@
     result
   })
   ```
+* `colDef()` gains an `initWidth` argument to set a column's initial width in pixels while keeping the column resizable. Unlike `width`, which sets a fixed width and disables resizing, `initWidth` only sets the starting width, so the column can still be resized within its `minWidth` and `maxWidth`. (@nteetor, [#223](https://github.com/glin/reactable/issues/223), [#374](https://github.com/glin/reactable/issues/374))
 
 ## Minor improvements and bug fixes
 

vignettes/examples.Rmd

@@ -1350,6 +1350,7 @@ You can control the width of a column using the following arguments in `colDef()
 
 - `minWidth` - minimum width of the column in pixels (defaults to `100`)
 - `maxWidth` - maximum width of the column in pixels
+- `initWidth` - initial width of the column in pixels, which can still be resized (unlike `width`)
 - `width` - fixed width of the column in pixels (overrides `minWidth` and `maxWidth`)
 
 When columns stretch, `minWidth` also controls the ratio at which columns grow.
@@ -1684,6 +1685,26 @@ You can make columns resizable by setting `resizable` to `TRUE`:
 reactable(MASS::Cars93[1:5, ], resizable = TRUE, wrap = FALSE, bordered = TRUE)
 ```
 
+To give a column a custom starting width while keeping it resizable, set `initWidth` in `colDef()`.
+Unlike `width`, which fixes the column width and disables resizing, `initWidth` only sets the initial
+width, so the column can still be resized within its `minWidth` and `maxWidth`:
+
+::: {.callout}
+New in v0.4.5.9000
+:::
+
+```{r}
+reactable(
+  MASS::Cars93[1:5, ],
+  resizable = TRUE,
+  wrap = FALSE,
+  bordered = TRUE,
+  columns = list(
+    Manufacturer = colDef(initWidth = 250)  # starts at 250px, still resizable
+  )
+)
+```
+
 
 ## Sticky Columns