Tuval bileşenine genel bakış

Not

• Bu bölümde, düşük kodlu kullanıcı arabirimi genişletilebilirlik özelliklerini kapsayan tuval bileşenleri açıklanmaktadır. Profesyonel geliştiriciler kod bileşenleri oluşturmak için Power Apps bileşen çerçevesi da kullanabilir.
• Özel sayfaları ve bileşen kitaplığını kullanarak model temelli uygulamalarda tuval bileşenlerini de kullanabilirsiniz. Daha fazla bilgi için bkz. Model temelli uygulamada özel bir sayfaya tuval bileşenleri ekleme.

Bileşenler, tuval uygulamaları için yeniden kullanılabilir yapı taşlarıdır. Uygulama oluşturucular, bir uygulama içinde veya bir bileşen kitaplığı kullanarak uygulamalar arasında kullanmak üzere özel denetimler oluşturabilir. Bileşenler, özel özellikler gibi gelişmiş özellikleri kullanabilir ve karmaşık yetenekleri etkinleştirebilir. Bu makalede, bileşen kavramları ve bazı örnekler tanıtılmaktadır.

Bileşenler, benzer denetim desenlerine sahip daha büyük uygulamalar oluştururken kullanışlıdır. Uygulamanın içinde bir bileşen tanımını güncelleştirirseniz, uygulamadaki tüm örnekler değişikliklerinizi yansıtır. Bileşenler ayrıca denetimleri kopyalayıp yapıştırma gereksinimini ortadan kaldırarak ve performansı geliştirerek eforun yinelenme oranını azaltır. Bileşen kitaplığı kullandığınızda, bileşenler işbirliğine dayalı geliştirme oluşturmaya ve kuruluşta genel görünümü standartlaştırmaya yardımcı olur.

Tuval uygulamalarında bileşenlerin nasıl kullanılacağını öğrenmek için şu videoyu izleyin:

Canvas uygulamalarındaki bileşenler

Bu makalede açıklandığı üzere bir uygulamanın içinden veya bir bileşen kitaplığı içinde yeni bir bileşen oluşturabilirsiniz. Bileşenleri birden çok uygulama ekranında kullanmanız gerektiğinde bir bileşen kitaplığı kullanın. Ayrıca mevcut bileşenleri var olan veya yeni bir bileşen kitaplığına kopyalayabilirsiniz.

Bir uygulama içinde bileşen oluşturmak için, Ağaç Görünümü'ne gidin, Bileşenler sekmesini ve ardından Yeni bileşen' i seçin.

Yeni bileşen seçilirse boş bir tuval açılır. Denetimleri tuvaldeki bileşen tanımının bir parçası olarak ekleyin. Tuvaldeki bir bileşeni düzenlerseniz, diğer uygulama ekranlarında aynı bileşenin örneklerini güncelleştirirsiniz. Daha önce oluşturulmuş bir bileşeni yeniden kullanan uygulamalar, siz bileşen değişikliklerini yayımladıktan sonra da bileşen güncelleştirmelerini alabilir.

Bir ekran seçtikten sonra sol bölmedeki mevcut bileşenler listesinden bir bileşen seçebilirsiniz. Bir bileşeni seçtiğinizde, bir denetimi eklediğiniz gibi, o bileşenin bir örneğini ekrana eklersiniz.

Uygulamanın içinde bulunan bileşenler, ağaç görünümünün içindeki bileşenler listesinde Özel kategorisinin altında görünür. Bileşen kitaplıklarından içeri aktarılan bileşenler Kitaplık bileşenleri kategorisi altında görünür:

Not

Bu makalede ele alınan bileşenler, geliştiricilerin ve oluşturucuların model temelli ve tuval uygulamaları için kod bileşenleri oluşturmasına olanak tanıyan Power Apps bileşen çerçevesinden farklıdır. Daha fazla bilgi için bkz. Power Apps bileşen çerçevesine genel bakış.

Özel özellikler

Bir veya daha fazla özel özellik oluşturursanız bir bileşen giriş değerleri alabilir ve veri yayabilir. Bu senaryolar ileri düzeyde senaryolar olup, formülleri ve bağlayıcı sözleşmeleri anlamanızı gerektirir.

Not

