@polight/lego
Version:
Tiny Web Components lib for future-proof HTML mentors
11 lines (9 loc) β’ 13.1 kB
HTML
<html lang="en-US"> <head> <meta charset="UTF-8"> <meta http-equiv="X-UA-Compatible" content="IE=Edge"> <link rel="stylesheet" href="/assets/css/just-the-docs-default.css"> <script src="/assets/js/vendor/lunr.min.js"></script> <script src="/assets/js/just-the-docs.js"></script> <meta name="viewport" content="width=device-width, initial-scale=1"> <!-- Begin Jekyll SEO tag v2.8.0 --> <title>Reactive Web-Components to Update HTML | π Lego Web-Components</title> <meta name="generator" content="Jekyll v4.2.2" /> <meta property="og:title" content="Reactive Web-Components to Update HTML" /> <meta property="og:locale" content="en_US" /> <meta name="description" content="Reactive Properties The state is where the reactiveness takes place. declare a state object in the init() function with default values: const state = { user: { firstname: 'John', lastname: 'Doe' }, status: "Happy π" } const title = "This title is non-reactive" Displaying a state value is as simple as writing ${state.theValue} in your HTML. When you need your component to react, call the render() method with your updated state: function updateStatus(event) { render({ status: "Laughing π" }) } This will update your component only where needed. When state is just mutated, the changed(changedProps) is called. This changed() method is called before (re-)rendering." /> <meta property="og:description" content="Reactive Properties The state is where the reactiveness takes place. declare a state object in the init() function with default values: const state = { user: { firstname: 'John', lastname: 'Doe' }, status: "Happy π" } const title = "This title is non-reactive" Displaying a state value is as simple as writing ${state.theValue} in your HTML. When you need your component to react, call the render() method with your updated state: function updateStatus(event) { render({ status: "Laughing π" }) } This will update your component only where needed. When state is just mutated, the changed(changedProps) is called. This changed() method is called before (re-)rendering." /> <link rel="canonical" href="http://localhost:4000/v2/usage-web-components/reactive/" /> <meta property="og:url" content="http://localhost:4000/v2/usage-web-components/reactive/" /> <meta property="og:site_name" content="π Lego Web-Components" /> <meta property="og:type" content="article" /> <meta property="article:published_time" content="2023-03-03T20:30:45+01:00" /> <meta name="twitter:card" content="summary" /> <meta property="twitter:title" content="Reactive Web-Components to Update HTML" /> <script type="application/ld+json"> {"@context":"https://schema.org","@type":"BlogPosting","dateModified":"2023-03-03T20:30:45+01:00","datePublished":"2023-03-03T20:30:45+01:00","description":"Reactive Properties The state is where the reactiveness takes place. declare a state object in the init() function with default values: const state = { user: { firstname: 'John', lastname: 'Doe' }, status: "Happy π" } const title = "This title is non-reactive" Displaying a state value is as simple as writing ${state.theValue} in your HTML. When you need your component to react, call the render() method with your updated state: function updateStatus(event) { render({ status: "Laughing π" }) } This will update your component only where needed. When state is just mutated, the changed(changedProps) is called. This changed() method is called before (re-)rendering.","headline":"Reactive Web-Components to Update HTML","mainEntityOfPage":{"@type":"WebPage","@id":"http://localhost:4000/v2/usage-web-components/reactive/"},"url":"http://localhost:4000/v2/usage-web-components/reactive/"}</script> <!-- End Jekyll SEO tag --> </head> <link rel="stylesheet" href="/assets/css/style.css" /> <body> <svg xmlns="http://www.w3.org/2000/svg" style="display: none;"> <symbol id="svg-link" viewBox="0 0 24 24"> <title>Link</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"> <path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path> </svg> </symbol> <symbol id="svg-search" viewBox="0 0 24 24"> <title>Search</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-search"> <circle cx="11" cy="11" r="8"></circle><line x1="21" y1="21" x2="16.65" y2="16.65"></line> </svg> </symbol> <symbol id="svg-menu" viewBox="0 0 24 24"> <title>Menu</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-menu"> <line x1="3" y1="12" x2="21" y2="12"></line><line x1="3" y1="6" x2="21" y2="6"></line><line x1="3" y1="18" x2="21" y2="18"></line> </svg> </symbol> <symbol id="svg-arrow-right" viewBox="0 0 24 24"> <title>Expand</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-chevron-right"> <polyline points="9 18 15 12 9 6"></polyline> </svg> </symbol> <symbol id="svg-doc" viewBox="0 0 24 24"> <title>Document</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-file"> <path d="M13 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V9z"></path><polyline points="13 2 13 9 20 9"></polyline> </svg> </symbol> </svg> <div class="side-bar"> <div class="site-header"> <a href="http://localhost:4000/" class="site-title lh-tight"> πΒ Lego </a> <a href="#" id="menu-button" class="site-button"> <svg viewBox="0 0 24 24" class="icon"><use xlink:href="#svg-menu"></use></svg> </a> </div> <nav role="navigation" aria-label="Main" id="site-nav" class="site-nav"> <div class="nav-category">v2.0 - alpha</div> <ul class="nav-list"><li class="nav-list-item"><a href="http://localhost:4000/v2/" class="nav-list-link">Welcome</a></li><li class="nav-list-item"><a href="http://localhost:4000/v2/getting-started/" class="nav-list-link">Getting Started</a></li><li class="nav-list-item active"><a href="#" class="nav-list-expander"><svg viewBox="0 0 24 24"><use xlink:href="#svg-arrow-right"></use></svg></a><a href="http://localhost:4000/v2/usage-web-components/" class="nav-list-link">Usage</a><ul class="nav-list "><li class="nav-list-item "><a href="http://localhost:4000/v2/usage-web-components/template/" class="nav-list-link">Template tag</a></li><li class="nav-list-item "><a href="http://localhost:4000/v2/usage-web-components/condition/" class="nav-list-link">Condition :if</a></li><li class="nav-list-item "><a href="http://localhost:4000/v2/usage-web-components/loop/" class="nav-list-link">Loop :for</a></li><li class="nav-list-item "><a href="http://localhost:4000/v2/usage-web-components/custom-directive/" class="nav-list-link">Custom directives</a></li><li class="nav-list-item "><a href="http://localhost:4000/v2/usage-web-components/events/" class="nav-list-link">Binding events</a></li><li class="nav-list-item active"><a href="http://localhost:4000/v2/usage-web-components/reactive/" class="nav-list-link active">Reactive properties</a></li><li class="nav-list-item "><a href="http://localhost:4000/v2/usage-web-components/attributes/" class="nav-list-link">Pass attributes</a></li><li class="nav-list-item "><a href="http://localhost:4000/v2/usage-web-components/slots/" class="nav-list-link">Using slots</a></li><li class="nav-list-item "><a href="http://localhost:4000/v2/usage-web-components/reactive-css/" class="nav-list-link">Reactive CSS</a></li><li class="nav-list-item "><a href="http://localhost:4000/v2/usage-web-components/script-tag/" class="nav-list-link">Script Tag</a></li></ul></li><li class="nav-list-item"><a href="http://localhost:4000/v2/naming-components/" class="nav-list-link">Naming Conventions</a></li><li class="nav-list-item"><a href="http://localhost:4000/v2/compile-components/" class="nav-list-link">Compiling</a></li><li class="nav-list-item"><a href="http://localhost:4000/v2/configuring-components/" class="nav-list-link">Configuring</a></li><li class="nav-list-item"><a href="http://localhost:4000/v2/advanced-components/" class="nav-list-link">Advanced Example</a></li><li class="nav-list-item"><a href="http://localhost:4000/v2/testing-components/" class="nav-list-link">Testing</a></li><li class="nav-list-item"><a href="http://localhost:4000/v2/advanced-webcomponents/" class="nav-list-link">Getting deep</a></li></ul> </nav> <footer class="site-footer"> <p>Version 2.0 pre-release</p> <p>Based on <a href="https://jekyllrb.com/">Jekyll</a> and <a href="https://github.com/pmarsceill/just-the-docs">Just the Docs</a>.</p> </footer> </div> </section> <div class="main" id="top"> <div id="main-header" class="main-header"> <div class="search"> <div class="search-input-wrap"> <input type="search" id="search-input" class="search-input" tabindex="0" placeholder="Search the Lego documentation" aria-label="Search " autocomplete="off"> <label for="search-input" class="search-label"><svg viewBox="0 0 24 24" class="search-icon"><use xlink:href="#svg-search"></use></svg></label> </div> <div id="search-results" class="search-results"></div> </div> </div> <div id="main-content-wrap" class="main-content-wrap"> <nav aria-label="Breadcrumb" class="breadcrumb-nav"> <ol class="breadcrumb-nav-list"> <li class="breadcrumb-nav-list-item"><a href="">Usage</a></li> <li class="breadcrumb-nav-list-item"><span>Reactive Web-Components to Update HTML</span></li> </ol> </nav> <div id="main-content" class="main-content" role="main"> <h4 id="reactive-properties"> <a href="#reactive-properties" class="anchor-heading" aria-labelledby="reactive-properties"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Reactive Properties </h4> <p>The <code class="language-plaintext highlighter-rouge">state</code> is where the reactiveness takes place.</p> <p>declare a <code class="language-plaintext highlighter-rouge">state</code> object in the <code class="language-plaintext highlighter-rouge">init()</code> function with default values:</p> <div class="language-js highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">const</span> <span class="nx">state</span> <span class="o">=</span> <span class="p">{</span>
<span class="na">user</span><span class="p">:</span> <span class="p">{</span> <span class="na">firstname</span><span class="p">:</span> <span class="dl">'</span><span class="s1">John</span><span class="dl">'</span><span class="p">,</span> <span class="na">lastname</span><span class="p">:</span> <span class="dl">'</span><span class="s1">Doe</span><span class="dl">'</span> <span class="p">},</span>
<span class="na">status</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Happy π</span><span class="dl">"</span>
<span class="p">}</span>
<span class="kd">const</span> <span class="nx">title</span> <span class="o">=</span> <span class="dl">"</span><span class="s2">This title is non-reactive</span><span class="dl">"</span>
</code></pre></div></div> <p>Displaying a <em>state</em> value is as simple as writing <code class="language-plaintext highlighter-rouge">${state.theValue}</code> in your HTML.</p> <p>When you need your component to react, call the <code class="language-plaintext highlighter-rouge">render()</code> method with your updated state:</p> <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>function updateStatus(event) {
render({ status: "Laughing π" })
}
</code></pre></div></div> <p>This will update your component only where needed.</p> <p>When <code class="language-plaintext highlighter-rouge">state</code> is just mutated, the <code class="language-plaintext highlighter-rouge">changed(changedProps)</code> is called. This <code class="language-plaintext highlighter-rouge">changed()</code> method is called before (re-)rendering.</p> <hr> <footer> <p class="text-small text-grey-dk-100 mb-0">Lego is <a href=https://github.com/polight/lego>open-source</a>. Distributed under <a href="https://github.com/polight/lego/tree/master/LICENSE.txt">MIT license.</a></p> <div class="d-flex mt-2"> </div> </footer> </div> </div> <a href="#" id="search-button" class="search-button"> <svg viewBox="0 0 24 24" class="icon"><use xlink:href="#svg-search"></use></svg> </a> <div class="search-overlay"></div> </div> </body> </html>