<input type="email">

Der Eingabewert wird automatisch validiert, um sicherzustellen, dass er entweder leer oder eine korrekt formatierte E-Mail-Adresse (oder Liste von Adressen) ist, bevor das Formular abgeschickt werden kann. Die CSS-Pseudoklassen :valid und :invalid werden automatisch angewendet, um optisch zu kennzeichnen, ob der aktuelle Wert des Feldes eine gültige E-Mail-Adresse ist oder nicht.

Das value Attribut des <input> Elements enthält einen String, der automatisch als konform zur E-Mail-Syntax validiert wird. Genauer gesagt gibt es drei mögliche Werteformate, die die Validierung bestehen:

1. Ein leerer String ("") zeigt an, dass der Benutzer keinen Wert eingegeben hat oder dass der Wert entfernt wurde.
2. Eine einzelne korrekt formatierte E-Mail-Adresse. Dies bedeutet nicht unbedingt, dass die E-Mail-Adresse existiert, aber sie ist zumindest korrekt formatiert. In einfachen Worten, das bedeutet username@domain oder username@domain.tld. Natürlich gibt es mehr dazu; siehe Validierung für einen regulären Ausdruck, der den E-Mail-Adressvalidierungs-Algorithmus abbildet.
3. Nur wenn das multiple Attribut angegeben ist, kann der Wert aus einer Liste von korrekt formatierten, durch Kommas getrennten E-Mail-Adressen bestehen. Jegliche nachgestellte und führende Leerzeichen werden von jeder Adresse in der Liste entfernt.

Siehe Validierung für Details zur Validierung von E-Mail-Adressen, um sicherzustellen, dass sie korrekt formatiert sind.

Zusätzlich zu den globalen Attributen und den Attributen, die auf alle <input> Elemente unabhängig von ihrem Typ wirken, unterstützen email Eingaben die folgenden Attribute.

Die Werte des list-Attributs sind die id eines im selben Dokument befindlichen <datalist> Elements. Der <datalist> bietet eine Liste von vordefinierten Werten, die dem Benutzer für diese Eingabe vorgeschlagen werden. Alle Werte in der Liste, die nicht mit dem type kompatibel sind, werden nicht in die vorgeschlagenen Optionen aufgenommen. Die angegebenen Werte sind Vorschläge, keine Anforderungen: Benutzer können aus dieser vordefinierten Liste auswählen oder einen anderen Wert bereitstellen.

Die maximale Zeichenlänge (gemessen in UTF-16-Codeeinheiten), die der Benutzer in die email Eingabe eingeben kann. Dies muss ein ganzzahliger Wert von 0 oder größer sein. Wenn kein maxlength angegeben ist oder ein ungültiger Wert angegeben ist, hat die email Eingabe keine maximale Länge. Dieser Wert muss auch größer oder gleich dem Wert von minlength sein.

Die Eingabe wird die Einschränkungsvalidierung nicht bestehen, wenn die Länge des Textwerts des Feldes größer ist als maxlength UTF-16-Codeeinheiten lang. Die Einschränkungsvalidierung wird nur angewendet, wenn der Wert durch den Benutzer geändert wird.

Die minimale Zeichenlänge (gemessen in UTF-16-Codeeinheiten), die der Benutzer in die email Eingabe eingeben kann. Dies muss ein nicht-negativer ganzzahliger Wert sein, der kleiner oder gleich dem durch maxlength festgelegten Wert ist. Wenn kein minlength angegeben ist oder ein ungültiger Wert angegeben ist, hat die email Eingabe keine Mindestlänge.

Die Eingabe wird die Einschränkungsvalidierung nicht bestehen, wenn die Länge des in das Feld eingegebenen Textes weniger als minlength UTF-16-Codeeinheiten beträgt. Die Einschränkungsvalidierung wird nur angewendet, wenn der Wert durch den Benutzer geändert wird.

