<secure-textarea>
Multi-line text field with a live character counter, XSS sanitization on every keystroke and paste event, and length limits enforced on the native element inside the shadow DOM. Content is sanitized before it ever reaches your event handlers.
<script type="module"
src="/components/secure-textarea/secure-textarea.js">
</script>Configurations
The counter lives inside the shadow DOM and updates on every keystroke. It turns amber at 90% of the limit—before users run out of space.
<secure-textarea
label="Bio"
name="bio"
rows="3"
minlength="20"
maxlength="200"
security-tier="public">
</secure-textarea>Critical tier disables autocomplete to prevent browsers from caching sensitive multi-line content (incident notes, medical descriptions). Rate limiting is also active.
<secure-textarea
label="Incident Description"
name="incident"
rows="4"
security-tier="critical">
</secure-textarea>Blur-time validation shows an inline error when the field is empty. The native required attribute is forwarded to the internal <textarea> so constraint validation also works.
<secure-textarea
label="Required field"
name="field"
rows="3"
required
security-tier="public">
</secure-textarea>Disable user resize for fixed-height inputs like chat fields or inline comment forms. Default is soft wrap with vertical resize available.
<secure-textarea
label="Fixed height"
name="field"
rows="3"
resize="none"
security-tier="public">
</secure-textarea>disabled prevents interaction and excludes the field from form submission. readonly allows focus and copying but blocks edits. Both states are forwarded to the internal element.
<secure-textarea disabled ...>
</secure-textarea>
<secure-textarea readonly
value="This content cannot be edited" ...>
</secure-textarea>Shadow DOM Enforcement
The character counter and length limit are enforced on the native <textarea> element inside the closed shadow DOM. Page scripts have no access to the internal element and cannot override the limit. Content sanitization runs on every input and paste event—HTML entities are encoded before the value is readable by your code.
<!-- user pastes this -->
<script>alert('xss')</script>
<b>bold</b> text & more// textarea.value reads as:
<script>alert('xss')</script>
<b>bold</b> text &amp; more--secure-ui-color-text-secondary (normal) → --secure-ui-color-warning (amber, at 90% of maxlength).Security Features
Security is enforced server-side. These are client-side complements.
secure-threat-detected on every input eventEvery keystroke is scanned against 8 patterns (script-tag, js-protocol, event-handler, html-injection, css-expression, vbscript, data-uri-html, template-syntax). Only the first match per event is reported. The raw field value is never included in the event detail — only the patternId, fieldName, tier, and timestamp.
threat-feedback attributeAdd threat-feedback to show an amber warning below the textarea when a pattern matches. Opt-in by design — a textarea used for markdown, code snippets, or HTML templates should not flag legitimate input as a threat. Silent detection and the secure-threat-detected event fire regardless.
<!-- Contact message: feedback appropriate -->
<secure-textarea
label="Message"
name="message"
security-tier="public"
threat-feedback>
</secure-textarea>
<!-- Code field: omit threat-feedback -->
<secure-textarea
label="HTML Template"
name="template_code"
security-tier="public">
</secure-textarea><script>alert(1)</script>| Feature | Public | Authenticated | Sensitive | Critical |
|---|---|---|---|---|
| Content sanitization | Yes | Yes | Yes | Yes |
| Length enforcement (shadow DOM) | Yes | Yes | Yes | Yes |
| Character counter with 90% warning | Yes | Yes | Yes | Yes |
| Paste sanitization | Yes | Yes | Yes | Yes |
| Autocomplete disabled | - | - | Yes | Yes |
| Audit logging | - | Yes | Yes | Yes |
| Rate limiting | - | - | Yes | Yes |
| Real-time injection detection | Yes | Yes | Yes | Yes |
Inline threat feedback (threat-feedback) | Opt-in | Opt-in | Opt-in | Opt-in |
Theming
Secure-UI uses CSS custom properties. Override at :root, per-component, or per-instance.
| Variable | Default | Description |
|---|---|---|
| --secure-ui-textarea-min-height | 6rem | Minimum textarea height |
| --secure-ui-textarea-padding | 0.5rem 0.75rem | Inner padding |
| --secure-ui-input-border-color | var(--secure-ui-color-border) | Border color (shared with input) |
| --secure-ui-input-border-color-focus | var(--secure-ui-color-primary) | Focus border color (shared) |
| --secure-ui-input-text-color | var(--secure-ui-color-text-primary) | Text color (shared) |
secure-textarea {
--secure-ui-textarea-min-height: 10rem;
--secure-ui-input-border-color: #d97706;
--secure-ui-input-border-color-focus: #f59e0b;
}Framework Examples
Web Components work natively in all frameworks. No wrappers, no adapters.
<!DOCTYPE html>
<html>
<head>
<script type="module"
src="/components/secure-textarea/secure-textarea.js">
</script>
</head>
<body>
<secure-textarea
label="Message"
name="message"
rows="5"
maxlength="1000"
security-tier="public"
required>
</secure-textarea>
</body>
</html>import { useEffect } from 'react';
export function MessageField() {
useEffect(() => {
import('/components/secure-textarea/secure-textarea.js');
}, []);
return (
<secure-textarea
label="Message"
name="message"
rows="5"
maxlength="1000"
security-tier="public"
required
/>
);
}<template>
<secure-textarea
label="Message"
name="message"
:rows="rows"
maxlength="1000"
security-tier="public"
required>
</secure-textarea>
</template>
<script setup>
import { onMounted } from 'vue';
const rows = 5;
onMounted(() =>
import('/components/secure-textarea/secure-textarea.js'));
</script>import { Component, CUSTOM_ELEMENTS_SCHEMA, OnInit } from '@angular/core';
@Component({
selector: 'app-message-field',
template: `
<secure-textarea
label="Message"
name="message"
rows="5"
maxlength="1000"
security-tier="public"
required>
</secure-textarea>
`,
schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class MessageFieldComponent implements OnInit {
ngOnInit() {
import('/components/secure-textarea/secure-textarea.js');
}
}<script>
import { onMount } from 'svelte';
onMount(() =>
import('/components/secure-textarea/secure-textarea.js'));
</script>
<secure-textarea
label="Message"
name="message"
rows="5"
maxlength="1000"
security-tier="public"
required>
</secure-textarea>templ MessageField(maxLen string) {
<secure-textarea
label="Message"
name="message"
rows="5"
maxlength={ maxLen }
security-tier="public"
required>
</secure-textarea>
}