Thuộc tính thành phần bảng tùy biến (thử nghiệm)

Các thành phần canvas cho phép người tạo tạo các loại thuộc tính khác nhau để chuyển tiếp các giá trị hoặc logic giữa thành phần và ứng dụng đang lưu trữ thành phần . Thuộc tính là một phần thiết yếu trong việc tạo ra các thành phần tương tác và có thể tái sử dụng.

Các loại thuộc tính

Có bốn loại thuộc tính có sẵn cho các nhà sản xuất:

1. Thuộc tính dữ liệu: Thuộc tính dữ liệu liên quan đến dữ liệu, như giá trị màu hoặc văn bản. Thuộc tính Dữ liệu có thể được đặt thành Đầu vào hoặc Đầu ra, cho biết thành phần cung cấp dữ liệu cho ứng dụng (Đầu ra) hay ứng dụng cung cấp dữ liệu cho thành phần (Đầu vào ·). Thuộc tính dữ liệu là thuộc tính duy nhất tham gia vào luồng dữ liệu ứng dụng.
2. Thuộc tính hàm: Thuộc tính hàm có liên quan đến logic, chẳng hạn như thực hiện phép tính dựa trên các tham số cụ thể hoặc thay đổi văn bản. Thuộc tính Hàm có thể được đặt thành Đầu vào hoặc Đầu ra, cho biết thành phần có cung cấp hàm mà ứng dụng có thể gọi (Đầu ra) hay ứng dụng cung cấp hàm mà thành phần có thể gọi (Đầu vào ·). Thuộc tính hàm không tham gia vào luồng dữ liệu của ứng dụng và không thể sử dụng biến thành phần hoặc ứng dụng.
3. Thuộc tính hành động: Thuộc tính hành động là một loại thuộc tính xử lý logic và hoạt động giống như Hàm đầu ra. Do đó, thành phần có logic được xác định và logic đó có thể sử dụng các biểu thức được chuỗi và thao tác với các bộ sưu tập hoặc biến ("hành vi"). Ví dụ: Clear() thuộc tính Hành động có thể cung cấp chức năng mà ứng dụng có thể gọi để xóa một số giá trị trong thành phần hoặc thuộc tính Hành động Save() cập nhật nguồn dữ liệu.
4. Thuộc tính sự kiện: Thuộc tính sự kiện là một danh mục thuộc tính liên quan đến logic và các hàm như một Hàm đầu vào. Do đó, ứng dụng xác định logic mà thành phần có thể gọi và logic đó có thể sử dụng các biểu thức được chuỗi và thao tác với các bộ sưu tập hoặc biến ("hành vi"). Thông thường, tên của các thuộc tính này phản ánh một sự kiện, chẳng hạn như OnSelect hoặc OnChanged.

Thuộc tính dữ liệu

Việc sử dụng thuộc tính dữ liệu rất dễ hình dung. Các điều khiển tiêu chuẩn trong ứng dụng thường có một số thuộc tính dữ liệu, để đặt giá trị mặc định, màu văn bản, kích thước, v.v. Hãy xem xét một ví dụ đơn giản trong đó chúng ta muốn làm cho các thuộc tính của một điều khiển trong thành phần có sẵn cho ứng dụng lưu trữ. Trong ví dụ này, component của chúng ta được đặt tên Component1. Chúng tôi sẽ đặt một điều khiển thanh trượt vào bên trong thành phần của chúng tôi. Chúng ta sẽ có thuộc tính Đầu vào để chỉ định màu từ ứng dụng tiêu thụ và thuộc tính Đầu ra nơi thành phần có thể cho ứng dụng biết giá trị hiện tại của thanh trượt là gì. Ví dụ sau đây giả định thành phần của bạn chứa điều khiển Thanh trượt có Slider tên.

1. Trong ngăn thuộc tính của thành phần, chọn Thuộc tính tùy chỉnh mới.
2. Trên ngăn Thuộc tính tùy chỉnh mới, nhập tên Slider Color hiển thị.
3. Chọn Loại thuộc tính của Dữ liệu và chọn Đầu vào giá trị định nghĩa thuộc tính.
4. Cuối cùng, từ menu thả xuống Loại dữ liệu, chọn Màu.
5. Bấm Tạo.

Tiếp theo, chọn Slider1 điều khiển Thanh trượt . Tìm thuộc tính ValueFill của nó và trong thanh công thức, nhập . Component1.SliderColor Component1 đề cập đến tên của thành phần của chúng tôi và SliderColor là tên của thuộc tính mà chúng tôi đã thêm trước đó.

Bây giờ component của chúng ta có một SliderColor thuộc tính có thể được thiết lập trong ứng dụng tiêu thụ, để truyền một màu vào component để thiết lập thuộc tính ValueFill của thanh trượt.

Chúng tôi cũng muốn cung cấp giá trị của thanh trượt cho ứng dụng tiêu thụ. Để thực hiện điều này, chúng ta sẽ thêm một thuộc tính Output .

