Tuval uygulamaları için bileşen oluşturma

Önemli

Bu özellik hala genel önizleme olarak sunulmaktadır. Daha fazla bilgi için bkz. Deneysel özellikler ve önizleme özellikleri.

Bileşenler tuval uygulamaları için yeniden kullanılabilir yapı taşlarıdır; böylece, uygulama yapanlar bir uygulama içinde veya bir bileşen kitaplığını kullanarak uygulamalar arasında kullanılacak özel denetimler oluşturabilirler. 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 desenleri olan daha büyük uygulamalar oluşturmak için yararlı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 denetimleri kopyalama/yapıştırma ve performansı artırma gereğini ortadan kaldırarak çalışmaların yinelenmesini de azaltır. Bileşenler, bileşen kitaplığı kullandığınız zaman, kuruluşta ortak geliştirme ortamı oluşturmanıza ve görünümü standartlaştırmanıza yardımcı olur.

Tuval uygulamalarında 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 kullanma gereksinimleri için bir bileşen kitaplığı kullanılmalıdır. Varolan bileşenleri varolan veya yeni bir bileşen kitaplığına da 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.

Ağaç görünümünü kullanarak yeni özel bileşen oluşturma

Yeni bileşen seçilirse boş bir tuval açılır. Bileşen tanımının bir parçası olarak tuvallere denetimler ekleyebilirsiniz. Tuvaldeki bir bileşeni düzenlerseniz, diğer uygulama ekranlarındaki aynı bileşenin örneklerini güncelleştireceksiniz. 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 gezinti bölmesindeki varolan 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ü içindeki bileşenler listesinde Özel kategorisi altında listelenir. Bileşen kitaplıklarından alınan bileşenler Kitaplık bileşenleri kategorisi altında listelenir:

Uygulamaya bileşenler ekleme

Not

Bu makalede açıklanan bileşenler, geliştiricilerin ve oluşturucuların model yönetimli uygulamalar ve tuval uygulamaları için kod bileşenleri oluşturmalarını sağlayan Power Apps component framework'ten farklıdır. Daha fazla bilgi için, Power Apps component framework'e genel bakış'a gidin.

Scope

Bir bileşeni, arabirim olarak, özellikler içeren kapsüllenmiş bir siyah bir kutu olarak düşünebilirsiniz. Bileşen içindeki denetimlere bileşen dışından erişemezsiniz. Ve bileşen içinden bileşenin dışındaki herhangi bir şeye başvuramazsınız. Özel durum, bir uygulama ve bileşenleri arasında paylaşılan veri kaynaklarıdır. 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. Bir veya daha fazla özel özellik oluşturarak, bileşenin veri sözleşmesini güncelleştirebilirsiniz.

Not

Bileşen kitaplığı içinde bir ekrana bileşen örnekleri ekleyebilir ve sınama amacıyla bu ekranı önizleyebilirsiniz. Ayrıca, Power Apps Mobil kullanılırken bileşen kitaplığının görüntülenmeyeceğini unutmayın.

Özel özellikler

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

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:

Son galeri

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ştirmelerinin yalnızca uygulama içinde kullanılabilir hale getirir. Bir uygulamadan diğerine bileşenleri aldığınızda, özgün uygulamadaki bileşenlerde yapılan yeni güncelleştirmeler, daha önce bu bileşenleri alan uygulamaya yansıtılmaz. 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. make.powerapps.com adresinde oturum açın.

  2. Uygulamalar'ı ve ardından Boş sayfadan tuval uygulaması'nı seçin.

  3. Uygulamaya bir ad verin, bir düzen seçin ve ardından Oluştur'u seçin.

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

    Ağaç görünümünü kullanarak yeni özel bileşen oluşturma

  5. Sol taraftaki gezinti bölmesinde yeni bileşeni seçtikten sonra üç noktayı (...) ve ardından Yeniden adlandır'ı seçin. Ad olarak MenuComponent yazın veya yapıştırın.

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

    Yeni özellik

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

    Görünen ad, özellik adı, açıklama kutuları

    Özellik adında boşluk kullanmayın çünkü bir formül yazarken bileşene bu adla başvurursunuz. Örneğin BileşenAdı.ÖzellikAdı.

    Bileşeni seçerseniz, görünen ad sağ bölmedeki Özellikler sekmesinde görünür. Açıklayıcı bir görünen ad, sizin ve diğer oluşturucuların bu özelliğin amacını anlamanıza 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.

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

    Özelliğin veri türü

    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.

    Özellikler sekmesindeki özel giriş özelliği

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

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

    Table({Item:"SampleText"})
    

    Formül

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

  11. Özellik listesinde Items özelliğinin (varsayılan olarak yaptığı gibi) gösterildiğinden emin olun. Ve sonra bu özelliğin değerini şu ifadeye 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.

  12. İsteğe bağlı olarak, Galeri denetiminin BorderThickness özelliğini 1 olarak ve TemplateSize özelliğini de 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

