Skip to content

Commit d4e37d8

Browse files
authored
docs: Update multi-swap README.md to clarify the use of multi-swap and OOB swaps (#148)
1 parent 618e8e9 commit d4e37d8

File tree

1 file changed

+2
-3
lines changed

1 file changed

+2
-3
lines changed

src/multi-swap/README.md

+2-3
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
11

2-
This extension allows you to swap multiple elements marked with the `id` attribute from the HTML response. You can also choose for each element which [swap method](https://htmx.org/docs#swapping) should be used.
2+
This extension allows you to swap multiple elements marked with the `id` attribute from the HTML response. You can also choose for each element which [swap method](https://htmx.org/docs#swapping) should be used. Multi-swap is a very powerful tool in conjunction with `hx-boost` and `preload` extension.
33

4-
Multi-swap can help in cases where OOB ([Out of Band Swaps](https://htmx.org/docs#oob_swaps)) is not enough for you. OOB requires HTML tags marked with `hx-swap-oob` attributes to be at the TOP level of HTML, which significantly limited its use. With OOB, it's impossible to swap multiple elements arbitrarily placed and nested in the DOM tree.
4+
It should be noted that using OOB swaps ([Out of Band Swaps](https://htmx.org/docs#oob_swaps)) should be enough for most use cases, since OOB swaps by now can handle nested elements anywhere in the DOM and with a specified swap method. Thus it's recommended to be familiar with OOB swaps to make an informed decision on whether this extension is required anymore.
55

6-
It is a very powerful tool in conjunction with `hx-boost` and `preload` extension.
76

87
## Install
98

0 commit comments

Comments
 (0)