+
+ 
+ 
+ 
+ 
+ 
+
+
+
+
+
+
+
+
+
+
+ Özellikler + • Rehberler + • Kurulum + • Kullanım + • Diğer Konular + • Katkıda Bulun +
+ +**🌎 README diğer dillerde de mevcuttur: [🇬🇧](../README.md) . [🇪🇸](README_es.md) . [🇨🇳](README_zh.md) . [🇧🇷](README_pt-br.md) . [🇰🇷](README_ko.md) . [🇫🇷](README_fr.md) . [🇩🇪](README_de.md)** + +Günümüzde neredeyse tüm uygulamalar, API istekleri, uzun süren işlemler vb. gibi asenkron süreçlere sahiptir. Bu işlemler çalışırken, geliştiriciler genellikle kullanıcılara bir şeylerin devam ettiğini göstermek için bir yükleme görünümü yerleştirir. + +**SkeletonView**, kullanıcılara bir şeylerin gerçekleştiğini şık bir şekilde göstermek ve onları hangi içeriğin yükleneceğine hazırlamak için bu ihtiyacı karşılamak amacıyla tasarlanmıştır. + +Keyifli kullanımlar! 🙂 + + +## +- [🌟 Özellikler](#-özellikler) +- [🎬 Rehberler](#-rehberler) +- [📲 Kurulum](#-kurulum) +- [🐒 Kullanım](#-kullanım) + - [🌿 Koleksiyonlar](#-koleksiyonlar) + - [🔠 Metinler](#-metinler) + - [🦋 Görünüm](#-görünüm) + - [🎨 Özel renkler](#-özel-renkler) + - [🏃♀️ Animasyonlar](#️-animasyonlar) + - [🏄 Geçişler](#-geçişler) +- [✨ Diğer Konular](#-diğer-konular) +- [❤️ Katkıda Bulun](#️-katkıda-bulun) +- [📢 Bahsedenler](#-bahsedenler) +- [🏆 Sponsorlar](#-sponsorlar) +- [👨🏻💻 Yazar](#-yazar) +- [👮🏻 Lisans](#-lisans) + + + +## 🌟 Özellikler + +* Kullanımı kolay +* Tüm UIView'lar iskeletlenebilir +* Tamamen özelleştirilebilir +* Evrensel (iPhone ve iPad) +* Interface Builder dostu +* Basit Swift sözdizimi +* Hafif, okunabilir kod tabanı + + + + +> 📣 **ÖNEMLİ!** +> +> `SkeletonView` özyinelemeli (recursive) olduğundan, tüm iskeletlenebilir (skeletonable) görünümlerde iskeleti göstermek isterseniz, sadece ana kapsayıcı görünümünde gösterme yöntemini çağırmanız yeterlidir. Örneğin, `UIViewControllers` ile. + + + + +### 🌿 Koleksiyonlar + +```SkeletonView```, ```UITableView``` ve ```UICollectionView``` ile uyumludur. + + +**UITableView** + +Bir ```UITableView```'da iskeleti göstermek istiyorsanız, ```SkeletonTableViewDataSource``` protokolüne uymanız gerekir. + +``` swift +public protocol SkeletonTableViewDataSource: UITableViewDataSource { + func numSections(in collectionSkeletonView: UITableView) -> Int // Varsayılan: 1 + func collectionSkeletonView(_ skeletonView: UITableView, numberOfRowsInSection section: Int) -> Int + func collectionSkeletonView(_ skeletonView: UITableView, cellIdentifierForRowAt indexPath: IndexPath) -> ReusableCellIdentifier + func collectionSkeletonView(_ skeletonView: UITableView, skeletonCellForRowAt indexPath: IndexPath) -> UITableViewCell? // Varsayılan: nil + func collectionSkeletonView(_ skeletonView: UITableView, prepareCellForSkeleton cell: UITableViewCell, at indexPath: IndexPath) +} +``` +Gördüğünüz gibi, bu protokol ```UITableViewDataSource```'dan miras alır, bu nedenle bu protokolü iskelet protokolü ile değiştirebilirsiniz. + +Bu protokolün bazı yöntemler için varsayılan bir uygulaması vardır. Örneğin, her bölüm için satır sayısı çalışma zamanında hesaplanır: + +``` swift +func collectionSkeletonView(_ skeletonView: UITableView, numberOfRowsInSection section: Int) -> Int +// Varsayılan: +// Tüm tableview'ı doldurmak için kaç hücreye ihtiyaç olduğunu hesaplar +``` + +> 📣 **ÖNEMLİ!** +> +> Yukarıdaki yöntemde `UITableView.automaticNumberOfSkeletonRows` döndürürseniz, varsayılan davranış gibi çalışır (yani, tüm tableview'ı doldurmak için kaç hücre gerektiğini hesaplar). + +Skeleton'a hücre tanımlayıcısını bildirmek için uygulamanız gereken sadece bir yöntem vardır. Bu yöntemin varsayılan bir uygulaması yoktur: + ``` swift + func collectionSkeletonView(_ skeletonView: UITableView, cellIdentifierForRowAt indexPath: IndexPath) -> ReusableCellIdentifier { + return "CellIdentifier" +} + ``` + +Varsayılan olarak, kütüphane her indexPath'ten hücreleri kuyruğa alır, ancak iskelet görünmeden önce bazı değişiklikler yapmak isterseniz bunu da yapabilirsiniz: + ``` swift + func collectionSkeletonView(_ skeletonView: UITableView, skeletonCellForRowAt indexPath: IndexPath) -> UITableViewCell? { + let cell = skeletonView.dequeueReusableCell(withIdentifier: "CellIdentifier", for: indexPath) as? Cell + cell?.textField.isHidden = indexPath.row == 0 + return cell + } + ``` + +Kuyruğa alma kısmını kütüphaneye bırakmayı tercih ederseniz, bu yöntemi kullanarak hücreyi yapılandırabilirsiniz: + ``` swift + func collectionSkeletonView(_ skeletonView: UITableView, prepareCellForSkeleton cell: UITableViewCell, at indexPath: IndexPath) { + let cell = cell as? Cell + cell?.textField.isHidden = indexPath.row == 0 + } + ``` + + +Ayrıca, hem başlıkları hem de altbilgileri iskeletlendirebilirsiniz. Bunun için `SkeletonTableViewDelegate` protokolüne uymanız gerekir. + +```swift +public protocol SkeletonTableViewDelegate: UITableViewDelegate { + func collectionSkeletonView(_ skeletonView: UITableView, identifierForHeaderInSection section: Int) -> ReusableHeaderFooterIdentifier? // Varsayılan: nil + func collectionSkeletonView(_ skeletonView: UITableView, identifierForFooterInSection section: Int) -> ReusableHeaderFooterIdentifier? // Varsayılan: nil +} +``` + +> 📣 **ÖNEMLİ!** +> +> 1️⃣ Eğer yeniden boyutlandırılabilir hücreler kullanıyorsanız (**`tableView.rowHeight = UITableViewAutomaticDimension`**), **`estimatedRowHeight`** tanımlamanız zorunludur. +> +> 2️⃣ Bir **`UITableViewCell`**'e öğeler eklediğinizde, bunları doğrudan hücreye değil, **`contentView`**'a eklemelisiniz. +> ```swift +> self.contentView.addSubview(titleLabel) ✅ +> self.addSubview(titleLabel) ❌ +> ``` + + + +**UICollectionView** + +`UICollectionView` için, `SkeletonCollectionViewDataSource` protokolüne uymanız gerekir. + +``` swift +public protocol SkeletonCollectionViewDataSource: UICollectionViewDataSource { + func numSections(in collectionSkeletonView: UICollectionView) -> Int // Varsayılan: 1 + func collectionSkeletonView(_ skeletonView: UICollectionView, numberOfItemsInSection section: Int) -> Int + func collectionSkeletonView(_ skeletonView: UICollectionView, cellIdentifierForItemAt indexPath: IndexPath) -> ReusableCellIdentifier + func collectionSkeletonView(_ skeletonView: UICollectionView, supplementaryViewIdentifierOfKind: String, at indexPath: IndexPath) -> ReusableCellIdentifier? // Varsayılan: nil + func collectionSkeletonView(_ skeletonView: UICollectionView, skeletonCellForItemAt indexPath: IndexPath) -> UICollectionViewCell? // Varsayılan: nil + func collectionSkeletonView(_ skeletonView: UICollectionView, prepareCellForSkeleton cell: UICollectionViewCell, at indexPath: IndexPath) + func collectionSkeletonView(_ skeletonView: UICollectionView, prepareViewForSkeleton view: UICollectionReusableView, at indexPath: IndexPath) +} +``` + +Sürecin geri kalanı ```UITableView``` ile aynıdır + + +### 🔠 Metinler + + + +Metin içeren öğeler kullanırken, ```SkeletonView``` metni simüle etmek için çizgiler çizer. + +Çok satırlı öğeler için bazı özellikler ayarlayabilirsiniz. + +| Özellik | Tür | Varsayılan | Önizleme +| ------- | ------- |------- | ------- +| **lastLineFillPercent** | `CGFloat` | `70`|  +| **linesCornerRadius** | `Int` | `0` |  +| **skeletonLineSpacing** | `CGFloat` | `10` |  +| **skeletonPaddingInsets** | `UIEdgeInsets` | `.zero` |  +| **skeletonTextLineHeight** | `SkeletonTextLineHeight` | `.fixed(15)` |  +| **skeletonTextNumberOfLines** | `SkeletonTextNumberOfLines` | `.inherited` |  + +|
+ |
+
+ |
+
+
+ |
+
+
+ |
+
| 
|
+|
| |
+|
| 
|
+|
| 
|
+|
| 
|
+|
| 
|
+
+
+
+**İskelet görünümlerin düzeni**
+
+Bazen iskelet düzeni, üst görünüm sınırları değiştiği için düzeninize uymayabilir. ~Örneğin, cihazı döndürme.~
+
+İskelet görünümlerini şu şekilde yeniden düzenleyebilirsiniz:
+
+```swift
+override func viewDidLayoutSubviews() {
+ view.layoutSkeletonIfNeeded()
+}
+```
+
+> 📣 **ÖNEMLİ!**
+>
+> Bu yöntemi çağırmamalısınız. **Sürüm 1.8.1**'den itibaren bu yöntemi çağırmanıza gerek yok, kütüphane otomatik olarak yapıyor. Bu nedenle, bu yöntemi **SADECE** iskeletin düzenini manuel olarak güncellemeniz gereken durumlarda kullanabilirsiniz.
+
+
+
+
+**İskeleti güncelleme**
+
+Aşağıdaki yöntemlerle iskelet yapılandırmasını, rengi, animasyonu vb. gibi herhangi bir zamanda değiştirebilirsiniz:
+
+```swift
+(1) view.updateSkeleton() // Düz
+(2) view.updateGradientSkeleton() // Gradyan
+(3) view.updateAnimatedSkeleton() // Düz animasyonlu
+(4) view.updateAnimatedGradientSkeleton() // Gradyan animasyonlu
+```
+
+**Animasyon başladığında görünümleri gizleme**
+
+Bazen animasyon başladığında bazı görünümleri gizlemek istersiniz, bu nedenle bunu gerçekleştirmek için kullanabileceğiniz hızlı bir özellik vardır:
+
+```swift
+view.isHiddenWhenSkeletonIsActive = true // Bu sadece isSkeletonable = true olduğunda çalışır
+```
+
+**İskelet aktif olduğunda kullanıcı etkileşimini değiştirmeyin**
+
+
+Varsayılan olarak, iskeletlenen öğeler için kullanıcı etkileşimi devre dışı bırakılır, ancak iskelet aktif olduğunda kullanıcı etkileşim göstergesini değiştirmek istemiyorsanız, `isUserInteractionDisabledWhenSkeletonIsActive` özelliğini kullanabilirsiniz:
+
+```swift
+view.isUserInteractionDisabledWhenSkeletonIsActive = false // İskelet aktif olduğunda görünüm aktif olacaktır.
+```
+
+**Etiketlerdeki iskelet çizgileri için yazı tipi satır yüksekliğini kullanmayın**
+
+Bir `UILabel` veya `UITextView` için iskeletin yazı tipi yüksekliğine otomatik olarak ayarlanmasını devre dışı bırakmak için false olarak ayarlayın. Varsayılan olarak, iskelet çizgileri yüksekliği, sınırlayıcı kutuyu kullanmak yerine etiket dikdörtgenindeki metni daha doğru bir şekilde yansıtmak için yazı tipi yüksekliğine otomatik olarak ayarlanır.
+
+```swift
+label.useFontLineHeight = false
+```
+
+**Gecikmeli iskelet gösterimi**
+
+Görünümler hızlı güncelleniyorsa iskeletin sunumunu geciktirebilirsiniz.
+
+```swift
+func showSkeleton(usingColor: UIColor,
+ animated: Bool,
+ delay: TimeInterval,
+ transition: SkeletonTransitionStyle)
+```
+
+```swift
+func showGradientSkeleton(usingGradient: SkeletonGradient,
+ animated: Bool,
+ delay: TimeInterval,
+ transition: SkeletonTransitionStyle)
+```
+
+**Debug**
+
+Bir şey düzgün çalışmadığında hata ayıklama görevlerini kolaylaştırmak için **`SkeletonView`** bazı yeni araçlara sahiptir.
+
+İlk olarak, `UIView` iskelet bilgisiyle kullanılabilen bir özelliğe sahiptir:
+```swift
+var sk.skeletonTreeDescription: String
+
+```
+
+Ayrıca, yeni **hata ayıklama modunu** etkinleştirebilirsiniz. Sadece `SKELETON_DEBUG` ortam değişkenini ekleyip etkinleştirmeniz yeterlidir.
+
+
+
+Daha sonra, iskelet göründüğünde, Xcode konsolunda görünüm hiyerarşisini görebilirsiniz.
+
+```
+{
+ "type" : "UIView", // UITableView, UILabel...
+ "isSkeletonable" : true,
+ "reference" : "0x000000014751ce30",
+ "children" : [
+ {
+ "type" : "UIView",
+ "isSkeletonable" : true,
+ "children" : [ ... ],
+ "reference" : "0x000000014751cfa0"
+ }
+ ]
+}
+```
+
+**Desteklenen İşletim Sistemleri ve SDK Sürümleri**
+
+* iOS 9.0+
+* tvOS 9.0+
+* Swift 5.3
+
+## ❤️ Katkıda Bulun
+Bu bir açık kaynak projesidir, bu yüzden katkıda bulunmaktan çekinmeyin. Nasıl mı?
+
+- Bir [sorun](https://github.com/Juanpe/SkeletonView/issues/new) açın.
+- [E-posta](mailto://juanpecatalan.com) aracılığıyla geri bildirim gönderin.
+- Kendi düzeltmelerinizi, önerilerinizi önerin ve değişikliklerle bir pull request açın.
+
+[Tüm katkıda bulunanları](https://github.com/Juanpe/SkeletonView/graphs/contributors) görün
+
+Daha fazla bilgi için lütfen [katkıda bulunma yönergelerini](https://github.com/Juanpe/SkeletonView/blob/main/CONTRIBUTING.md) okuyun.
+
+
+## 📢 Bahsedenler
+
+- [iOS Dev Weekly #327](https://iosdevweekly.com/issues/327#start)
+- [Hacking with Swift Articles](https://www.hackingwithswift.com/articles/40/skeletonview-makes-loading-content-beautiful)
+- [Top 10 Swift Articles November](https://medium.mybridge.co/swift-top-10-articles-for-the-past-month-v-nov-2017-dfed7861cd65)
+- [30 Amazing iOS Swift Libraries (v2018)](https://medium.mybridge.co/30-amazing-ios-swift-libraries-for-the-past-year-v-2018-7cf15027eee9)
+- [AppCoda Weekly #44](http://digest.appcoda.com/issues/appcoda-weekly-issue-44-81899)
+- [iOS Cookies Newsletter #103](https://us11.campaign-archive.com/?u=cd1f3ed33c6527331d82107ba&id=48131a516d)
+- [Swift Developments Newsletter #113](https://andybargh.com/swiftdevelopments-113/)
+- [iOS Goodies #204](http://ios-goodies.com/post/167557280951/week-204)
+- [Swift Weekly #96](http://digest.swiftweekly.com/issues/swift-weekly-issue-96-81759)
+- [CocoaControls](https://www.cocoacontrols.com/controls/skeletonview)
+- [Awesome iOS Newsletter #74](https://ios.libhunt.com/newsletter/74)
+- [Swift News #36](https://www.youtube.com/watch?v=mAGpsQiy6so)
+- [Best iOS articles, new tools & more](https://medium.com/flawless-app-stories/best-ios-articles-new-tools-more-fcbe673e10d)
+
+## 🏆 Sponsorlar
+
+Açık kaynak projeler sizin yardımınız olmadan uzun süre yaşayamaz. Eğer **SkeletonView**'u yararlı bulursanız, lütfen sponsor olarak bu projeyi desteklemeyi düşünün.
+
+[GitHub Sponsors](https://github.com/sponsors/Juanpe) aracılığıyla sponsor olun :heart:
+
+## 👨🏻💻 Yazar
+
+[Juanpe Catalán](http://www.twitter.com/JuanpeCatalan)
+
+
+
+
+## 👮🏻 Lisans
+
+```
+MIT License
+
+Copyright (c) 2017 Juanpe Catalán
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
diff --git a/Translations/README_zh.md b/Translations/README_zh.md
index 84c8dead..98bf2b9e 100755
--- a/Translations/README_zh.md
+++ b/Translations/README_zh.md
@@ -23,7 +23,7 @@
-**🌎 翻译: [🇬🇧](../README.md) . [🇨🇳](README_zh.md) . [🇧🇷](README_pt-br.md) . [🇰🇷](README_ko.md) . [🇫🇷](README_fr.md) . [🇩🇪](README_de.md)**
+**🌎 翻译: [🇬🇧](../README.md) . [🇨🇳](README_zh.md) . [🇧🇷](README_pt-br.md) . [🇰🇷](README_ko.md) . [🇫🇷](README_fr.md) . [🇩🇪](README_de.md) . [🇹🇷](README_tr.md)**
今天，几乎所有的应用程序都有异步流程，例如：Api请求、长时间运行的流程等。虽然流程正在运行，但通常开发人员会设置一个加载视图来向用户显示正在发生的事情。