Chia sẻ qua

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

  • Bài viết

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 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.

Quan trọng

Các loại tài sản

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 sắc 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 của hàm: Thuộc tính của 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 Chức năng có thể được đặt thành Đầu vào hoặc Đầu ra, cho biết thành phần có cung cấp chức năng mà ứng dụng có thể gọi (Đầu ra) hay ứng dụng cung cấp chức năng 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 các 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à loại thuộc tính xử lý logic và hoạt động giống như một Đầu ra Hàm. Do đó, thành phần này có logic được xác định và logic đó có thể sử dụng các biểu thức được xâu chuỗi và thao tác với các bộ sưu tập hoặc biến ("hành vi"). Ví dụ: thuộc tính Clear() 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 Save() Hành động thuộc tính 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 loại thuộc tính liên quan đến logic và các chức năng như một Đầu vào Hàm. 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 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 như OnSelect hoặc OnChanged.

Thuộc tính dữ liệu

Cách 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 một ví dụ đơn giản trong đó chúng tôi muốn cung cấp các thuộc tính của điều khiển trong thành phần cho ứng dụng lưu trữ. Trong ví dụ này, thành phần của chúng tôi có tên Component1. Chúng ta sẽ đặt một thanh trượt điều khiển bên trong thành phần của mình. Chúng ta sẽ có thuộc tính Input để chỉ định màu từ ứng dụng sử dụng và thuộc tính Output trong đó thành phần có thể cho ứng dụng biết giá trị hiện tại của thanh trượt là bao nhiêu. Ví dụ sau đây giả sử thành phần của bạn chứa Thanh trượt điều khiển có tên Slider.

  1. Trong ngăn thuộc tính của thành phần, hãy 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, hãy nhập tên hiển thị Slider Color.
  3. Chọn Loại thuộc tính của Dữ liệu và chọn Định nghĩa thuộc tính giá trị Đầu vào.
  4. Cuối cùng, từ trình đơn thả xuống Loại dữ liệu, hãy chọn Màu.
  5. Bấm Tạo.

Tiếp theo, chọn điều khiển Slider1 Thanh trượt . Tìm thuộc tính ValueFill của nó và nhập Component1.SliderColor vào thanh công thức. Component1 đề cập đến tên 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ờ, thành phần của chúng ta có một thuộc tính SliderColor có thể được đặt trong ứng dụng tiêu dùng, để chuyển màu vào thành phần nhằm đặt thuộc tính ValueFill của thanh trượt.

Chúng tôi cũng mong muốn cung cấp giá trị của thanh trượt cho ứng dụng tiêu dùng. Để 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, hãy 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, hãy 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 Định nghĩa thuộc tính giá trị Đầu ra.
  4. Cuối cùng, từ trình đơn thả xuống Loại dữ liệu, hãy chọn Số.
  5. Bấm Tạo.

Khi thuộc tính Dữ liệu là Đầu ra, thành phần này sẽ cung cấp giá trị cho ứng dụng sử dụng. Để đặt công thức cho việc này, chúng ta cần đặt thuộc tính SliderValue mới 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 thuộc tính Slider Value .
  2. Trong thanh công thức, thay thế giá trị mặc định của 100 bằng công thức sau: Slider1.Value.

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

Thuộc tính chức năng

Thuộc tính hàm chứa một biểu thức trả về một 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ị cần trả về.

Lưu ý

Thuộc tính hàm hiện không thể truy cập các biến hoặc giá trị thành phần và thuộc tính cũng như không thể kích hoạt luồng dữ liệu. Mọi giá trị bắt buộc phải được chuyển vào dưới dạng đối số.

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

Hàm Đầu vào là một cách để ứ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ể xử lý tên của mọi người và có chức năng nhập với các đối số firstname và lastname và tôn trọng một chuỗi ngược lại. Ứng dụng có thể xác định biểu thức hàm để trả về $"{firstname} {lastname}" hoặc có thể chọn xác định biểu thức cho $"{lastname}, {firstname}". Thành phần này 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ê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 động Reset 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ụ về thanh trượt được sử dụng cho Thuộc tính dữ liệu trước đó, chúng ta có thể giới thiệu một thuộc tính hành động có tên ResetValue để đặt thanh trượt trở về mặc định giá trị. Chúng ta có thể sử dụng công thức Reset( Slider1 ) cho việc này. Giờ đây, các phiên bản thành phần của chúng tôi trong ứng dụng có thể gọi Component1.ResetValue() để đặt thanh trượt về giá trị mặc định.

Thuộc tính sự kiện

Có nhiều thuộc tính loại Sự kiện phổ biến, các thuộc tính hàm 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ể xác định số lượng thuộc tính sự kiện bất kỳ và gọi những sự kiện này giống như một hàm. Ví dụ: một thành phần có nút điều khiển có thể có thuộc tính sự kiện có tên OnButtonClicked. Trong OnSelect của điều khiển nút, thành phần có thể gọi thuộc tính Component1.OnButtonClicked() của nó. 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ố

Các 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 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ụ: một thuộc tính Hành động có tên AddRecord chấp nhận một bản ghi để đượ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 .