Ein Boolean-Attribut, das, wenn es vorhanden ist, anzeigt, dass der Benutzer eine Liste von mehreren E-Mail-Adressen, getrennt durch Kommas und optional Leerzeichen, eingeben kann. Sehen Sie sich Mehrere E-Mail-Adressen zulassen für ein Beispiel an oder HTML-Attribut: multiple für weitere Details.

Das pattern Attribut, wenn angegeben, ist ein regulärer Ausdruck, den der value Wert des Eingabefeldes erfüllen muss, um die Einschränkungsvalidierung zu bestehen. Es muss ein gültiger JavaScript-Regulärer-Ausdruck sein, wie er durch den RegExp Typ verwendet wird, und wie in unserem Leitfaden zu regulären Ausdrücken dokumentiert; das 'u' Flag wird beim Kompilieren des regulären Ausdrucks angegeben, sodass das Muster als Folge von Unicode-Codepunkten behandelt wird, anstatt als ASCII. Es sollten keine Schrägstriche um den Mustertext herum angegeben werden.

Wenn das angegebene Muster nicht angegeben oder ungültig ist, wird kein regulärer Ausdruck angewendet und dieses Attribut wird vollständig ignoriert.

Siehe den Abschnitt Musterüberprüfung für Details und ein Beispiel.

Das placeholder Attribut ist ein String, der dem Benutzer einen kurzen Hinweis gibt, welche Art von Informationen im Feld erwartet wird. Es sollte ein Wort oder ein kurzer Satz sein, der den erwarteten Datentyp demonstriert, anstatt einer erläuternden Nachricht. Der Text darf keine Wagenrückläufe oder Zeilenumbrüche enthalten.

Wenn der Inhalt der Steuerung eine Richtung (LTR oder RTL) hat, der Platzhalter aber in der entgegengesetzten Richtung angezeigt werden muss, können Sie die Unicode-Bidi-Algorithmus-Formatierungszeichen verwenden, um die Richtung im Platzhalter zu überschreiben; siehe Anleitung zur Verwendung von Unicode-Steuerzeichen für bidirektionalen Text für weitere Informationen.

Ein Boolean-Attribut, das, wenn es vorhanden ist, bedeutet, dass dieses Feld vom Benutzer nicht bearbeitet werden kann. Der value kann jedoch immer noch durch JavaScript-Code direkt durch Setzen der HTMLInputElement value Eigenschaft geändert werden.

Das size Attribut ist ein numerischer Wert, der angibt, wie viele Zeichen das Eingabefeld breit sein sollte. Der Wert muss eine Zahl größer als Null sein, und der Standardwert ist 20. Da Zeichenbreiten variieren, kann dies möglicherweise nicht genau sein und sollte nicht darauf verlassen werden; das resultierende Eingabefeld kann enger oder breiter sein als die angegebene Anzahl von Zeichen, abhängig von den Zeichen und den verwendeten Schrifteinstellungen (font).

Dies setzt keine Begrenzung, wie viele Zeichen der Benutzer in das Feld eingeben kann. Es legt nur fest, wie viele in einer bestimmten Zeit zu sehen sind. Um ein oberes Limit für die Länge der Eingabedaten festzulegen, verwenden Sie das maxlength Attribut.

E-Mail-Adressen gehören zu den am häufigsten eingegebenen Textdaten auf dem Web; sie werden beim Einloggen in Websites verwendet, bei der Anforderung von Informationen, um eine Bestellbestätigung zu ermöglichen, für Webmail und so weiter. Als solches kann der email Eingabetyp Ihre Arbeit als Webentwickler erheblich erleichtern, da er helfen kann, Ihre Arbeit beim Erstellen der Benutzeroberfläche und Logik für E-Mail-Adressen zu vereinfachen. Wenn Sie eine E-Mail-Eingabe mit dem richtigen type Wert, email, erstellen, erhalten Sie eine automatische Validierung, dass der eingegebene Text zumindest in der richtigen Form vorliegt, um möglicherweise eine legitime E-Mail-Adresse zu sein. Dies kann helfen, Fälle zu vermeiden, in denen der Benutzer seine Adresse falsch eingibt oder eine ungültige Adresse angibt.

