Skip to content

[solid v2] DOM docs: improve default to properties, add xmlns requirement for partials #2645

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
titoBouzout wants to merge 4 commits into
base: next
Choose a base branch
from
+4 −5
Open

[solid v2] DOM docs: improve default to properties, add xmlns requirement for partials #2645

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
ac8845c
improve default to properties DOM docs, add xmlns requirement for par…
titoBouzout Mar 23, 2026
0b7e968
remove unrelated entries from table
titoBouzout Mar 23, 2026
d5ae8d3
clarify that xmlns is added automatically when possible
titoBouzout Mar 24, 2026
40be8a7
make more clear we default to atrributes now
titoBouzout Mar 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 4 additions & 5 deletions documentation/solid-2.0/07-dom.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,10 @@ DOM behavior in Solid 2.0 follows HTML standards by default: attributes over pro
- **Attributes over properties:** Prefer setting attributes rather than properties in almost all cases. Aligns with web components and SSR.
- **Lowercasing:** Use HTML lowercase for built-in attribute names (no camelCase for attributes). Exceptions:
- **Event handlers** remain camelCase (e.g. `onClick`) to keep the `on` modifier clear.
- **Default attributes** such as `value`, `selected`, `checked`, `muted` continue to be handled as props where that avoids confusion.
- **Default to attributes** But attributes such as `input.value`, `input.checked`, `select.value`, `option.value`, `option.selected`, `video/audio.muted` continue to be handled as props where that avoids confusion. However, attribute/property can still be used as `<input value="default value" prop:value={dynamic()}/>`
- **Namespaces:** `attr:` and `bool:` namespaces are removed; the single standard behavior makes the model consistent.

- **XML Namespaces:** `svg` and `math` work as expected, however when using XML partials, an `xmlns` attribute is required for the browser to create the elements with the correct namespace. Solid adds these automatically to the tags that can recognize as SVG/MathML. For example an `a` tag returned from a partial to be used in XML need `xmlns` added by the user.

### Enhanced class prop

- **`classList` is removed;** its behavior is merged into `class`.
Expand Down Expand Up @@ -117,8 +118,6 @@ Used as:
| `oncapture:` | Removed (replacement pattern TBD / use native event options where applicable) |
| `attr:` / `bool:` namespaces | Single attribute/property model above |
| `use:` directives | Use `ref` callbacks / directive factories (`ref={directive(opts)}`); arrays compose (`ref={[a, b]}`) |
| `createMutable` (from Solid primitives) | Moved to / available from `@solidjs/signals` or primitives layer |
| `scheduler` / `createDeferred` | Moved to primitives; use primitives API |

`@solidjs/legacy` can provide compatibility for deprecated DOM APIs where feasible.

Expand All @@ -129,4 +128,4 @@ Used as:

## Open questions

- Exact list of "default" props that stay as props (`value`, `selected`, `checked`, `muted`, …).
- Exact list of "default" props that stay as props (`input.value`, `input.checked`, `select.value`, `option.value`, `option.selected`, `video/audio.muted`, …). Generally, stateful DOM properties should be considered on this list.
Loading