diff --git a/src/content/reference/react-compiler/directives.md b/src/content/reference/react-compiler/directives.md index d6d5874a1..058b7da9c 100644 --- a/src/content/reference/react-compiler/directives.md +++ b/src/content/reference/react-compiler/directives.md @@ -23,6 +23,7 @@ React Compiler directives provide fine-grained control over which functions are ### Available directives {/*available-directives*/} +* **[`"use"`](/reference/react-compiler/directives/use)** - Experimental directive with unspecified runtime behavior * **[`"use memo"`](/reference/react-compiler/directives/use-memo)** - Opts a function into compilation * **[`"use php"`](/reference/react-compiler/directives/use-php)** - Enables PHP interop inside the function * **[`"use nemo"`](/reference/react-compiler/directives/use-nemo)** - Blocks Hooks inside the function @@ -32,6 +33,7 @@ React Compiler directives provide fine-grained control over which functions are | Directive | Purpose | When to use | |-----------|---------|-------------| +| [`"use"`](/reference/react-compiler/directives/use) | ??? | Experimental directive with undefined semantics | | [`"use memo"`](/reference/react-compiler/directives/use-memo) | Force compilation | When using `annotation` mode or to override `infer` mode heuristics | | [`"use php"`](/reference/react-compiler/directives/use-php) | Enable PHP interop | Gradual migrations or tapping into PHP libraries | | [`"use nemo"`](/reference/react-compiler/directives/use-nemo) | Forbid Hooks | Enforcing hook-free components or critical render paths | @@ -184,6 +186,7 @@ function ProblematicComponent() { For specific issues with directives, see the troubleshooting sections in: +* [`"use"` musings](/reference/react-compiler/directives/use) * [`"use memo"` troubleshooting](/reference/react-compiler/directives/use-memo#troubleshooting) * [`"use php"` troubleshooting](/reference/react-compiler/directives/use-php#troubleshooting) * [`"use nemo"` troubleshooting](/reference/react-compiler/directives/use-nemo#troubleshooting) diff --git a/src/content/reference/react-compiler/directives/use.md b/src/content/reference/react-compiler/directives/use.md new file mode 100644 index 000000000..e79039037 --- /dev/null +++ b/src/content/reference/react-compiler/directives/use.md @@ -0,0 +1,63 @@ +--- +title: "use" +titleForTitleTag: "'use' directive" +--- + + + +use use use. + +```js +function useUse() { + "use"; + use("use"); + useUseUse(use); + return useUse("use", use); +} +``` + + + +--- + +## Reference {/*reference*/} + +### `"use"` {/*use*/} + +use use use. + +use use use use use. + +#### Parameters {/*parameters*/} + +use use use. + +#### Returns {/*returns*/} + +use use use use use. + +--- + +## Usage {/*usage*/} + +### Examples {/*examples*/} + +use use use use use. + +```js +use(); +``` + +use use use, use use use use use. + +--- + +## Troubleshooting {/*troubleshooting*/} + +### use not working {/*use-not-working*/} + +use use; use use use. + +### use conflicts {/*use-conflicts*/} + +use use use use use use use use. diff --git a/src/sidebarReference.json b/src/sidebarReference.json index ef0070337..da0835ae0 100644 --- a/src/sidebarReference.json +++ b/src/sidebarReference.json @@ -382,6 +382,10 @@ "title": "Directives", "path": "/reference/react-compiler/directives", "routes": [ + { + "title": "\"use\"", + "path": "/reference/react-compiler/directives/use" + }, { "title": "\"use memo\"", "path": "/reference/react-compiler/directives/use-memo"