| FazBrowse GitHub Viewer | Trending | | Home |
| Tools: [Download Repo ZIP] [Original HTTPS Page] |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -3508,9 +3508,14 @@ <h1 id="element">Element<a class="headerlink" href="#element" title="Permanent l | |||
| 3508 | 3508 | <div class="doc doc-contents first"> | |
| 3509 | 3509 | ||
| 3510 | 3510 | <p>Lightweight element descriptors for the virtual view tree.</p> | |
| 3511 | - <p>An <a class="autorefs autorefs-internal" title="<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code> <span class="doc doc-object-name doc-class-name">Element</span>" href="#pythonnative.element.Element"><code>Element</code></a> is an immutable description of a UI | ||
| 3512 | - node, analogous to a React element. It captures a type, a props dict, | ||
| 3513 | - and an ordered list of children without creating any native platform | ||
| 3511 | + <p>An <a class="autorefs autorefs-internal" title="<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code> <span class="doc doc-object-name doc-class-name">Element</span> | ||
| 3512 | + | ||
| 3513 | + | ||
| 3514 | + <span class="doc doc-labels"> | ||
| 3515 | + <small class="doc doc-label doc-label-dataclass"><code>dataclass</code></small> | ||
| 3516 | + </span>" href="#pythonnative.element.Element"><code>Element</code></a> is an immutable description of a UI | ||
| 3517 | + node, analogous to a React element. It captures a type, a read-only property snapshot, | ||
| 3518 | + and an immutable sequence of children without creating any native platform | ||
| 3514 | 3519 | objects. The reconciler consumes these trees to determine what native | |
| 3515 | 3520 | views must be created, updated, or removed.</p> | |
| 3516 | 3521 | <p>An element's <code>type</code> is one of three things:</p> | |
@@ -3581,7 +3586,12 @@ <h1 id="element">Element<a class="headerlink" href="#element" title="Permanent l | |||
| 3581 | 3586 | </td> | |
| 3582 | 3587 | </tr> | |
| 3583 | 3588 | <tr class="doc-section-item"> | |
| 3584 | - <td><code><a class="autorefs autorefs-internal" title="<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code> <span class="doc doc-object-name doc-class-name">Element</span> (<code>pythonnative.element.Element</code>)" href="#pythonnative.element.Element">Element</a></code></td> | ||
| 3589 | + <td><code><a class="autorefs autorefs-internal" title="<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code> <span class="doc doc-object-name doc-class-name">Element</span> | ||
| 3590 | + | ||
| 3591 | + | ||
| 3592 | + <span class="doc doc-labels"> | ||
| 3593 | + <small class="doc doc-label doc-label-dataclass"><code>dataclass</code></small> | ||
| 3594 | + </span> (<code>pythonnative.element.Element</code>)" href="#pythonnative.element.Element">Element</a></code></td> | ||
| 3585 | 3595 | <td> | |
| 3586 | 3596 | <div class="doc-md-description"> | |
| 3587 | 3597 | <p>Immutable description of a single UI node.</p> | |
@@ -3785,7 +3795,12 @@ <h2 id="pythonnative.element.Node" class="doc doc-heading"> | |||
| 3785 | 3795 | </span> | |
| 3786 | 3796 | ||
| 3787 | 3797 | <a href="#pythonnative.element.Node" class="headerlink" title="Permanent link">¶</a></h2> | |
| 3788 | - <div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">Node</span> <span class="o">=</span> <span class="n"><a class="autorefs autorefs-external" title="<code>typing.Union</code>" href="https://docs.python.org/3/library/typing.html#typing.Union">Union</a></span><span class="p">[</span><span class="n"><a class="autorefs autorefs-internal" title="<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code> <span class="doc doc-object-name doc-class-name">Element</span> (<code>pythonnative.element.Element</code>)" href="#pythonnative.element.Element">Element</a></span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="n"><a class="autorefs autorefs-external" href="https://docs.python.org/3/library/functions.html#bool">bool</a></span><span class="p">,</span> <span class="n"><a class="autorefs autorefs-external" title="<code>typing.Iterable</code>" href="https://docs.python.org/3/library/typing.html#typing.Iterable">Iterable</a></span><span class="p">[</span><span class="n"><a class="autorefs autorefs-external" title="<code>typing.Any</code>" href="https://docs.python.org/3/library/typing.html#typing.Any">Any</a></span><span class="p">]]</span> | ||
| 3798 | + <div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="n">Node</span> <span class="o">=</span> <span class="n"><a class="autorefs autorefs-external" title="<code>typing.Union</code>" href="https://docs.python.org/3/library/typing.html#typing.Union">Union</a></span><span class="p">[</span><span class="n"><a class="autorefs autorefs-internal" title="<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code> <span class="doc doc-object-name doc-class-name">Element</span> | ||
| 3799 | + | ||
| 3800 | + | ||
| 3801 | + <span class="doc doc-labels"> | ||
| 3802 | + <small class="doc doc-label doc-label-dataclass"><code>dataclass</code></small> | ||
| 3803 | + </span> (<code>pythonnative.element.Element</code>)" href="#pythonnative.element.Element">Element</a></span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="n"><a class="autorefs autorefs-external" href="https://docs.python.org/3/library/functions.html#bool">bool</a></span><span class="p">,</span> <span class="n"><a class="autorefs autorefs-external" title="<code>typing.Iterable</code>" href="https://docs.python.org/3/library/typing.html#typing.Iterable">Iterable</a></span><span class="p">[</span><span class="n"><a class="autorefs autorefs-external" title="<code>typing.Any</code>" href="https://docs.python.org/3/library/typing.html#typing.Any">Any</a></span><span class="p">]]</span> | ||
| 3789 | 3804 | </span></code></pre></div> | |
| 3790 | 3805 | ||
| 3791 | 3806 | <div class="doc doc-contents "> | |
@@ -3861,10 +3876,14 @@ <h2 id="pythonnative.element.Element" class="doc doc-heading"> | |||
| 3861 | 3876 | <code class="doc-symbol doc-symbol-heading doc-symbol-class"></code> <span class="doc doc-object-name doc-class-name">Element</span> | |
| 3862 | 3877 | ||
| 3863 | 3878 | ||
| 3879 | + <span class="doc doc-labels"> | ||
| 3880 | + <small class="doc doc-label doc-label-dataclass"><code>dataclass</code></small> | ||
| 3881 | + </span> | ||
| 3882 | + | ||
| 3864 | 3883 | <a href="#pythonnative.element.Element" class="headerlink" title="Permanent link">¶</a></h2> | |
| 3865 | 3884 | <div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nf">Element</span><span class="p">(</span> | |
| 3866 | 3885 | </span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a> <span class="n">type_</span><span class="p">:</span> <span class="n"><a class="autorefs autorefs-external" title="<code>typing.Any</code>" href="https://docs.python.org/3/library/typing.html#typing.Any">Any</a></span><span class="p">,</span> | |
| 3867 | - </span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a> <span class="n">props</span><span class="p">:</span> <span class="n"><a class="autorefs autorefs-external" title="<code>typing.Optional</code>" href="https://docs.python.org/3/library/typing.html#typing.Optional">Optional</a></span><span class="p">[</span><span class="n"><a class="autorefs autorefs-external" title="<code>typing.Dict</code>" href="https://docs.python.org/3/library/typing.html#typing.Dict">Dict</a></span><span class="p">[</span><span class="n"><a class="autorefs autorefs-external" href="https://docs.python.org/3/library/stdtypes.html#str">str</a></span><span class="p">,</span> <span class="n"><a class="autorefs autorefs-external" title="<code>typing.Any</code>" href="https://docs.python.org/3/library/typing.html#typing.Any">Any</a></span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> | ||
| 3886 | + </span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a> <span class="n">props</span><span class="p">:</span> <span class="n"><a class="autorefs autorefs-external" title="<code>typing.Optional</code>" href="https://docs.python.org/3/library/typing.html#typing.Optional">Optional</a></span><span class="p">[</span><span class="n"><a class="autorefs autorefs-external" title="<code>typing.Mapping</code>" href="https://docs.python.org/3/library/typing.html#typing.Mapping">Mapping</a></span><span class="p">[</span><span class="n"><a class="autorefs autorefs-external" href="https://docs.python.org/3/library/stdtypes.html#str">str</a></span><span class="p">,</span> <span class="n"><a class="autorefs autorefs-external" title="<code>typing.Any</code>" href="https://docs.python.org/3/library/typing.html#typing.Any">Any</a></span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> | ||
| 3868 | 3887 | </span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a> <span class="n">children</span><span class="p">:</span> <span class="n"><a class="autorefs autorefs-external" title="<code>typing.Optional</code>" href="https://docs.python.org/3/library/typing.html#typing.Optional">Optional</a></span><span class="p">[</span><span class="n"><a class="autorefs autorefs-external" title="<code>typing.Iterable</code>" href="https://docs.python.org/3/library/typing.html#typing.Iterable">Iterable</a></span><span class="p">[</span><span class="n"><a class="autorefs autorefs-external" title="<code>typing.Any</code>" href="https://docs.python.org/3/library/typing.html#typing.Any">Any</a></span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> | |
| 3869 | 3888 | </span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a> <span class="n">key</span><span class="p">:</span> <span class="n"><a class="autorefs autorefs-external" title="<code>typing.Optional</code>" href="https://docs.python.org/3/library/typing.html#typing.Optional">Optional</a></span><span class="p">[</span><span class="n"><a class="autorefs autorefs-external" href="https://docs.python.org/3/library/stdtypes.html#str">str</a></span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> | |
| 3870 | 3889 | </span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="p">)</span> | |
@@ -3896,6 +3915,7 @@ <h2 id="pythonnative.element.Element" class="doc doc-heading"> | |||
| 3896 | 3915 | <tr class="doc-section-item"> | |
| 3897 | 3916 | <td><code><span title="pythonnative.element.Element.type">type</span></code></td> | |
| 3898 | 3917 | <td> | |
| 3918 | + <code><a class="autorefs autorefs-external" title="<code>typing.Any</code>" href="https://docs.python.org/3/library/typing.html#typing.Any">Any</a></code> | ||
| 3899 | 3919 | </td> | |
| 3900 | 3920 | <td> | |
| 3901 | 3921 | <div class="doc-md-description"> | |
@@ -3906,23 +3926,23 @@ <h2 id="pythonnative.element.Element" class="doc doc-heading"> | |||
| 3906 | 3926 | <tr class="doc-section-item"> | |
| 3907 | 3927 | <td><code><span title="pythonnative.element.Element.props">props</span></code></td> | |
| 3908 | 3928 | <td> | |
| 3909 | - <code><a class="autorefs autorefs-external" title="<code>typing.Dict</code>" href="https://docs.python.org/3/library/typing.html#typing.Dict">Dict</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="<code>typing.Any</code>" href="https://docs.python.org/3/library/typing.html#typing.Any">Any</a>]</code> | ||
| 3929 | + <code><a class="autorefs autorefs-external" title="<code>typing.Mapping</code>" href="https://docs.python.org/3/library/typing.html#typing.Mapping">Mapping</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3/library/stdtypes.html#str">str</a>, <a class="autorefs autorefs-external" title="<code>typing.Any</code>" href="https://docs.python.org/3/library/typing.html#typing.Any">Any</a>]</code> | ||
| 3910 | 3930 | </td> | |
| 3911 | 3931 | <td> | |
| 3912 | 3932 | <div class="doc-md-description"> | |
| 3913 | - <p>Dict of properties passed to the native handler or the | ||
| 3933 | + <p>Read-only snapshot of properties passed to the native handler or the | ||
| 3914 | 3934 | component function.</p> | |
| 3915 | 3935 | </div> | |
| 3916 | 3936 | </td> | |
| 3917 | 3937 | </tr> | |
| 3918 | 3938 | <tr class="doc-section-item"> | |
| 3919 | 3939 | <td><code><span title="pythonnative.element.Element.children">children</span></code></td> | |
| 3920 | 3940 | <td> | |
| 3921 | - <code><a class="autorefs autorefs-external" title="<code>typing.List</code>" href="https://docs.python.org/3/library/typing.html#typing.List">List</a>[<a class="autorefs autorefs-external" title="<code>typing.Any</code>" href="https://docs.python.org/3/library/typing.html#typing.Any">Any</a>]</code> | ||
| 3941 | + <code><a class="autorefs autorefs-external" href="https://docs.python.org/3/library/stdtypes.html#tuple">tuple</a>[<a class="autorefs autorefs-external" title="<code>typing.Any</code>" href="https://docs.python.org/3/library/typing.html#typing.Any">Any</a>, ...]</code> | ||
| 3922 | 3942 | </td> | |
| 3923 | 3943 | <td> | |
| 3924 | 3944 | <div class="doc-md-description"> | |
| 3925 | - <p>Ordered list of child nodes. <code>None</code> and <code>False</code> | ||
| 3945 | + <p>Immutable tuple of child nodes. <code>None</code> and <code>False</code> | ||
| 3926 | 3946 | entries are permitted and dropped during reconciliation, so | |
| 3927 | 3947 | conditional children (<code>cond and Text(...)</code>) need no special | |
| 3928 | 3948 | casing. Components receive these as their <code>*children</code>.</p> | |
@@ -3932,6 +3952,7 @@ <h2 id="pythonnative.element.Element" class="doc doc-heading"> | |||
| 3932 | 3952 | <tr class="doc-section-item"> | |
| 3933 | 3953 | <td><code><span title="pythonnative.element.Element.key">key</span></code></td> | |
| 3934 | 3954 | <td> | |
| 3955 | + <code><a class="autorefs autorefs-external" title="<code>typing.Optional</code>" href="https://docs.python.org/3/library/typing.html#typing.Optional">Optional</a>[<a class="autorefs autorefs-external" href="https://docs.python.org/3/library/stdtypes.html#str">str</a>]</code> | ||
| 3935 | 3956 | </td> | |
| 3936 | 3957 | <td> | |
| 3937 | 3958 | <div class="doc-md-description"> | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -2439,6 +2439,17 @@ | |||
| 2439 | 2439 | </ul> | |
| 2440 | 2440 | </nav> | |
| 2441 | 2441 | ||
| 2442 | + </li> | ||
| 2443 | + | ||
| 2444 | + <li class="md-nav__item"> | ||
| 2445 | + <a href="#pythonnative.hooks.provider_environment" class="md-nav__link"> | ||
| 2446 | + <span class="md-ellipsis"> | ||
| 2447 | + | ||
| 2448 | + <code class="doc-symbol doc-symbol-toc doc-symbol-function"></code> provider_environment | ||
| 2449 | + | ||
| 2450 | + </span> | ||
| 2451 | + </a> | ||
| 2452 | + | ||
| 2442 | 2453 | </li> | |
| 2443 | 2454 | ||
| 2444 | 2455 | <li class="md-nav__item"> | |
@@ -4246,6 +4257,17 @@ | |||
| 4246 | 4257 | </ul> | |
| 4247 | 4258 | </nav> | |
| 4248 | 4259 | ||
| 4260 | + </li> | ||
| 4261 | + | ||
| 4262 | + <li class="md-nav__item"> | ||
| 4263 | + <a href="#pythonnative.hooks.provider_environment" class="md-nav__link"> | ||
| 4264 | + <span class="md-ellipsis"> | ||
| 4265 | + | ||
| 4266 | + <code class="doc-symbol doc-symbol-toc doc-symbol-function"></code> provider_environment | ||
| 4267 | + | ||
| 4268 | + </span> | ||
| 4269 | + </a> | ||
| 4270 | + | ||
| 4249 | 4271 | </li> | |
| 4250 | 4272 | ||
| 4251 | 4273 | <li class="md-nav__item"> | |
@@ -6327,7 +6349,12 @@ <h3 id="pythonnative.hooks.Context.Provider" class="doc doc-heading"> | |||
| 6327 | 6349 | <span class="doc doc-labels"> | |
| 6328 | 6350 | <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> | |
| 6329 | 6351 | </span> (<code>pythonnative.element.Node</code>)" href="../element/#pythonnative.element.Node">Node</a></span><span class="p">,</span> <span class="n">key</span><span class="p">:</span> <span class="n"><a class="autorefs autorefs-external" title="<code>typing.Optional</code>" href="https://docs.python.org/3/library/typing.html#typing.Optional">Optional</a></span><span class="p">[</span><span class="n"><a class="autorefs autorefs-external" href="https://docs.python.org/3/library/stdtypes.html#str">str</a></span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span> | |
| 6330 | - </span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="p">)</span> <span class="o">-></span> <span class="n"><a class="autorefs autorefs-internal" title="<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code> <span class="doc doc-object-name doc-class-name">Element</span> (<code>pythonnative.element.Element</code>)" href="../element/#pythonnative.element.Element">Element</a></span> | ||
| 6352 | + </span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="p">)</span> <span class="o">-></span> <span class="n"><a class="autorefs autorefs-internal" title="<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code> <span class="doc doc-object-name doc-class-name">Element</span> | ||
| 6353 | + | ||
| 6354 | + | ||
| 6355 | + <span class="doc doc-labels"> | ||
| 6356 | + <small class="doc doc-label doc-label-dataclass"><code>dataclass</code></small> | ||
| 6357 | + </span> (<code>pythonnative.element.Element</code>)" href="../element/#pythonnative.element.Element">Element</a></span> | ||
| 6331 | 6358 | </span></code></pre></div> | |
| 6332 | 6359 | ||
| 6333 | 6360 | <div class="doc doc-contents "> | |
@@ -6454,6 +6481,26 @@ <h3 id="pythonnative.hooks.Context.current" class="doc doc-heading"> | |||
| 6454 | 6481 | <div class="doc doc-object doc-function"> | |
| 6455 | 6482 | ||
| 6456 | 6483 | ||
| 6484 | + <h2 id="pythonnative.hooks.provider_environment" class="doc doc-heading"> | ||
| 6485 | + <code class="doc-symbol doc-symbol-heading doc-symbol-function"></code> <span class="doc doc-object-name doc-function-name">provider_environment</span> | ||
| 6486 | + | ||
| 6487 | + | ||
| 6488 | + <a href="#pythonnative.hooks.provider_environment" class="headerlink" title="Permanent link">¶</a></h2> | ||
| 6489 | + <div class="language-python doc-signature highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nf">provider_environment</span><span class="p">()</span> <span class="o">-></span> <span class="n"><a class="autorefs autorefs-external" title="<code>typing.Dict</code>" href="https://docs.python.org/3/library/typing.html#typing.Dict">Dict</a></span><span class="p">[</span><span class="n"><a class="autorefs autorefs-external" href="https://docs.python.org/3/library/functions.html#int">int</a></span><span class="p">,</span> <span class="n"><a class="autorefs autorefs-external" title="<code>typing.Any</code>" href="https://docs.python.org/3/library/typing.html#typing.Any">Any</a></span><span class="p">]</span> | ||
| 6490 | + </span></code></pre></div> | ||
| 6491 | + | ||
| 6492 | + <div class="doc doc-contents "> | ||
| 6493 | + | ||
| 6494 | + <p>Return the current immutable provider environment for render identity.</p> | ||
| 6495 | + | ||
| 6496 | + | ||
| 6497 | + </div> | ||
| 6498 | + | ||
| 6499 | + </div> | ||
| 6500 | + | ||
| 6501 | + <div class="doc doc-object doc-function"> | ||
| 6502 | + | ||
| 6503 | + | ||
| 6457 | 6504 | <h2 id="pythonnative.hooks.current_hook_state" class="doc doc-heading"> | |
| 6458 | 6505 | <code class="doc-symbol doc-symbol-heading doc-symbol-function"></code> <span class="doc doc-object-name doc-function-name">current_hook_state</span> | |
| 6459 | 6506 | ||
| Back | FazBrowse Home | New Git URL |
0 commit comments