Gelişmiş bileşen özellikleri için deneysel bir özellik, özellikler için işlevler ve fonksiyonel davranışlar dahil olmak üzere daha fazla seçenek sağlar. Daha fazla bilgi için bkz. Tuval bileşeni özellikleri (deneysel)

Giriş özelliği, bir bileşenin bileşende kullanılacak verileri nasıl aldığını tanımlar. Bileşenin bir örneği seçiliyse, giriş özellikleri, sağ taraftaki bölmenin Özellikler sekmesinde görünür. Diğer denetimlerde standart özellikleri yapılandırdığınız gibi, giriş özelliklerini ifade veya formüllerle yapılandırabilirsiniz. Diğer denetimlerin, bir Metin giriş denetiminin Default özelliği gibi giriş özellikleri vardır.

Çıkış özelliği, verileri veya bileşen durumunu çıkarmak için kullanılır. Örneğin bir Galeri denetimindeki Selected özelliği bir çıkış özelliğidir. Bir çıkış özelliği oluşturduğunuzda, diğer denetimlerden hangilerinin bileşen durumuna başvurabileceğine karar verebilirsiniz.

Bu kavramlar aşağıda adım adım açıklanmaktadır.

Örnek bileşen oluşturma

Bu örnekte, aşağıdaki grafiğe benzeyen bir menü bileşeni oluşturacaksınız. Ayrıca, metni daha sonra birden çok ekran ve/veya uygulamada kullanmak üzere değiştirebilirsiniz:

Not

Yeniden kullanmak üzere bileşenler oluştururken bir bileşen kitaplığı kullanmanızı öneririz. Bir uygulama içindeki bileşenlerin güncelleştirilmesi, bileşen güncelleştirmelerini yalnızca uygulama içinde kullanılabilir hale getirir. Bileşen kitaplığı kullanırken kitaplık içindeki bileşenler güncelleştirilip yayımlanırsa bileşenleri güncelleştirmeniz istenir.

Yeni bir bileşen oluşturma

1. Boş tuval uygulaması oluşturun.

2. Yeni bir bileşen oluşturmak için, Ağaç Görünümü'ne gidin, Bileşenler'i ve ardından Yeni bileşen'i seçin.

   

3. Sol bölmedeki yeni bileşeni seçin, üç noktayı (...) seçin ve ardından Yeniden adlandır'ı seçin. Ad olarak MenuComponent yazın veya yapıştırın.

4. Sağdaki bölmede, bileşenin genişliğini 150 ve yüksekliğini 250 olarak ayarlayıp Yeni özel özellik'i seçin. Yükseklik ve genişliği başka bir uygun değere de ayarlayabilirsiniz.

   

5. Görünen ad, Özellik adı ve Açıklama kutularında metni Items olarak yazın veya yapıştırın.

   

   Özellik adına boşluk eklemeyin çünkü bir formül yazarken bileşene bu adla başvuracaksınız. Örneğin BileşenAdı.ÖzellikAdı.

   Bileşeni seçerseniz, görünen ad sağ bölmedeki Özellikler sekmesinde görünür. Tanımlayıcı bir görünen ad, sizin ve diğer geliştiricilerin bu özelliğin amacını anlamasına yardımcı olur. Özellikler sekmesinde bu özelliğin görünen adının üzerine geldiğinizde araç ipucunda Açıklama görünür.

6. Veri türü listesinde Tablo'yu ve ardından Oluştur'u seçin.

   

   Items özelliği, belirttiğiniz veri türüne bağlı olarak bir varsayılan değere ayarlanır. Bunu gereksinimlerinize uygun bir değere ayarlayabilirsiniz. Veri türünü Tablo veya Kayıt olarak belirlediyseniz, Items özelliğinin değerini, bileşene girmek istediğiniz veri şemasıyla eşleşecek şekilde değiştirmek isteyebilirsiniz. Bu durumda, bunu bir dize listesi olarak değiştirirsiniz.

   Sağ bölmedeki Özellikler sekmesinde özelliğin adını seçerseniz, özelliğin değerini formül çubuğunda ayarlayabilirsiniz.

   

   Sonraki grafikte gösterildiği gibi, sağ bölmenin Gelişmiş sekmesinde özelliğin değerini de düzenleyebilirsiniz.

7. Bileşenin Items özelliğini şu formüle ayarlayın:

   Table({Item:"SampleText"})
   

   