Es ist jedoch wichtig zu beachten, dass dies nicht ausreicht, um sicherzustellen, dass der angegebene Text eine E-Mail-Adresse ist, die tatsächlich existiert, dem Benutzer der Website entspricht oder auf andere Weise akzeptabel ist. Es stellt lediglich sicher, dass der Wert des Feldes korrekt formatiert ist, um eine E-Mail-Adresse zu sein.

Derzeit implementieren alle Browser, die dieses Element implementieren, es als Standard-Text-Eingabefeld mit grundlegenden Validierungsfunktionen. Die Spezifikation lässt den Browsern jedoch Freiheiten. Zum Beispiel könnte das Element mit dem im Gerät des Benutzers integrierten Adressbuch integriert werden, um E-Mail-Adressen aus dieser Liste auszuwählen. In seiner grundlegendsten Form kann eine email Eingabe wie folgt implementiert werden:

<input id="emailAddress" type="email" />

Beachten Sie, dass es als gültig betrachtet wird, wenn es leer ist und wenn eine einzelne gültig formatierte E-Mail-Adresse eingegeben wird, aber sonst nicht als gültig angesehen wird. Durch das Hinzufügen des Attributs required werden nur gültig formatierte E-Mail-Adressen zugelassen; die Eingabe wird nicht mehr als gültig angesehen, wenn sie leer ist.

Durch das Hinzufügen des booleschen Attributs multiple kann die Eingabe so konfiguriert werden, dass sie mehrere E-Mail-Adressen akzeptiert.

<input id="emailAddress" type="email" multiple />

Die Eingabe wird nun als gültig erachtet, wenn eine einzelne E-Mail-Adresse eingegeben wird oder wenn eine beliebige Anzahl von E-Mail-Adressen, getrennt durch Kommas und optional durch einige Leerzeichen, vorhanden ist.

Einige Beispiele für gültige Strings, wenn multiple angegeben ist:

• ""
• "me@example"
• "me@example.org"
• "me@example.org,you@example.org"
• "me@example.org, you@example.org"
• "me@example.org,you@example.org, us@example.org"

Einige Beispiele für ungültige Strings:

• ","
• "me"
• "me@example.org you@example.org"

Manchmal ist es hilfreich, einen kontextbezogenen Hinweis anzubieten, in welcher Form die Eingabedaten vorliegen sollten. Dies kann besonders wichtig sein, wenn das Seitendesign keine beschreibenden Labels für jedes <input> bietet. Hier kommen Platzhalter ins Spiel. Ein Platzhalter ist ein Wert, der die Form des value demonstriert, indem er ein Beispiel eines gültigen Wertes darstellt, der im Eingabefeld angezeigt wird, wenn der value des Elements "" ist. Sobald Daten in das Feld eingegeben werden, verschwindet der Platzhalter; wenn das Feld geleert wird, erscheint der Platzhalter wieder.

Hier haben wir eine email Eingabe mit dem Platzhalter sophie@example.com. Beachten Sie, wie der Platzhalter verschwindet und wieder erscheint, während Sie den Inhalt des Eingabefelds manipulieren.

<input type="email" placeholder="sophie@example.com" />

Sie können nicht nur die physische Länge des Eingabekastens steuern, sondern auch die minimalen und maximalen Längen, die für den eingegebenen Text erlaubt sind.

Physische Größe des Eingabefeldes

Die physische Größe des Eingabefeldes kann mit dem size Attribut gesteuert werden. Damit können Sie die Anzahl der Zeichen angeben, die das Eingabefeld gleichzeitig anzeigen kann. In diesem Beispiel ist das email Eingabefeld 15 Zeichen breit:

<input type="email" size="15" />

Länge des Elementwerts

