Undocumented Features Found During v4 Upgrade Guide¶
These features exist in v4 but may need dedicated documentation pages or sections:
High Priority¶
wire:intersectdirective- Full API with all modifiers (
.once,.half,.full,.threshold.X,.margin.Xpx) - Usage patterns and examples
- Comparison with Alpine's
x-intersect -
Suggested location: New docs page or section in wire-* directives
-
data-loadingattribute - Automatic addition to elements that trigger requests
- Styling examples and use cases
-
Suggested location: Section in wire-loading.md or actions.md
-
wire:preserve-scrollmodifier - How it works and when to use it
- Examples of preventing layout jumps
-
Suggested location: Actions.md or new wire-preserve-scroll.md
-
$errorsmagic property in JavaScript - Full API (
.has(),.first(),.all(), etc.) - Integration with Alpine
-
Suggested location: Forms.md or validation.md
-
$island()magic action - Calling island renders from templates
- Passing modes and options
-
Suggested location: Islands.md (add a section)
-
$wire.$intercept()magic - Full API and callback structure
- Use cases and examples
-
Suggested location: JavaScript.md (interceptors section)
-
JavaScript modules in view-based components
- How
<script>tags work without@scriptwrapper - Automatic
$wirebinding asthis - Module caching and performance benefits
-
Suggested location: Components.md or JavaScript.md
-
CSP-safe mode restrictions
- Complete list of what expressions are not allowed
- Migration guide for existing apps
- Workarounds and alternatives
- Suggested location: New security.md section or dedicated csp.md page
Medium Priority¶
- Slots and attribute forwarding
- Complete guide on using slots in components
{{ $attributes }}usage and examples-
Suggested location: Components.md
-
Smart wire:key automatic generation
- How it works behind the scenes
- When you still need manual wire:key
- Suggested location: Nesting.md or components.md
-
Component namespaces
- How to use namespaced components
- Examples:
<livewire:pages::dashboard /> - Suggested location: Components.md
-
Fragment morph hooks
Livewire.hook('fragment.morph', ...)andfragment.morphed- When to use vs regular morph hooks
- Suggested location: JavaScript.md (hooks section)
Existing Docs to Update¶
- lazy.md - Already updated with defer and bundle features
- actions.md - Already updated with async actions
- islands.md - Already updated with renderIsland/streamIsland
- components.md - Already updated with convert command
- wire-sort.md - Already created and documented
Notes¶
- Most of these features exist in the codebase but aren't mentioned in user-facing docs
- Some may be intentionally undocumented for now (beta features)
- Priority is based on likely user impact and common use cases