<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>Configurations
<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><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><secure-select
label="Country"
name="country"
required
security-tier="sensitive">
<option value="">Select a country</option>
<option value="us">United States</option>
</secure-select><secure-select
label="Plan"
name="plan"
disabled
security-tier="public">
<option value="pro" selected>Pro</option>
</secure-select><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.
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.
// 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';element.addEventListener('secure-audit', e => {
// e.detail.event === 'invalid_option_detected'
// e.detail.attemptedValue === 'superadmin'
// field reset to ''
// value never reaches your server
});| Feature | Public | Authenticated | Sensitive | Critical |
|---|---|---|---|---|
| Option allowlist enforcement | Yes | Yes | Yes | Yes |
| XSS sanitization (values + labels) | Yes | Yes | Yes | Yes |
| Progressive enhancement (no-JS fallback) | Yes | Yes | Yes | Yes |
| Audit logging | - | Yes | Yes | Yes |
| Autocomplete disabled | - | - | Yes | Yes |
| Rate limiting | - | - | Yes | Yes |
Theming
Secure-UI uses CSS custom properties. Override at :root, per-component, or per-instance.
| Variable | Default | Description |
|---|---|---|
| --secure-ui-select-height | 2.5rem | Select element height |
| --secure-ui-select-padding | 0.5rem 0.75rem | Select inner padding |
| --secure-ui-select-background-color | var(--secure-ui-color-bg-primary) | Select background color |
| --secure-ui-select-color | var(--secure-ui-color-text-primary) | Select text color |
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.
<!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>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>
);
}<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>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');
}
}<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>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>
}