Die size ist separat von der Längenbegrenzung der eingegebenen E-Mail-Adresse selbst, sodass Sie Felder für einen kleinen Raum passend haben können, während Sie trotzdem längere E-Mail-Adressen-Strings eingeben können. Sie können eine Mindestlänge in Zeichen für die eingegebene E-Mail-Adresse mit dem Attribut minlength angeben; verwenden Sie ähnlich maxlength, um die maximale Länge der eingegebenen E-Mail-Adresse festzulegen.

Das folgende Beispiel erstellt ein Eingabefeld für E-Mail-Adressen mit 32 Zeichen Breite, wobei der Inhalt mindestens 3 Zeichen und maximal 64 Zeichen lang sein muss.

<input type="email" size="32" minlength="3" maxlength="64" />

Bereitstellung eines einzelnen Standards mit dem Wertattribut

Wie immer können Sie einen Standardwert für ein email Eingabefeld angeben, indem Sie sein value Attribut einstellen:

<input type="email" value="default@example.com" />

Vorschlagen von Werten

Ein Schritt weiter kann man eine Liste von Standardoptionen anbieten, aus denen der Benutzer auswählen kann, indem man das Attribut list angibt. Dies beschränkt den Benutzer nicht auf diese Optionen, ermöglicht jedoch schnellere Auswahl vordefinierter E-Mail-Adressen. Dies bietet auch Hinweise auf autocomplete. Das list Attribut gibt die ID eines <datalist> an, der seinerseits ein <option> Element pro vorgeschlagenen Wert enthält; der value von jedem option ist der entsprechende vorgeschlagene Wert für das E-Mail-Eingabefeld.

<input type="email" size="40" list="defaultEmails" />

<datalist id="defaultEmails">
  <option value="jbond007@mi6.defence.gov.uk"></option>
  <option value="jbourne@unknown.net"></option>
  <option value="nfury@shield.org"></option>
  <option value="tony@starkindustries.com"></option>
  <option value="hulk@grrrrrrrr.arg"></option>
</datalist>

Mit dem <datalist> Element und seinen <option>s präsentiert der Browser die angegebenen Werte als mögliche Werte für die E-Mail-Adresse; dies wird typischerweise als Popup oder Dropdown-Menü mit den Vorschlägen dargestellt. Während die spezifische Benutzererfahrung von einem Browser zum anderen variieren kann, wird typischerweise durch Klicken in das Eingabefeld ein Dropdown mit den vorgeschlagenen E-Mail-Adressen angezeigt. Dann wird die Liste gefiltert, um nur die passenden Werte zu zeigen, wenn der Benutzer tippt. Jedes getippte Zeichen reduziert die Liste, bis der Benutzer eine Auswahl trifft oder einen benutzerdefinierten Wert eingibt.

Für email Eingaben stehen zwei Ebenen der Inhaltsvalidierung zur Verfügung. Zuerst gibt es die Standardebene der Validierung, die für alle <input>s angeboten wird, die automatisch sicherstellt, dass der Inhalt die Anforderungen erfüllt, eine gültige E-Mail-Adresse zu sein. Aber es gibt auch die Möglichkeit, zusätzliche Filter hinzuzufügen, um sicherzustellen, dass Ihre eigenen speziellen Bedürfnisse erfüllt werden, wenn Sie welche haben.

Browser bieten automatisch Validierung, um sicherzustellen, dass nur Text eingegeben wird, der dem Standardformat für Internet-E-Mail-Adressen entspricht. Browser verwenden einen Algorithmus, der dem folgenden regulären Ausdruck entspricht:

/^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;

Um mehr darüber zu erfahren, wie die Formularvalidierung funktioniert und wie Sie die :valid und :invalid CSS-Eigenschaften nutzen können, um die Eingabe auf der Basis der Gültigkeit des aktuellen Wertes zu gestalten, sehen Sie sich Formular-Datenvalidierung an.

Wenn Sie die eingegebene E-Mail-Adresse weiter als nur "jede Zeichenfolge, die wie eine E-Mail-Adresse aussieht" einschränken müssen, können Sie das pattern Attribut verwenden, um einen regulären Ausdruck anzugeben, den der Wert erfüllen muss, um gültig zu sein. Wenn das Attribut multiple angegeben wird, muss jedes Element in der durch Kommas getrennten Liste der Werte den regulären Ausdruck erfüllen.

