Đặt tên trường thanh toán để trình duyệt hiểu đúng
Kết nối nhãn hiển thị, tên gửi dữ liệu và autocomplete trong biểu mẫu giao hàng, rồi kiểm tra dữ liệu với FormData.

Biểu mẫu thanh toán cần nhiều loại tên. Nhãn hiển thị cho người dùng biết cần nhập gì. Thuộc tính name xác định tên của giá trị được gửi đi. Token autocomplete cho trình duyệt biết giá trị ấy có ý nghĩa gì. Các tên này có thể khác nhau, nhưng cần cùng nói về một thông tin.
Nếu bạn đang xây biểu mẫu thanh toán đầu tiên, hãy hiểu mô hình biểu mẫu của trình duyệt trước khi thêm thành phần tùy biến. Ô nhập được trang trí đẹp nhưng thiếu nhãn hoặc tên gửi dữ liệu có thể trông hoàn chỉnh trong khi vẫn làm mất thông tin của người dùng hoặc máy chủ. Ví dụ địa chỉ dưới đây là giả định và được giữ nhỏ để dễ kiểm tra.
Ba mối quan hệ trong một trường
<form action="/checkout/address" method="post">
<fieldset>
<legend>Địa chỉ giao hàng</legend>
<label for="shipping-name">Họ và tên</label>
<input id="shipping-name" name="shippingName"
autocomplete="shipping name" required>
<label for="shipping-address">Địa chỉ đường phố</label>
<textarea id="shipping-address" name="shippingAddress"
autocomplete="shipping street-address"
required></textarea>
<label for="shipping-city">Thành phố hoặc địa phương</label>
<input id="shipping-city" name="shippingCity"
autocomplete="shipping address-level2" required>
</fieldset>
<button type="submit">Tiếp tục</button>
</form>
Giá trị for của nhãn trỏ tới ID của ô nhập. Khi bấm nhãn, trình duyệt có thể chuyển focus tới điều khiển được liên kết; công nghệ hỗ trợ có thể dùng quan hệ đó để xác định tên truy cập. ID phải duy nhất trong tài liệu. Sao chép thành phần hai lần mà giữ nguyên ID có thể khiến nhãn nối tới sai bản sao.
Tên gửi dữ liệu có nhiệm vụ khác. Khi biểu mẫu tạo danh sách dữ liệu gửi đi, các điều khiển đủ điều kiện đóng góp giá trị dưới tên của chúng. Đổi ID vì lý do bố cục không nên âm thầm đổi tên trường mà máy chủ nhận. Ngược lại, sửa thuộc tính name không khắc phục được liên kết nhãn đang trỏ sai ID.
Autocomplete cung cấp gợi ý ngữ nghĩa. Đặc tả tự điền của HTML định nghĩa các token như shipping, billing, name, street-address và address-level2. Trình duyệt có thể nhận ra các vai trò này tốt hơn tên tùy ý trong ứng dụng như shippingCity.
Giữ nhãn cho người dùng nhìn thấy
Placeholder không thay thế tốt cho nhãn. Nó biến mất khi người dùng gõ, khiến họ phải nhớ trường vừa yêu cầu gì. Nó cũng có thể trông giống giá trị đã nhập hoặc có độ tương phản kém. Đặt tên trường ở phía trên hoặc bên cạnh, và chỉ dùng placeholder cho một ví dụ ngắn khi ví dụ đó có ích.
Hướng dẫn nên nằm gần điều khiển liên quan. Nếu địa chỉ giao hàng cần số căn hộ, hãy giải thích mà không mặc định mọi địa chỉ đều có căn hộ. Một phần tử trợ giúp riêng có thể được nối bằng aria-describedby. Quan hệ này bổ sung mô tả trong khi tên trường vẫn ngắn gọn.
Sự phân biệt càng cần thiết khi có lỗi. Trường vẫn cần nhãn sau khi thông báo lỗi xuất hiện. Đổi “Địa chỉ đường phố” thành “Bắt buộc nhập” sẽ xóa mất thông tin giúp người dùng biết cần sửa gì. Giữ nhãn và thêm hướng dẫn khôi phục cụ thể.
Mỗi mũi tên trong hình có một đích khác nhau. Coi ba thuộc tính như có thể thay thế lẫn nhau thường không lộ lỗi trong bản trình diễn nhanh, nhưng dễ hỏng khi thành phần được tái sử dụng.
Nhiều địa chỉ cần nhóm riêng
Shipping và billing phân biệt hai nhóm địa chỉ thông thường. Nếu một đơn gửi hai món quà tới hai người, biểu mẫu cần thêm cách nhóm. Cú pháp tự điền hỗ trợ token section, chẳng hạn section-blue hoặc section-red, đặt trước token nói về mục đích địa chỉ.
Ví dụ, hai ô địa chỉ có thể dùng autocomplete là “section-blue shipping street-address” và “section-red shipping street-address”. Mã section gom các điều khiển liên quan; nó không phải nhãn để người dùng đọc. Mỗi món quà vẫn cần fieldset và legend mà người điền biểu mẫu hiểu được.
Đừng tự đổi thứ tự token hoặc ghép mã nghiệp vụ tùy ý vào cú pháp mà chưa kiểm tra. Giá trị không được nhận diện có thể khiến trình duyệt không hiểu gợi ý như dự kiến. Giữ phần ngữ nghĩa dành cho trình duyệt rõ và nhỏ, ngay cả khi cấu trúc dữ liệu máy chủ phức tạp hơn.
Địa chỉ quốc tế làm thay đổi câu hỏi
Định dạng địa chỉ khác nhau giữa các quốc gia. Biểu mẫu bắt buộc bang của Mỹ và ZIP năm chữ số không trở thành quốc tế chỉ nhờ đổi tiêu đề. Trước hết xác định dịch vụ thực sự hỗ trợ quốc gia nào, rồi chọn trường và quy tắc kiểm tra phù hợp. Nhãn địa phương có thể đổi theo quốc gia được chọn trong khi mục đích autocomplete bên dưới vẫn hữu ích.
Một trường họ tên đầy đủ cũng tránh áp đặt cấu trúc tên đầu và tên cuối như quy tắc chung. Có hệ thống cần tách từng phần, nhưng yêu cầu đó nên đến từ ràng buộc nghiệp vụ hoặc tích hợp được ghi rõ. Không nên suy ra từ giả định rằng tên mọi người đều theo cùng một mẫu.
Bài W3C Internationalization về tên người trên thế giới đưa ra các ví dụ cụ thể về thứ tự và số lượng thành phần tên. Hãy coi tên người dùng cung cấp là văn bản, giữ đúng ký tự của họ và tránh tự quyết định phần nào chắc chắn là họ. Biểu mẫu thanh toán cần dữ liệu để giao hàng, không cần tự xây một mô hình danh tính dùng cho cả thế giới.
Mã bưu chính là mã định danh, không phải đại lượng để tính toán. Ô nhập số có thể làm mất số không ở đầu khi dữ liệu bị xử lý như số, và không chứa được chữ cái dùng trong mã bưu chính của nhiều nước. Điều khiển văn bản giữ các ký tự được nhập; chỉ thêm gợi ý bàn phím số khi có cơ sở từ phạm vi địa chỉ hỗ trợ. Quy tắc phía trình duyệt cần phản ánh hệ thống địa chỉ ấy và không loại bỏ các trường hợp biên hợp lệ.
Tự điền là hỗ trợ, không phải bảo đảm
Trình duyệt, trình quản lý mật khẩu, thiết lập của người dùng và hồ sơ đã lưu đều ảnh hưởng việc tự điền. Token hợp lệ không bảo đảm mọi môi trường sẽ điền giúp. Biểu mẫu vẫn phải dùng được khi nhập thủ công và khi dùng công nghệ hỗ trợ. Nó cũng cần chấp nhận việc người dùng sửa lại giá trị tự điền.
Thử bấm từng nhãn, di chuyển bằng bàn phím và gửi dữ liệu giả định tới điểm nhận cục bộ. Xác nhận máy chủ nhận đúng tên trường và thông báo lỗi vẫn giữ lại dữ liệu. Sau đó thử cả nhóm giao hàng lẫn thanh toán bằng tính năng tự điền của trình duyệt nếu có.
Ví dụ này cố ý chưa bao gồm thuế, thanh toán và kiểm tra phía máy chủ. Đó là các phần có quy tắc riêng. Đặt đúng tên trường giúp các bước sau nhận dữ liệu ổn định, nhưng chưa chứng minh địa chỉ tồn tại hoặc đơn hàng có thể được giao.
Kiểm tra giá trị thực sự rời khỏi biểu mẫu
Có thể kiểm tra tên gửi dữ liệu trước khi có backend. Đặt biểu mẫu ở trên trong một trang cục bộ rồi chạy script sau nó. Các giá trị tiếng Anh là dữ liệu thử giả định. Tạo FormData đọc danh sách mục dữ liệu của biểu mẫu; thao tác này không gửi yêu cầu và không chạy kiểm tra ràng buộc tương tác.
const form = document.querySelector('form');
form.elements.namedItem('shippingName').value = 'Example Recipient';
form.elements.namedItem('shippingAddress').value = '12 Sample Lane';
const city = form.elements.namedItem('shippingCity');
city.value = 'Example City';
const baseline = new FormData(form);
console.assert(baseline.get('shippingName') === 'Example Recipient');
console.assert(baseline.get('shippingCity') === 'Example City');
city.disabled = true;
console.assert(new FormData(form).has('shippingCity') === false);
city.disabled = false;
city.readOnly = true;
console.assert(new FormData(form).get('shippingCity') === 'Example City');
city.readOnly = false;
Vô hiệu hóa trường không chỉ thay vẻ ngoài. Trong ví dụ, mục dữ liệu của nó biến mất khỏi FormData. Ô văn bản readonly vẫn đóng góp dữ liệu dù người dùng không thể sửa theo cách thông thường. Thuật toán tạo danh sách mục dữ liệu quy định điều khiển nào được đưa vào. Các loại điều khiển khác còn có điều kiện riêng; chẳng hạn checkbox chưa được chọn không đóng góp cặp tên và giá trị thông thường của nó.
Hình so sánh cùng một trường trong ba trạng thái. ID, nhãn và autocomplete có thể không đổi trong cả ba. Vì vậy, ảnh chụp cho thấy đúng chữ trong ô nhập chưa chứng minh máy chủ sẽ nhận đúng chữ ấy. Hãy kiểm tra danh sách mục dữ liệu và, khi đã có điểm nhận, phần thân yêu cầu thực tế.
Không dùng readonly hay disabled làm ranh giới bảo mật. Một bên gọi có thể tự gửi yêu cầu mà không dùng trang của bạn. Máy chủ phải kiểm tra dữ liệu được chấp nhận, dù giao diện trình bày trường đó là sửa được, chỉ đọc hay ẩn. Thuộc tính trình duyệt mô tả quy tắc tương tác cho máy khách hợp tác; chúng không trao quyền quyết định nội dung đơn hàng.
Cuối cùng, thử xóa name của trường thành phố nhưng giữ ID, nhãn và giá trị đã nhập. Dự đoán kết quả trước khi tạo FormData lần nữa. Khôi phục name rồi dùng cùng tên đó cho điều khiển thứ hai: gọi getAll để xem cả hai giá trị thay vì mặc định một tên luôn ứng với một giá trị đơn. Có cho phép nhiều giá trị cùng tên hay không là quyết định của giao diện máy chủ. Làm rõ từ đầu giúp tránh việc đổi thư viện biểu mẫu sau này âm thầm làm mất thông tin của một người nhận.