Merge pull request #236 from bensheldon/refresh-attributes

Document `refresh` action attributes `method=` and `scroll=`

Author: packagethief

_source/handbook/03_page_refreshes.md

@@ -66,6 +66,14 @@ There is a new [turbo stream action](/handbook/streams.html) called `refresh` th
 <turbo-stream action="refresh"></turbo-stream>
 ```
 
+Refresh behavior can be specified using the `method` and `scroll` attributes:
+
+```html
+<turbo-stream action="refresh" method="morph" scroll="preserve"></turbo-stream>
+```
+
+The `method` attribute can be `morph` or `replace`, and the `scroll` attribute can be `preserve` or `reset`.
+
 Server-side frameworks can leverage these streams to offer a simple but powerful broadcasting model: the server broadcasts a single general signal, and pages smoothly refresh with morphing. 
 
 You can see how the  [`turbo-rails`](https://github.com/hotwired/turbo-rails) gem does it for Rails:

_source/reference/streams.md

@@ -113,15 +113,17 @@ Inserts the content within the template tag after the element designated by the
 
 ### Refresh
 
-Initiates a [Page Refresh](/handbook/page_refreshes) to render new content with
-morphing.
+Initiates a [Page Refresh](/handbook/page_refreshes) to render new content.
 
 ```html
 <!-- without `[request-id]` -->
 <turbo-stream action="refresh"></turbo-stream>
 
 <!-- debounced with `[request-id]` -->
 <turbo-stream action="refresh" request-id="abcd-1234"></turbo-stream>
+
+<!-- refresh behavior with `[method]` and `[scroll]` -->
+<turbo-stream action="refresh" method="morph" scroll="preserve"></turbo-stream>
 ```
 
 ## Targeting Multiple Elements