8. Bileşende boş bir dikey Galeri denetimi ekleyin ve özellik bölmesinde Başlık olarak Düzen'i seçin.

9. Özellik listesinde Items özelliğinin (varsayılan olarak yaptığı gibi) gösterildiğinden emin olun. Ardından bu özelliğin değerini şu ifade olarak ayarlayın:

   MenuComponent.Items
   

   Bu şekilde, Galeri denetiminin Items özelliği, bileşenin Items giriş özelliğinin değerini alır ve ona bağlıdır.

10. (İsteğe bağlı) Galeri denetiminin BorderThickness özelliğini 1 , TemplateSize özelliğini 50 olarak ayarlayın. Kenarlık kalınlığı ve şablon boyutu değerlerini de uygun herhangi bir değere güncelleştirebilirsiniz.

Ekrana bileşen ekleme

Ardından, bileşeni bir ekrana ekleyin ve bileşenin göstermesi için bir dize tablosu belirtin.

1. Sol bölmede, ekranlar listesini seçin ve ardından varsayılan ekranı seçin.

   

2. Ekle sekmesinde Bileşenler menüsünü açın ve ardından MenuComponent öğesini seçin.

   

   Yeni bileşene varsayılan olarak MenuComponent_1 adı verilir.

3. MenuComponent_1 öğesinin Items özelliğini şu formüle ayarlayın:

   Table({Item:"Home"}, {Item:"Admin"}, {Item:"About"}, {Item:"Help"})
   

   Bu örnek bu grafiğe benzemez ancak her bir örneğin metnini ve diğer özelliklerini özelleştirebilirsiniz.

   

Çıkış özelliğini oluşturma ve kullanma

Şu ana kadar bir bileşen oluşturdunuz ve bunu bir uygulamaya eklediniz. Ardından, kullanıcının menüden seçtiği öğeyi yansıtan bir çıkış özelliği oluşturun.

1. Bileşenler listesini açın ve MenuComponent öğesini seçin.

2. Sağdaki bölmede Özellikler sekmesini ve ardından Yeni özel özellik öğesini seçin.

3. Görünen ad, Özellik adı ve Açıklama kutularında Selected metnini yazın veya yapıştırın.

4. Özellik türü altında, Çıkış'ı ve ardından Oluştur'u seçin.

   

5. Gelişmiş sekmesinde, gerekirse, galeri adındaki sayıyı ayarlayarak, Selected özelliğinin değerini bu ifadeye ayarlayın:

   Gallery1.Selected.Item
   

   

6. Gerekirse bileşen adındaki sayıyı ayarlayarak, uygulamanın varsayılan ekranında bir etiket ekleyin ve Text özelliğini bu ifadeye ayarlayın:

   MenuComponent_1.Selected
   

   MenuComponent_1, bileşen tanımının adı değil, bir örneğin varsayılan adıdır. Tüm örnekleri yeniden adlandırabilirsiniz.

7. Alt tuşunu basılı tutarak menüdeki her bir öğeyi seçin.

   Etiket denetimi, en son seçtiğiniz menü öğesini yansıtır.

Scope

Giriş ve çıkış özellikleri, bir bileşen ile ana bilgisayar uygulaması arasındaki arabirimi açıkça tanımlar. Varsayılan olarak, bileşen kapsüllenir; bu sayede bileşenin farklı uygulamalarda yeniden kullanılması kolaylaşır. Bileşene bilgi aktarıp almak için bileşen özelliklerinin kullanılması gerekir. Kapsam kısıtlamaları bir bileşenin veri sözleşmesini basit ve uyumlu tutar ve özellikle bileşen kitaplığı olan uygulamalar arasında bileşen tanımı güncelleştirmelerinin yapılabilmesine yardımcı olur.

Ancak, bir bileşenin bir veri kaynağını veya değişkeni konağıyla paylaşmak isteyebileceği zamanlar vardır. Bu paylaşım özellikle bileşen yalnızca belirli bir uygulamada kullanılmak üzere tasarlandıysa kullanışlıdır. Bu gibi durumlar için, bileşenin özellik bölmesindeki Uygulama kapsamına eriş anahtarını etkinleştirerek uygulama düzeyi bilgilerine doğrudan erişebilirsiniz:

Access uygulama kapsamını açtığınızda, aşağıdaki öğelere bir bileşenin içinden erişilebilir:

• Genel değişkenler
• Koleksiyonlar
• Ekranlardaki kontroller ve bileşenler, örneğin bir TextInput kontrolü gibi
• Dataverse tabloları gibi tablosal veri kaynakları

Bu ayarı kapattığınızda, bileşen önceki öğelerden herhangi birine erişemez.  Set ve Collect işlevleri hala kullanılabilir ancak sonuçta elde edilen değişkenlerin ve koleksiyonların kapsamı bileşen örneğine göre belirlenmiştir ve uygulamayla paylaşılmamaktadır.

Azure Blob Storage veya özel bağlayıcı gibi tablosal olmayan veri kaynakları, bu ayarın açık veya kapalı olmasına bakılmaksızın kullanılabilir. Bu veri kaynaklarını, bir uygulama kaynağı yerine ortam kaynağına başvuru gibi düşünün. Bileşen, bileşen kitaplığından bir uygulamaya getirildiğinde, ortamdan bu veri kaynakları da kullanıma alınır.

Bir bileşen kitaplığındaki bileşenler hiçbir zaman uygulama kapsamına erişemez çünkü başvurulabilecek tek bir uygulama kapsamı yoktur. Bu nedenle, bu ayar bu bağlamda kullanılamaz ve etkin bir şekilde devre dışı olur. Bir uygulamaya aktarıldıktan sonra ve bileşen oluşturucu tarafından özelleştirmeye izin veriliyorsa, anahtar etkinleştirilebilir ve bileşen uygulama kapsamını kullanacak şekilde değiştirilebilir.

Not

• Bileşen kitaplığı içinde bir ekrana bileşen örnekleri ekleyebilir ve sınama amacıyla bu ekranı önizleyebilirsiniz.
• Power Apps Mobile kullanılırken bileşen kitaplığı görüntülenmez.

Bileşenleri dışarı ve içeri aktarma (kullanım dışı)

Not

Bu özellik, kullanımdan kaldırılmıştır. Bileşen kitaplıkları, bileşenlerin uygulamalar arasında yeniden kullanılmasının önerilen yoludur. Bileşen kitaplığı kullanılırken, uygulama, kullandığı bileşenlere olan bağımlılıkları korur. Bağımlı bileşenlere yönelik güncelleştirmeler kullanılabilir olduğunda uygulama oluşturucu uyarılır. Bu nedenle, bunun yerine, tüm yeniden kullanılabilir yeni bileşenler, bileşen kitaplıkları içinde oluşturulmalıdır.

Bu özellik kullanımdan kaldırıldığından bileşenleri içeri ve dışarı aktarma özelliği varsayılan olarak devre dışı bırakılır. Bileşenlerle çalışmak için önerilen yöntem bileşen kitaplıklarını kullanmak olsa da, özellik kaldırılana kadar bu özelliği uygulama başına özel durum olarak etkinleştirmeye devam edebilirsiniz. Bunu yapmak için, Power Apps Studio'da uygulamanızı düzenleyin, ardından Ayarlar>Gelecek Özellikler>Kullanımdan Kaldırıldı> bölümüne gidin ve Bileşenleri dışarı ve içeri aktar'ı Açık olarak ayarlayın.

Bu özelliği etkinleştirdikten sonra, bileşenleri içeri ve dışarı aktarmak için aşağıdaki özellikleri kullanabilirsiniz.

Başka bir uygulamadan bileşenleri alma

Bir veya daha fazla bileşeni bir uygulamadan başka bir uygulamaya aktarmak için Eklemenüsünden Bileşenleri içeri aktar'ı seçin ve özel açılan menüsünü kullanın. Bunun yerine, sol bölmedeki ağaç görünümünde Bileşenler'i kullanabilirsiniz.

Bir iletişim kutusu, düzenleme izniniz olan bileşenlerin bulunduğu tüm uygulamaları listeler. Bir uygulama seçin ve ardından o uygulamadaki tüm bileşenlerin en son yayımlanmış sürümünü almak için Al'ı seçin. En az bir bileşeni içeri aktardıktan sonra, kopyanızı düzenleyebilir ve ihtiyacınız olmayan bileşenleri silebilirsiniz.

Varolan bileşenlerle bir uygulamayı yerel olarak bir dosyaya kaydedebilir ve sonra dosyayı alarak yeniden kullanabilirsiniz. Dosyayı başka bir uygulamaya bileşen almak için kullanabilirsiniz.

