CKTIS / HTML
autocomplete: znaczenie pola dla przeglądarki
Opisz przeznaczenie pól i rozdziel dane dostawy, rozliczeń oraz grupy autouzupełniania.
Wersja: HTML Living Standard
Składnia
<input name="shippingCity" autocomplete="section-order shipping address-level2">Atrybut autocomplete przekazuje przeglądarce informacje o autouzupełnianiu kontrolek formularza. Przyjmuje on, off albo uporządkowaną listę tokenów opisujących oczekiwaną wartość. Lista może zaczynać się grupą section-, następnie zawierać shipping lub billing i przeznaczenie takie jak address-level2. Tokeny określają znaczenie danych, ale nie zmieniają nazwy przesyłanego pola.
Stosuj poprawne tokeny we wskazanej kolejności, odpowiednie dla kontrolki. Ukryte pole dopuszcza tylko tokeny szczegółowe, bez ogólnych słów włączających i wyłączających funkcję. Gdy kontrolka nie ma własnego ustawienia, formularz może dostarczyć domyślne. Wyłączenie autouzupełniania nie jest zabezpieczeniem ani pewnym zakazem działania menedżera haseł; znaczenie mają też zasady przeglądarki i wybory użytkownika.
Przykład rozdziela miasta dostawy i rozliczeń, ale zapisuje je pod różnymi nazwami pól. Przypisuje dane testowe bezpośrednio i nie korzysta z zapisanego profilu. Test potwierdza więc serializację formularza i poprawne oznaczenie grup, a nie automatyczne wpisanie tego samego adresu przez każdą przeglądarkę.
Przykłady
<!doctype html><meta charset="utf-8">
<form id="order">
<label>Delivery city <input name="shippingCity" autocomplete="section-order shipping address-level2"></label>
<label>Billing city <input name="billingCity" autocomplete="section-order billing address-level2"></label>
</form><output id="result"></output><script>
const form = document.querySelector('#order');
// Fixture values; this example does not access a saved autofill profile.
form.elements.shippingCity.value = 'Paris';
form.elements.billingCity.value = 'Berlin';
document.querySelector('#result').textContent = JSON.stringify(Object.fromEntries(new FormData(form)));
</script>Wynik
{"shippingCity":"Paris","billingCity":"Berlin"}Oba miasta pochodzą z danych testowych; przykład nie korzysta z zapisanych adresów ani prywatnego profilu przeglądarki.