Angenommen, Sie bauen eine Seite für Mitarbeiter von Best Startup Ever, Inc., mit der sie sich an die IT-Abteilung wenden können, um Hilfe zu erhalten. In unserem vereinfachten Formular muss der Benutzer seine E-Mail-Adresse und eine Nachricht eingeben, die das Problem beschreibt, bei dem er Hilfe benötigt. Wir möchten sicherstellen, dass nicht nur eine gültige E-Mail-Adresse angegeben wird, sondern aus Sicherheitsgründen auch, dass die Adresse eine interne Unternehmens-E-Mail-Adresse ist.

Da Eingaben des Typs email sowohl gegen die Standard-E-Mail-Adressvalidierung als auch gegen das angegebene Muster pattern validiert werden, können Sie dies einfach implementieren. Sehen wir uns an, wie:

body {
  font: 16px sans-serif;
}

.emailBox {
  padding-bottom: 20px;
}

.messageBox {
  padding-bottom: 20px;
}

label {
  line-height: 22px;
}

label::after {
  content: ":";
}

<form>
  <div class="emailBox">
    <label for="emailAddress">Your email address</label><br />
    <input
      id="emailAddress"
      type="email"
      size="64"
      maxlength="64"
      required
      placeholder="username@beststartupever.com"
      pattern=".+@beststartupever\.com"
      title="Please provide only a Best Startup Ever corporate email address" />
  </div>

  <div class="messageBox">
    <label for="message">Request</label><br />
    <textarea
      id="message"
      cols="80"
      rows="8"
      required
      placeholder="My shoes are too tight, and I have forgotten how to dance."></textarea>
  </div>
  <input type="submit" value="Send Request" />
</form>

Unser <form> enthält ein <input> vom Typ email für die E-Mail-Adresse des Benutzers, ein <textarea>, in das der Benutzer seine Nachricht an die IT eingeben kann, und ein <input> vom Typ "submit", welches eine Schaltfläche zum Absenden des Formulars erstellt. Jedes Texteingabefeld hat eine mit <label> verknüpfte Beschriftung, um dem Benutzer klarzumachen, was von ihm erwartet wird.

Betrachten wir das Eingabefeld für die E-Mail-Adresse genauer. Seine size und maxlength Attribute sind beide auf 64 gesetzt, um Platz für 64 Zeichen lange E-Mail-Adressen zu bieten und die tatsächlich eingegebene Zeichenanzahl auf maximal 64 zu begrenzen. Das Attribut required ist angegeben, was es zwingend erforderlich macht, dass eine gültige E-Mail-Adresse bereitgestellt wird.

Ein geeigneter placeholder wird bereitgestellt - username@beststartupever.com - um zu demonstrieren, was als gültiger Eintrag akzeptiert wird. Dieser String zeigt sowohl, dass eine E-Mail-Adresse eingegeben werden soll, als auch, dass sie ein Unternehmensaccount von beststartupever.com sein sollte. Zusätzlich zu der Tatsache, dass der Typ email den Text validiert, um sicherzustellen, dass er wie eine E-Mail-Adresse formatiert ist. Wenn der Text im Eingabefeld keine E-Mail-Adresse ist, erhalten Sie eine Fehlermeldung, die in etwa so aussieht:

Wenn wir die Dinge dabei belassen würden, würden wir zumindest nur gültige E-Mail-Adressen validieren. Aber wir möchten einen Schritt weiter gehen: Wir möchten sicherstellen, dass die E-Mail-Adresse tatsächlich in der Form [username]@beststartupever.com vorliegt. Hier kommt das Muster pattern ins Spiel. Wir setzen pattern auf .+@beststartupever.com. Dieser einfache reguläre Ausdruck fordert eine Zeichenfolge an, die aus mindestens einem beliebigen Zeichen besteht, gefolgt von einem "@", gefolgt vom Domainnamen "beststartupever.com".