Uygulamada aynı bileşenin değiştirilmiş bir sürümü varsa, değiştirilen sürümü değiştirmeye veya alma işlemini iptal etmeye karar vermeniz istenir.

Bir uygulamada bileşenler oluşturduktan sonra diğer uygulamalar bu uygulamadaki bileşenleri içeri aktararak kullanabilir.

Not

Başka bir uygulamadan içe aktardığınız bir bileşen orijinal uygulamada değiştirilirse en son bileşen değişikliklerini almak için bileşeni tüketen uygulamada yeniden el ile içe aktarmanız gerekir. Bileşen güncelleştirmeleri ile daha verimli çalışmak için bunun yerine bileşen kitaplıklarını kullanın.

Uygulamanızdan bileşenleri dışarı aktarma

Bileşenleri bir dosyaya dışarı aktarabilir ve başka bir uygulamaya içeri aktarmak üzere indirebilirsiniz.

Sol bölmede yer alan ağaç görünümündeki Bileşenler bölümünden Bileşenleri dışarı aktar seçeneğini belirleyin:

Ayrıca Ekle menüsünü kullanabilir ve bunun yerine Özel açılan menüsünü de seçebilirsiniz.

Bileşenleri ver seçilince bileşenler bir dosyaya indirilir:

İndirilen bileşen dosyası .msapp dosya adı uzantısını kullanır.

Dışa aktarılmış bileşenler dosyasından bileşenleri içe aktarma

Dışarı aktarılan bileşenler dosyasından bileşenleri içeri aktarmak için Ekle menüsünden Bileşenleri içeri aktarı'ı seçip Özel açılan menüsünü kullanın veya sol bölmedeki ağaç görünümünde Bileşenler'i kullanın. Bileşenler iletişim kutusunda, başka bileşen veya uygulama seçmek yerine Dosyayı karşıya yükle'yi seçin:

Aç iletişim kutusunda bileşen dosyasının konumuna göz atın ve bileşenleri uygulamaya almak için Aç'ı seçin.

İhraç edilmiş uygulamadan bileşenleri alma

Dosya>Farklı Kaydet'i seçerek bir uygulamayı yerel olarak kaydedebilirsiniz:

Uygulamayı kaydettikten sonra, bileşenlerini bir dosyadan içeri aktararak yeniden kullanabilirsiniz. Daha fazla bilgi için, dışarı aktarılan bileşenler dosyasından bileşenleri içeri aktarmayla ilgili önceki bölüme bakın.

Bilinen sınırlamalar

• Bir uygulamada aynı bileşenin iki veya daha fazla örneği varsa, özel giriş özelliğini aynı veya farklı örnekler arasında özel bir çıkış özelliği değeri olarak yapılandıramazsınız. Bu eylem döngüsel başvuru uyarı mesajı almanıza neden olur. Bu sınırlamayı geçici olarak çözmek için uygulamanızın içinde bileşenin bir kopyasını oluşturun.
• Bileşen kitaplıklarında Power Automate akışları ekleme ve çalıştırma desteklenmez.
• Bileşenlerle, bu veri kaynaklarından (form, akıcı ızgaralar veya veri tabloları gibi) veri içeren veri kaynaklarını veya denetimlerini kaydedemezsiniz.
• Galeriye veya forma (SharePoint form dahil) bileşen ekleyemezsiniz.
• Bileşenler, UpdateContext işlevini desteklemez ancak bir bileşendeki değişkenleri Set işlevini kullanarak oluşturabilir ve güncelleştirebilirsiniz. Bu değişkenlerin kapsamı bileşenle sınırlıdır ancak bunlara özel çıkış özellikleri aracılığıyla bileşenin dışından erişebilirsiniz.

Sonraki adımlar

Yeniden kullanılabilir bileşenler deposu oluşturmak için bileşen kitaplığı kullanmayı öğrenin.

Ayrıca bkz.

• Bileşen kitaplığı
• Bileşen kitaplığı uygulaması yaşam döngüsü yönetimi (ALM)
• Bir bileşenin giriş alanlarını eşleme
• Bileşene multimedya ekleme
• Bileşenler için davranış formülleri
• Power Apps bileşen çerçevesi
• Model temelli bir uygulamada özel bir sayfaya tuval bileşenleri ekleme