1. Trong ngăn thuộc tính của thành phần, chọn Thuộc tính tùy chỉnh mới.
2. Trên ngăn Thuộc tính tùy chỉnh mới, nhập tên hiển thị Slider Value.
3. Chọn Loại thuộc tính của Dữ liệu và chọn Đầu ra giá trị định nghĩa thuộc tính.
4. Cuối cùng, từ menu thả xuống Loại dữ liệu, chọn Số.
5. Bấm Tạo.

Khi thuộc tính Dữ liệu là Đầu ra, thành phần sẽ cung cấp giá trị cho ứng dụng tiêu thụ. Để đặt công thức cho điều này, chúng ta cần đặt thuộc tính mới SliderValue trong thành phần thành thuộc tính Giá trị của thanh trượt.

1. Trong ngăn thuộc tính của thành phần, nhấp vào Slider Value thuộc tính.
2. Trong thanh công thức, thay thế giá trị mặc định bằng 100 công thức sau: Slider1.Value.

Bây giờ thuộc tính component của chúng ta sẽ phản ánh giá trị của SliderValue thanh trượt bên trong component, sau đó có thể được đọc từ ứng dụng consumer.

Thuộc tính hàm

Thuộc tính hàm chứa biểu thức trả về giá trị. Thông thường, hàm lấy một số đối số mà nó sử dụng để tính toán hoặc xác định giá trị trả về.

Chức năng Đầu ra là một cách đơn giản để tạo một hàm tùy chỉnh cho Power Apps. Thành phần định nghĩa một hàm Output với một biểu thức lấy một số đối số và trả về một giá trị. Hàm này sau đó có thể được sử dụng trong một ứng dụng bằng cách sử dụng tên của thành phần (giả sử Component1) bằng cách gọi Component1.MyFunction(arg1, arg2).

Hàm Input là một cách để một ứng dụng tiêu thụ cung cấp logic cho một thành phần, tương tự như con trỏ hàm hoặc hàm gọi lại. Ví dụ: thành phần của bạn có thể đang xử lý tên của mọi người và có hàm đầu vào với các firstname đối số và lastname tôn trọng một chuỗi trở lại. Ứng dụng có thể xác định biểu thức hàm để trả về $"{firstname} {lastname}" hoặc nó có thể chọn xác định biểu thức cho $"{lastname}, {firstname}". Thành phần chỉ có thể gọi hàm mà nhà sản xuất ứng dụng đã cung cấp và sử dụng chuỗi trả về.

Thuộc tính hành động

Thuộc tính hành động tương tự như thuộc tính hàm của loại Đầu ra, nhưng chúng cho phép các công thức tác dụng phụ và chuỗi biểu thức. Một thành phần có thể có thuộc tính hành động được đặt tên AddRecord cho phép ứng dụng thêm bản ghi vào bộ sưu tập bên trong thành phần hoặc hành Reset động xóa các biến hoặc bộ sưu tập bên trong thành phần.

Trong ví dụ về các ví dụ thanh trượt được sử dụng cho thuộc tính Data trước đó, chúng ta có thể giới thiệu một thuộc tính action được gọi là ResetValue đặt thanh trượt trở lại giá trị mặc định của nó. Chúng ta có thể sử dụng công thức Reset( Slider1 ) cho việc này. Bây giờ, các phiên bản của thành phần của chúng ta trong ứng dụng có thể gọi Component1.ResetValue() để đặt thanh trượt trở lại giá trị mặc định.

Thuộc tính sự kiện

Có nhiều thuộc tính kiểu Sự kiện phổ biến, các thuộc tính chức năng hành vi đầu vào hiệu quả, trong các điều khiển tiêu chuẩn. OnSelect trên nút điều khiển là ví dụ rõ ràng nhất. Một thành phần có thể định nghĩa bất kỳ số lượng thuộc tính sự kiện nào và gọi các sự kiện này như một hàm. Ví dụ: một thành phần có điều khiển nút có thể có tên OnButtonClicked thuộc tính sự kiện. Trong OnSelect của điều khiển nút, thành phần có thể gọi thuộc tính của nó Component1.OnButtonClicked() . Sau đó, một ứng dụng tiêu thụ có thể xác định logic riêng của nó cho thuộc tính này, để hoạt động khi nhấn nút bên trong thành phần.

Giá trị mặc định cho thuộc tính hoặc đối số

Giá trị mặc định có thể cung cấp giá trị mặc định cho một đối số hoặc thuộc tính trong trường hợp không có giá trị nào được đặt. Điều này không có ý nghĩa đối với một số loại thuộc tính. Tuy nhiên, trong một số trường hợp, chúng có thể được sử dụng để cung cấp một lược đồ dự kiến cho một bản ghi. Bằng cách cung cấp bản ghi mặc định, loại bản ghi được thiết lập làm lược đồ dự kiến.

Ví dụ: thuộc tính Hành động có tên AddRecord chấp nhận bản ghi sẽ được thêm vào bộ sưu tập cục bộ. Để cung cấp lược đồ của bản ghi dự kiến, người tạo phải thêm giá trị mặc định cho đối số của thuộc tính này AddRecord .