thành phần điều khiển

Xác định không gian tên, phiên bản và thông tin hiển thị của cấu phần.

Sẵn dùng cho

Ứng dụng dựa trên mô hình và bảng tùy biến

Tham số

Tên Sự miêu tả Kiểu Bắt buộc Sẵn dùng cho
namespace Xác định nguyên mẫu đối tượng của cấu phần Chỉ chữ cái hoặc số Có Ứng dụng dựa trên mô hình và bảng tùy biến
constructor Một phương pháp để khởi tạo đối tượng Chỉ chữ cái hoặc số Có Ứng dụng dựa trên mô hình và bảng tùy biến
control-type Điều khiển là điều khiển tiêu chuẩn hay điều khiển React. Giá trị của chỉ báo virtual một điều khiển React sử dụng platform React library. Điều khiển ảo là một tính năng trong bản xem trước công khai. Thông tin thêm: React controls & platform libraries standard|virtual No Ứng dụng dựa trên mô hình và bảng tùy biến
description-key Xác định mô tả của cấu phần có thể nhìn thấy trong giao diện người dùng. string No Ứng dụng dựa trên mô hình và bảng tùy biến
display-name-key Xác định tên của điều khiển hiển thị trong giao diện người dùng. string Có Ứng dụng dựa trên mô hình và bảng tùy biến
preview-image Hình ảnh được sử dụng trên màn hình tùy chỉnh để hiển thị bản xem trước của cấu phần. string No Ứng dụng dựa trên mô hình
version Xác định phiên bản của cấu phần được xác định trong Phiên bản Ngữ nghĩa string Có Ứng dụng dựa trên mô hình và bảng tùy biến

Thành phần Mẹ

Yếu tố Sự miêu tả
biểu hiện Manifest là tệp siêu dữ liệu xác định cấu phần. Đó là một tệp XML mô tả:
  • Không gian tên của cấu phần.
  • Loại dữ liệu có thể được cấu hình, trường hoặc tập dữ liệu.
  • Bất kỳ thuộc tính nào có thể được cấu hình trong ứng dụng khi cấu phần được thêm vào.
  • Danh sách các tệp tài nguyên mà cấu phần cần.
    • Một trong số đó phải là tài nguyên web TypeScript. TypeScript này phải bao gồm một hàm sẽ tạo đối tượng. Điều này thực hiện một giao diện cho thấy các phương pháp được yêu cầu cho các thành phần để làm việc. Thư viện này được gọi là thư viện triển khai cấu phần.
  • Tên của hàm TypeScript trong thư viện triển khai cấu phần sẽ trả về một đối tượng áp dụng giao diện cấu phần bắt buộc.
Khi người dùng đặt cấu hình một cấu phần tùy chỉnh trong ứng dụng bảng tùy biến hoặc ứng dụng dựa trên mô hình, dữ liệu trong tệp kê khai sẽ lọc ra các cấu phần có sẵn để chỉ các cấu phần hợp lệ cho ngữ cảnh mới sẵn dùng cho cấu hình. Các thuộc tính được xác định trong manifest cho cấu phần được thể hiện như trường cấu hình để người dùng cấu hình cấu hình cấu phần có thể xác định giá trị. Các giá trị thuộc tính này sau đó sẵn dùng cho hàm component tại thời điểm chạy.

Các yếu tố con

Yếu tố Sự miêu tả Sự kiện
tập dữ liệu Nút tập dữ liệu trong bản kê cấu phần đại diện cho một bản trình bày cụ thể, có thể cấu hình của một tập hợp các bản ghi bảng. 0 trở lên
sử dụng dịch vụ bên ngoài Cho biết điều khiển này có đang sử dụng dịch vụ bên ngoài hay không. Nếu đúng như vậy, hãy đặt cờ thuộc tính đã bật là đúng và thêm miền dịch vụ bên ngoài vào thuộc <domain> tính. Điều khiển sử dụng bất kỳ dịch vụ bên ngoài nào là điều khiển cao cấp và người dùng cuối sẽ cần giấy phép Power Apps để mở một ứng dụng với điều khiển cao cấp. Thông tin thêm: Cấp phép 0 hoặc 1
tài sản Nút thuộc tính xác định một phần dữ liệu cụ thể, có thể cấu hình được mà cấu phần đó mong đợi từ Microsoft Dataverse. 0 trở lên
nguyên mới Nút tài nguyên trong manifest thành phần đề cập đến các tệp tài nguyên mà cấu phần yêu cầu để thực hiện trực quan hóa của nó. 1
nhóm loại Nút nhóm loại xác định một tập hợp các loại được xác định bởi một tên duy nhất. Thông tin này có thể được sử dụng để xác định các kiểu dữ liệu được hỗ trợ bởi một thuộc tính cụ thể. 0 trở lên
thuộc tính phụ thuộc Xác định một nhóm các thuộc tính phụ thuộc. 0 trở lên
platform-action Được dùng để xác định các phụ thuộc điều khiển tải theo yêu cầu thay vì khi nào tải điều khiển. 0 hoặc 1

Ví dụ:

<control namespace="MyNameSpace"
   constructor="JSHelloWorldControl"
   version="1.0.0"
   display-name-key="JS_HelloWorldControl_Display_Key"
   description-key="JS_HelloWorldControl_Desc_Key"
   control-type="standard"
   preview-image="img/preview.png">
</control>

Tham khảo sơ đồ khuôn khổ cấu phần Power Apps
Tham khảo API khung thành phần Power Apps
Tổng quan về khuôn khổ cấu phần Power Apps

  • Last updated on