Tuval bileşeni özellikleri (deneysel)

Tuval bileşenleri, oluşturucuların bileşen ile bileşeni barındıran uygulama arasında değerleri veya mantığı aktarmak için farklı türde özellikler oluşturmasına olanak tanır. Özellikler, etkileşimli ve yeniden kullanılabilir bileşenler oluşturmanın temel bir parçasıdır.

Özellik türleri

Oluşturucuların kullanabileceği dört özellik türü vardır:

1. Veri özellikleri: Veri özellikleri, renk veya metin değeri gibi verilerle ilgilidir. Veri özelliği Girdi veya Çıktı olarak ayarlanabilir ve bu durum, bileşenin uygulamaya veri sağladığını (Çıktı) veya uygulamanın bileşene veri sağladığını (Girdi) belirtir. Veri özellikleri yalnızca uygulama veri akışına katılan özelliklerdir.
2. İşlev özellikleri: İşlev özellikleri, belirli parametrelere dayalı bir hesaplama gerçekleştirme veya metni değiştirme gibi mantıkla ilgilidir. İşlev özelliği Input veya Output olarak ayarlanabilir ve bu durum, bileşenin uygulamanın çağırabildiği bir işlev sağladığını (Output) veya uygulamanın bileşenin çağırabildiği bir işlev sağladığını (Input) belirtir. İşlev özellikleri, uygulamanın veri akışına katılmaz ve bileşen veya uygulama değişkenlerini kullanamaz.
3. Eylem özellikleri: Eylem özellikleri, mantıkla ilgili olan ve Output İşlevi gibi davranan bir özellik türüdür. Bu nedenle bileşen, tanımlanmış bir mantığa sahiptir ve bu mantıkta zincirleme ifadeler kullanılabilir ve koleksiyonlar veya değişkenler ("davranış") işlenebilir. Örneğin, Clear() Eylem özelliği uygulamanın bileşendeki bazı değerleri temizlemek için çağırabileceği işlevselliği sağlayabilir veya Save() Eylem özelliği ise bir veri kaynağını güncelleştirebilir.
4. Olay özellikleri: Olay özellikleri, mantık ve Input İşlevi gibi işlevler içeren bir özellik kategorisidir. Bu nedenle uygulama, bileşenin çağırabildiği mantığı tanımlar ve bu mantıkta zincirleme ifadeler kullanılabilir ve koleksiyonlar veya değişkenler ("davranış") işlenebilir. Genellikle bu özelliklerin adları, OnSelect veya OnChanged gibi bir olayı yansıtır.

Veri özelliği

Veri özelliğinin kullanımı kolay anlaşılabilir. Uygulamalardaki standart denetimlerde genellikle varsayılan değerleri, metin rengini, boyutunu vb. ayarlamak için çeşitli veri özellikleri bulunur. Barındırma uygulaması için mevcut bileşen içindeki bir denetimin özelliklerini oluşturmak istediğimiz basit bir örneğe bakalım. Bu örnekte bileşenimiz Component1 olarak adlandırılmıştır. Bileşenimizin içine bir kaydırıcı denetimi ekleyeceğiz. Tüketen uygulamadaki rengi belirtmek için bir Girdi özelliğimiz ve bileşenin uygulamaya geçerli kaydırıcı değerinin ne olduğunu söyleyebileceği bir Çıktı özelliğimiz olacak. Aşağıdaki örnekte, bileşeninizin Slider adlı bir Kaydırıcı denetimi içerdiği varsayılmaktadır.

1. Bileşenin özellik bölmesinde Yeni özel özellik'i seçin.
2. Yeni özel özellik bölmesinde Slider Color görünen adını girin.
3. Özellik türü'nü Veri olarak ve Özellik tanımı değerini Girdi olarak seçin.
4. Son olarak Veri türü açılan listesinden Renk'i seçin.
5. Oluştur'a tıklayın.

Şimdi de Slider1 Kaydırıcı denetimini seçin. ValueFill özelliğini bulun ve formül çubuğuna Component1.SliderColor girin. Component1, bileşenimizin adını ifade eder ve SliderColor, daha önce eklediğimiz özelliğin adıdır.

Artık bileşenimizde, kaydırıcının ValueFill özelliğini ayarlamak için bileşene renk aktarmak üzere tüketen uygulamada ayarlanabilecek bir SliderColor özelliği vardır.

Ayrıca tüketen uygulama için kaydırıcının değerini sağlamak istiyoruz. Bunu yapmak için bir Çıktı özelliği ekleyeceğiz.

