Tạo biến tuỳ chỉnh

Hướng dẫn này sẽ hướng dẫn bạn cách tạo mẫu biến tuỳ chỉnh. Thời gian biến này được sử dụng, nó sẽ nhận một mảng các giá trị và trả về chúng dưới dạng chuỗi được phân tách bằng dấu phẩy.

1. Để bắt đầu mẫu biến đầu tiên, hãy nhấp vào Mẫu ở bên trái điều hướng và nhấp vào nút Mới trong Mẫu biến .

2. Trong thẻ Thông tin, hãy xác định Tên và Nội dung mô tả của biến.

   Tên là tên mà người dùng sẽ nhìn thấy khi họ triển khai tính năng này trong giao diện người dùng Trình quản lý thẻ.

   Nội dung mô tả chỉ là nội dung ngắn gọn (200 ký tự hoặc ít hơn) mô tả về chức năng của biến này.

3. Nhấp vào Làm mới để xem trước mẫu của bạn.

   Ở bên phải các trường nhập dữ liệu có cửa sổ Xem trước mẫu. Mỗi khi thực hiện thay đổi trong trình chỉnh sửa, nút Refresh (Làm mới) sẽ xuất hiện. Nhấp vào Làm mới để xem các thay đổi của bạn tác động như thế nào đến giao diện của biến.

4. Nhấp vào Trường để thêm trường vào mẫu biến.

   Thẻ Trường của Trình chỉnh sửa mẫu cho phép bạn tạo và chỉnh sửa các trường trong mẫu biến. Các trường được sử dụng để nhập dữ liệu tùy chỉnh, chẳng hạn như tài khoản Mã nhận dạng. Bạn có thể thêm các thành phần biểu mẫu chuẩn như trường văn bản, trình đơn thả xuống trình đơn, nút chọn và hộp đánh dấu.

5. Nhấp vào Thêm trường rồi chọn Bảng đơn giản. Thay thế tên mặc định (ví dụ: "simpleTable1") với "danh sách". Trong phần Xem trước mẫu, hãy nhấp vào Làm mới.

   Lặp lại bước này cho một mục Nhập văn bản và gọi là "mảng", gồm hai Hộp đánh dấu có tên là "use_array" và "sort" và Phương thức nhập văn bản có tên là "separator". Đối với "dấu phân cách", hãy cung cấp giá trị mặc định là "," bằng cách nhấp vào biểu tượng bánh răng chuyển đổi "Giá trị mặc định" thành bật và sau đó điền vào Giá trị mặc định mới trường nhập dữ liệu.

6. Nhấp vào thẻ Code (Mã) rồi nhập JavaScript dạng hộp cát vào trình chỉnh sửa:

   var input = data.array;
   
   if (!data.use_array) {
     input = [];
     for (var i = 0; i < data.list.length; i++) {
       input.push(data.list[i].values);
     }
   }
   
   if (data.sort) {
     input.sort();
   }
   
   return input.join(data.delimiter || ',');
   

   Mã cho biến này khá đơn giản, nhưng có một vài những điều đáng chỉ ra.

   • Trường data.

     Có một số trường đang được truy cập bên ngoài data chung. data sẽ chứa các giá trị mà bạn đã thiết lập trong bước trước. Đó là lý do chúng ta có thể truy cập data.use_array, data.sort, data.list và data.delimiter.

   • delimiter được đặt thành giá trị mặc định là "," nếu data.delimiter là không được cung cấp. Bạn nên đặt giá trị mặc định cho một trường nếu một định dạng là hợp lý. Điều này giúp người dùng dễ dàng sử dụng biến hơn mẫu, vì các mẫu này không phải điền vào mọi trường để sử dụng biến.

7. Nhấp vào Lưu để lưu tiến trình của bạn. Thao tác này sẽ tải mọi quyền phát hiện được vào Trình chỉnh sửa mẫu.

   Một số API mẫu có quyền liên kết với chúng để cho biết nội dung mà chúng có thể hoặc không thể làm. Khi bạn sử dụng API mẫu, chẳng hạn như sendPixel trong mã của bạn, thì Trình quản lý thẻ sẽ hiển thị các quyền liên quan trong mục Quyền .

8. Trong thẻ Xem trước mẫu, hãy thêm một số giá trị cho các thuộc tính "giá trị" nhập, nhấp chuột Chạy mã rồi xem Bảng điều khiển để xem kết quả cho biến của bạn.

   Nếu có lỗi, lỗi sẽ xuất hiện trong cửa sổ Console (Bảng điều khiển).

9. Nhấp vào Lưu rồi đóng Trình chỉnh sửa mẫu

   Bây giờ, mẫu biến đã sẵn sàng để sử dụng.