#ctx.getValue()

Trong các kịch bản field có thể chỉnh sửa như JSField, JSItem, lấy giá trị mới nhất của field hiện tại. Kết hợp với ctx.setValue(v) có thể thực hiện two-way binding với form.

#Kịch bản áp dụng

Lưu ý: ctx.getValue() chỉ khả dụng trong ngữ cảnh RunJS có liên kết form; trong các kịch bản không có liên kết field như luồng sự kiện, quy tắc liên kết, phương thức này không tồn tại.

#Định nghĩa kiểu

getValue<T = any>(): T | undefined;

• Giá trị trả về: Giá trị field hiện tại, kiểu được xác định bởi kiểu form item của field; có thể là undefined khi field chưa đăng ký hoặc chưa điền.

#Thứ tự lấy giá trị

ctx.getValue() lấy giá trị theo thứ tự sau:

1. Trạng thái form: Ưu tiên đọc từ trạng thái hiện tại của Ant Design Form
2. Giá trị fallback: Nếu không có field này trong form, fallback về giá trị khởi tạo hoặc props của field

Khi form chưa render xong hoặc field chưa đăng ký, có thể trả về undefined.

#Ví dụ

#Render dựa trên giá trị hiện tại

const current = ctx.getValue();
if (current == null || current === '') {
  ctx.render(<span>请先输入内容</span>);
} else {
  ctx.render(<span>当前值：{current}</span>);
}

#Kết hợp với setValue để thực hiện two-way binding

const { Input } = ctx.libs.antd;

// 读取当前值作为默认值
const defaultValue = ctx.getValue() ?? '';

ctx.render(
  <Input
    defaultValue={defaultValue}
    onChange={(e) => ctx.setValue(e.target.value)}
  />
);

#Liên quan

• ctx.setValue() - Đặt giá trị field hiện tại, kết hợp với getValue để thực hiện two-way binding
• ctx.form - Instance Ant Design Form, có thể đọc/ghi các field khác
• js-field:value-change - Sự kiện container được trigger khi giá trị bên ngoài thay đổi, dùng để cập nhật hiển thị