1. Bileşenin özellik bölmesinde Yeni özel özellik'i seçin.
2. Yeni özel özellik bölmesinde Slider Value görünen adını girin.
3. Özellik türü'nü Veri olarak ve Özellik tanımı değerini Çıktı olarak seçin.
4. Son olarak Veri türü açılan listesinden Numara'yı seçin.
5. Oluştur'a tıklayın.

Veri özelliği Çıktı olduğunda bileşen, tüketen uygulamaya değeri sağlar. Bunun için formülü ayarlamak üzere bileşendeki yeni SliderValue özelliğini kaydırıcının Değer özelliği olarak ayarlamamız gerekir.

1. Bileşenin özellik bölmesinde Slider Value özelliğine tıklayın.
2. Formül çubuğunda, 100 varsayılan değerini şu formülle değiştirin: Slider1.Value.

Artık bileşenimizin SliderValue özelliği, bileşenin içindeki kaydırıcının değerini yansıtacaktır ve bu daha sonra tüketen uygulamadan okunabilir.

İşlev özelliği

İşlev özelliği, değer döndüren bir ifade içerir. Genellikle işlev, bazı bağımsız değişkenleri alıp döndürülecek değeri hesaplamak veya belirlemek için kullanır.

Output işlevi, Power Apps için özel işlev oluşturmanın basit bir yoludur. Bileşen, bazı bağımsız değerleri alıp değer döndüren bir ifadeyle Output işlevi tanımlar. Bu işlev daha sonra Component1.MyFunction(arg1, arg2) çağrılıp bileşenin adını (ör. Component1) kullanarak bir uygulamada kullanılabilir.

Input işlevi, tüketen uygulamanın, işlev işaretçisi veya callback işlevine benzer şekilde bileşene mantık sağlamasının bir yoludur. Örneğin, bileşeniniz kişilerin adlarıyla ilgili olabilir ve firstname ve lastname bağımsız değişkenleriyle input işlevine sahip olabilir ve tekrar bir dizeye uyar. Uygulama, $"{firstname} {lastname}" döndürmek için işlev ifadesini tanımlayabilir veya $"{lastname}, {firstname}" için bir ifade tanımlamayı seçebilir. Bileşen yalnızca uygulama oluşturucunun sağladığı işlevi çağırabilir ve döndürülen dizeyi kullanabilir.

Eylem özelliği

Eylem özellikleri, Output türündeki işlev özelliklerine benzer ancak yan etki formüllerine ve zincirleme ifadeye izin verir. Bileşende, uygulamanın bileşen içindeki bir koleksiyona kayıt eklemesine izin veren AddRecord adlı bir eylem özelliği veya bileşen içindeki değişkenleri ya da koleksiyonları temizleyen bir Reset eylemi bulunabilir.

Daha önce Veri özelliği için kullanılan kaydırıcı örneğinde, kaydırıcıyı varsayılan değerine geri döndürmek için ResetValue adlı bir eylem özelliği kullanıma sunabiliriz. Bunun için Reset( Slider1 ) formülünü kullanabiliriz. Artık uygulamada bileşenimizin kurulumlarında, kaydırıcıyı varsayılan değere geri döndürmek için Component1.ResetValue() çağırılabilir.

Olay özelliği

Standart denetimlerde, input behavior işlevi özelliklerinde etkili olan birçok yaygın Olay türünde özellik vardır. Düğme denetimindeki OnSelect, en açık örnektir. Bileşen, herhangi bir sayıda olay özelliği tanımlayabilir ve bu olayları bir işlev gibi çağırabilir. Örneğin, düğme denetimi olan bir bileşende OnButtonClicked adlı bir olay özelliği bulunabilir. Düğme denetiminin OnSelect öğesinde bileşen, Component1.OnButtonClicked() özelliğini çağırabilir. Daha sonra tüketen uygulama, bileşenin içindeki düğmeye basıldığında harekete geçecek şekilde bu özellik için kendi mantığını tanımlayabilir.

Özellikler veya bağımsız değişkenler için varsayılan değerler

Varsayılan değerler, ayarlanmaması durumunda bağımsız değişken veya özellik için varsayılan bir değer sağlayabilir. Bu, bazı özellik türleri için anlamlı değildir. Ancak bazı durumlarda kayıt için beklenen bir şema sağlamak üzere kullanılabilirler. Varsayılan bir kayıt sağlayarak, beklenen şema olarak kayıt türü oluşturulur.

Örneğin, AddRecord adlı bir Eylem özelliği, yerel koleksiyona eklenecek bir kaydı kabul eder. Beklenen kaydın şemasını sağlamak üzere bir oluşturucunun, bu AddRecord özelliğinin bağımsız değişkeni için varsayılan değer olarak eklenmesi gerekir.