Reference · NPL

`<npl-flags>`

NPL element

It wraps one or more npl-flag elements. You can add a short note above the rows to explain what they do.

A group of settings shown as clickable rows. It wraps one or more npl-flag elements. You can add a short note above the rows to explain what they do. optional, no default (omit it entirely for no badge). One of `minimal`, `full`, `production`, `creative`, `tireless` (the NPL flag source spells these `preset:<name>`; the attribute accepts the bare word or the prefixed spelling, normalized for display). An unknown preset is NOT an error: it warns through the author-facing channel and renders with the invalid-preset warning class (see Rendered form).

per the global attribute catalog (conventions.md §2)

Children

<npl-flag>

Example

npl-flags.html

source

              
              <npl-flags preset="production">
            
                <npl-flag name="calm_factor" value="0.5"></npl-flag>
            
                tuning notes…
            
              </npl-flags>

render

Live render boots with JavaScript — the authored source is alongside.

variant: preset="tireless"

Another preset value — the badge always renders the resolved preset as preset:<name> ahead of the authored flags.

variant: preset="tireless"

npl-flags-preset-tireless.html

source

              
              <npl-flags preset="tireless">
            
                <npl-flag name="max_iterations" value="25"></npl-flag>
            
                Run until the budget is spent, not until the task looks finished.
            
              </npl-flags>

render

Live render boots with JavaScript — the authored source is alongside.

variant: preset="preset:minimal"

The NPL flag source spells presets preset:<name>; the attribute accepts that spelling and normalizes it for display.

variant: preset="preset:minimal"

npl-flags-source-spelling.html

source

              
              <npl-flags preset="preset:minimal">
            
                <npl-flag name="verbosity" value="low"></npl-flag>
            
              </npl-flags>

render

Live render boots with JavaScript — the authored source is alongside.

variant: preset="turbo"

An unknown preset is not an error — the author-facing channel warns and the badge renders with the npl-flags-preset-invalid warning class.

variant: preset="turbo"

npl-flags-unknown-preset.html

source

              
              <npl-flags preset="turbo">
            
                <npl-flag name="boost" value="on"></npl-flag>
            
                Unknown preset — the badge falls back to the invalid form.
            
              </npl-flags>

render

Live render boots with JavaScript — the authored source is alongside.

variant: no preset

With no preset authored the container renders no badge — just the authored flags and note text.

variant: no preset

npl-flags-no-preset.html

source

              
              <npl-flags>
            
                <npl-flag name="pump_switch" value="on"></npl-flag>
            
                No preset: the flags stand on their own.
            
              </npl-flags>

render

Live render boots with JavaScript — the authored source is alongside.

Source: spec/schema/npl/npl-flags.md