<secure-select>

A drop-in replacement for <select> that locks accepted values to the server-rendered option set. Injection attempts — from scripts, extensions, or devtools — are blocked and logged. Works without JavaScript as a native select.

<script type="module"
  src="/components/secure-select/secure-select.js">
</script>
View API Reference →
Live Demo

Configurations

security-tier="public"
Browser autocomplete allowed. No rate limiting. Use for preferences, categories, filters.
<secure-select
  label="Theme"
  name="theme"
  security-tier="public">
  <option value="light">Light</option>
  <option value="dark">Dark</option>
  <option value="system">System</option>
</secure-select>
security-tier="critical"
Autocomplete disabled. Rate limiting on. Full audit log. Use for roles, permissions, security questions.
<secure-select
  label="Access Level"
  name="access_level"
  security-tier="critical">
  <option value="viewer">Viewer</option>
  <option value="editor">Editor</option>
  <option value="admin">Administrator</option>
</secure-select>
required
Validates that a selection is made before form submission. Error is displayed on blur.
<secure-select
  label="Country"
  name="country"
  required
  security-tier="sensitive">
  <option value="">Select a country</option>
  <option value="us">United States</option>
</secure-select>
disabled
Field is non-interactive. Use to show a locked selection from a previous step.
<secure-select
  label="Plan"
  name="plan"
  disabled
  security-tier="public">
  <option value="pro" selected>Pro</option>
</secure-select>
multiple
All selected values are validated against the allowlist — not just the first. Any injected value in the selection is caught and rejected.
<secure-select
  label="Languages"
  name="languages"
  multiple
  size="4"
  security-tier="public">
  <option value="go">Go</option>
  <option value="ts">TypeScript</option>
</secure-select>

Security Features

These are client-side defences. Server-side validation is always the security boundary — these reduce the attack surface and produce a complete interaction record for your server to act on.

Allowlist enforcement All tiers

At mount, the component builds a Set of valid values from the server-rendered <option> elements. On every change event, the submitted value is checked against that set. Values not in the set — injected via devtools, browser extensions, or programmatic DOM manipulation — are rejected, the field is reset, and a secure-audit event is dispatched.

Injection attempt
// Attacker injects a new option
const el = document.querySelector('secure-select');
const opt = document.createElement('option');
opt.value = 'superadmin';
opt.text = 'Super Admin';
el.appendChild(opt);
el.value = 'superadmin';
What fires on your listener
element.addEventListener('secure-audit', e => {
  // e.detail.event === 'invalid_option_detected'
  // e.detail.attemptedValue === 'superadmin'
  // field reset to ''
  // value never reaches your server
});
FeaturePublicAuthenticatedSensitiveCritical
Option allowlist enforcementYesYesYesYes
XSS sanitization (values + labels)YesYesYesYes
Progressive enhancement (no-JS fallback)YesYesYesYes
Audit logging-YesYesYes
Autocomplete disabled--YesYes
Rate limiting--YesYes

Theming

Secure-UI uses CSS custom properties. Override at :root, per-component, or per-instance.

VariableDefaultDescription
--secure-ui-select-height2.5remSelect element height
--secure-ui-select-padding0.5rem 0.75remSelect inner padding
--secure-ui-select-background-colorvar(--secure-ui-color-bg-primary)Select background color
--secure-ui-select-colorvar(--secure-ui-color-text-primary)Select text color
Themed Example
secure-select {
  --secure-ui-select-height: 3rem;
  --secure-ui-select-background-color: #1e1b4b;
  --secure-ui-select-color: #e0e7ff;
}

Framework Examples

Web Components work natively in all frameworks. No wrappers, no adapters.

Plain HTML html
<!DOCTYPE html>
<html>
<head>
  <script type="module"
    src="/components/secure-select/secure-select.js">
  </script>
</head>
<body>
  <secure-select
    label="Country"
    name="country"
    security-tier="public"
    required>
    <option value="">Choose...</option>
    <option value="us">United States</option>
    <option value="gb">United Kingdom</option>
  </secure-select>
</body>
</html>
React (JSX) tsx
import { useEffect } from 'react';

export function CountrySelect() {
  useEffect(() => {
    import('/components/secure-select/secure-select.js');
  }, []);

  return (
    <secure-select
      label="Country"
      name="country"
      security-tier="public"
      required>
      <option value="">Choose...</option>
      <option value="us">United States</option>
      <option value="gb">United Kingdom</option>
    </secure-select>
  );
}
Vue 3 vue
<template>
  <secure-select
    label="Country"
    name="country"
    security-tier="public"
    required>
    <option value="">Choose...</option>
    <option v-for="c in countries" :key="c.code" :value="c.code">
      {{ c.name }}
    </option>
  </secure-select>
</template>

<script setup>
import { onMounted } from 'vue';
const countries = [{ code: 'us', name: 'United States' }];
onMounted(() => import('/components/secure-select/secure-select.js'));
</script>
Angular typescript
import { Component, CUSTOM_ELEMENTS_SCHEMA, OnInit } from '@angular/core';

@Component({
  selector: 'app-country-select',
  template: `
    <secure-select
      label="Country"
      name="country"
      security-tier="public"
      required>
      <option value="">Choose...</option>
      <option value="us">United States</option>
    </secure-select>
  `,
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class CountrySelectComponent implements OnInit {
  ngOnInit() {
    import('/components/secure-select/secure-select.js');
  }
}
Svelte svelte
<script>
  import { onMount } from 'svelte';
  onMount(() => import('/components/secure-select/secure-select.js'));
</script>

<secure-select label="Country" name="country" security-tier="public" required>
  <option value="">Choose...</option>
  <option value="us">United States</option>
</secure-select>
Go / Templ templ
templ CountrySelect(countries []Country) {
  <secure-select
    label="Country"
    name="country"
    security-tier="public"
    required>
    <option value="">Choose...</option>
    for _, c := range countries {
      <option value={ c.Code }>{ c.Name }</option>
    }
  </secure-select>
}