ElementInternals: setFormValue() method
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2023.
Phương thức setFormValue() của giao diện ElementInternals đặt giá trị gửi và trạng thái của phần tử, truyền đạt những thông tin này đến tác nhân người dùng.
Cú pháp
setFormValue(value)
setFormValue(value, state)
Tham số
value-
Một
File, một chuỗi hoặc mộtFormDatalàm giá trị được gửi đến máy chủ. stateOptional-
Một
File, một chuỗi hoặc mộtFormDatađại diện cho đầu vào do người dùng thực hiện. Điều này cho phép ứng dụng hiển thị lại thông tin mà người dùng đã gửi, theo định dạng mà họ đã gửi, nếu cần.
Note:
Nói chung, state được sử dụng để truyền thông tin do người dùng chỉ định, value phù hợp để gửi lên máy chủ sau khi đã làm sạch.
Ví dụ, nếu một phần tử tùy chỉnh yêu cầu người dùng nhập ngày, người dùng có thể nhập "3/15/2019".
Đây sẽ là state.
Máy chủ mong đợi định dạng ngày là 2019-03-15, ngày theo định dạng này sẽ được truyền làm value.
Giá trị trả về
Undefined.
Ngoại lệ
NotSupportedErrorDOMException-
Được ném ra nếu phần tử không có thuộc tính
formAssociatedđược đặt thànhtrue.
Ví dụ
Trong ví dụ sau, một phần tử tùy chỉnh hộp kiểm đặt on làm giá trị gửi đến máy chủ và checked làm trạng thái.
this.internals_.setFormValue("on", "checked");
Thông số kỹ thuật
| Specification |
|---|
| HTML # dom-elementinternals-setformvalue |