Beachten Sie, dass dies nicht einmal annährend ein ausreichendes Filter für gültige E-Mail-Adressen ist; es würde Dinge wie " @beststartupever.com" (beachten Sie das führende Leerzeichen) oder "@@beststartupever.com" zulassen, von denen keines gültig ist. Der Browser führt jedoch sowohl den Standardfilter für E-Mail-Adressen als auch unser benutzerdefiniertes Muster gegen den angegebenen Text aus. Somit erhalten wir eine Validierung, die besagt: "Stellen Sie sicher, dass dies einer gültigen E-Mail-Adresse ähnelt, und wenn es das tut, stellen Sie auch sicher, dass es sich um eine beststartupever.com Adresse handelt."

Es ist ratsam, das Attribut title zusammen mit pattern zu verwenden. Wenn Sie dies tun, muss der title das Muster beschreiben. Das heißt, er sollte erklären, welches Format die Daten haben sollten, anstatt andere Informationen bereitzustellen. Dies liegt daran, dass der title möglicherweise als Teil einer Validierungsfehlernachricht angezeigt oder gesprochen wird. Beispielsweise könnte der Browser die Nachricht "Der eingegebene Text entspricht nicht dem erforderlichen Muster." anzeigen, gefolgt von Ihrem angegebenen title. Wenn Ihr title etwas wie "E-Mail-Adresse" ist, wäre das Ergebnis die Nachricht "Der eingegebene Text entspricht nicht dem erforderlichen Muster. E-Mail-Adresse", was nicht sehr gut ist.

Deshalb geben wir stattdessen den String "Bitte geben Sie nur eine Best Startup Ever Unternehmens-E-Mail-Adresse ein." an. Auf diese Weise könnte die vollständige Fehlermeldung etwas wie "Der eingegebene Text entspricht nicht dem erforderlichen Muster. Bitte geben Sie nur eine Best Startup Ever Unternehmens-E-Mail-Adresse ein." lauten.

Hier haben wir eine E-Mail-Eingabe mit der ID emailAddress, die bis zu maximal 256 Zeichen lang sein darf. Das Eingabefeld selbst ist physisch 64 Zeichen breit und zeigt den Text user@example.gov als Platzhalter an, sobald das Feld leer ist. Darüber hinaus wird durch die Verwendung des multiple Attributs das Feld so konfiguriert, dass der Benutzer null oder mehr E-Mail-Adressen eingeben kann, getrennt durch Kommas, wie unter Zulassen von mehreren E-Mail-Adressen beschrieben. Als letzter Schliff enthält das list Attribut die ID eines <datalist>, dessen <option>s eine Reihe von vorgeschlagenen Werten spezifizieren, aus denen der Benutzer wählen kann.

Als zusätzliche Ergänzung wird das <label> Element benutzt, um ein Label für das E-Mail-Eingabefeld zu erstellen, wobei sein for Attribut auf die emailAddress ID des <input> Elements verweist. Durch das Verknüpfen der beiden Elemente auf diese Weise wird das Klick auf das Label das Eingabeelement fokussieren.

<label for="emailAddress">Email</label><br />
<input
  id="emailAddress"
  type="email"
  placeholder="user@example.gov"
  list="defaultEmails"
  size="64"
  maxlength="256"
  multiple />

<datalist id="defaultEmails">
  <option value="jbond007@mi6.defence.gov.uk"></option>
  <option value="jbourne@unknown.net"></option>
  <option value="nfury@shield.org"></option>
  <option value="tony@starkindustries.com"></option>
  <option value="hulk@grrrrrrrr.arg"></option>
</datalist>

• HTML-Formulare Leitfaden
• <input>
• <input type="tel">
• <input type="url">
• Attribute:
  • list
  • minlength
  • maxlength
  • multiple
  • pattern
  • placeholder
  • readonly
  • size
• Kompatibilität von CSS-Eigenschaften