Bunun ardından, bileşeni bir ekrana ekleyecek ve bileşenin göstermesi için bir dize tablosu belirteceksiniz.

  1. Sol gezinti çubuğunda ekranlar listesini ve ardından varsayılan ekranı seçin.

    Varsayılan ekran

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

    Ekleme

    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.

    Son galeri

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

Şu ana kadar bir bileşen oluşturdunuz ve bir uygulamaya eklediniz. Bundan sonra, kullanıcının menüde seçtiği öğeyi yansıtan bir çıkış özelliği oluşturacaksınız.

  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.

    Çıkış olarak özellik türü

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

    Gallery1.Selected.Item
    

    Gelişmiş bölmesi

  6. Gerekirse bileşen adındaki sayıyı ayarlayarak, uygulamanın varsayılan ekranında bir etiket ekleyin ve Metin ö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.

Bileşenleri alma ve verme

Not

Bu özellik kullanımdan kaldırılacak. Bileşen kitaplıkları; bileşenleri uygulamalar arasında yeniden kullanmanı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ıma sunulunca uygulamayı oluşturana uyarı gönderilir. Bu nedenle, bunun yerine, tüm yeniden kullanılabilir yeni bileşenler, bileşen kitaplıkları içinde oluşturulmalıdır.

Başka bir uygulamadan bileşenleri alma

Bir uygulamadan bir veya daha fazla bileşeni başka bir uygulamaya almak için, Ekle menüsünden Bileşenleri al'ı seçin ve ardından Özel açılır menüsünü kullanın. Veya sol gezintide ağaç görünümündeki Bileşenler'i kullanın.

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 aldıktan sonra kopyanızı düzenleyebilir ve gereksinim duymadıklarınızı silebilirsiniz.

Bileşenleri al iletişim kutusu

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

Uygulamanızdan bileşenleri verme

Bileşenleri bir dosyaya verebilir ve başka bir uygulamaya almak üzere indirebilirsiniz.

Sol gezinti ağaç görünümündeki Bileşenler bölmesinden Bileşenleri ver seçeneğini belirleyin:

Bileşenleri ver ağaç görünümü

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

Bileşenleri ver Ekle menüsü

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

Bileşeni indirme

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

Verilen bileşenler dosyasından bileşenleri alma

Verilen bileşenler dosyasından bileşen almak için, Ekle menüsünden Bileşenleri al'ı seçin ve sonra sol gezinti bölmesinde ağaç görünümündeki Özel açılır menüsünü veya 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:

Bileşen dosyasını alma

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

Verilen uygulamadan bileşenleri alma

Dosya > Farklı Kaydet seçeneğini kullanarak bir uygulamayı yerel olarak kaydedebilirsiniz:

Uygulamayı kaydetme

Uygulamayı kaydettikten sonra, bir dosyadan bileşenleri alma yöntemini kullanarak bu uygulamanın bileşenlerini yeniden kullanabilirsiniz. Verilen bileşenler dosyasındaki bileşenleri alma işleminde önceki bölümde verilen adımları uygulayın.

Bilinen sınırlamalar

  • Veri kaynaklarını, formları ve veri tablolarını bileşenlerle kaydedemezsiniz.
  • Bileşenlerde koleksiyonlar desteklenmez.
  • Bir galeriye veya bir forma bileşen ekleyemezsiniz.
  • Bir bileşenin ana örneği, uygulamanın yerel bir ana örneğidir ve uygulama kapsamıyla sınırlıdır. Bir ana örneği değiştirirseniz, değişikliği yalnızca uygulamanın içindeki bileşen kopyaları yansıtacaktır. Bileşen kitaplığını yeniden alana kadar diğer uygulamalardaki kopyalar aynı kalır. Bu uygulamalardaki tüm ana örnekler otomatik olarak algılanır ve güncelleştirilir.
  • Bir bileşeni aldığınızda medya dosyalarını paketleyemezsiniz.
  • 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

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