🇺🇸 English | 🇯🇵 日本語

class: SJUICollectionView
inherites: UICollectionView

open class var viewClass: SJUICollectionView.Type

このプロパティは、createFromJSONメソッドでどのクラスを生成するかを決定するために使用されます。 SJUICollectionViewを継承したクラスを作成する際は、このプロパティでビューのクラスを定義してください。

SJUICollectionViewは、UICollectionViewとSJUIViewからすべてのプロパティを継承しています：

• レイアウト管理とフローレイアウト設定
• データソースとデリゲート機能
• セルの登録と再利用システム
• セクション管理（ヘッダー、フッター）
• スクロール位置とコンテンツ管理
• SJUIViewからのタッチとジェスチャー処理
• レイアウト制約の管理

required public init(frame: CGRect, collectionViewLayout layout: UICollectionViewLayout)
required public init?(coder aDecoder: NSCoder)

指定されたレイアウトでコレクションビューを適切にセットアップするカスタムイニシャライザー。

public class func createFromJSON(attr: JSON, target: Any, views: inout [String: UIView]) -> SJUICollectionView

このメソッドは、JSONファイルからコレクションビューが作成される際に呼び出されるファクトリメソッドです。
SJUICollectionViewクラスを継承したクラスを作成する際は、このメソッドをオーバーライドしてください。

open class func getCollectionViewLayout(attr: JSON) -> UICollectionViewLayout

JSON属性に基づいてコレクションビューレイアウトを決定します。
デフォルトの実装では、UICollectionViewFlowLayoutオブジェクトを返します。
カスタムレイアウト実装を提供する場合は、このメソッドをオーバーライドしてください。

open class func getCollectionViewFlowLayout(attr: JSON) -> UICollectionViewFlowLayout

JSON属性に基づいてUICollectionViewFlowLayoutを設定して返します。
getCollectionViewLayoutメソッド内で内部的に呼び出されます。
フローレイアウトの動作とプロパティをカスタマイズする場合は、このメソッドをオーバーライドしてください。

SJUICollectionViewは、セル、ヘッダー、フッターの登録を自動的に処理します：

• セルクラス: cellClasses JSON配列からクラスを登録
• ヘッダークラス: headerClasses JSON配列からヘッダークラスを登録
• フッタークラス: footerClasses JSON配列からフッタークラスを登録
• モジュール解決: 適切なクラス検索のためにバンドル名をモジュールプレフィックスとして使用
• 識別子マッピング: クラス名を再利用識別子に自動的にマッピング

SJUICollectionViewは、UICollectionViewプロトコルとの自動統合を提供します：

• ターゲットがUICollectionViewDelegateに準拠している場合の自動デリゲート割り当て
• ターゲットがUICollectionViewDataSourceに準拠している場合の自動データソース割り当て
• すべての標準コレクションビューコールバックとメソッドのサポート
• setTargetAsDelegateとsetTargetAsDataSource属性を通じて設定可能

JSON属性を通じた高度なレイアウト設定：

• フローレイアウト: UICollectionViewFlowLayoutカスタマイズの完全サポート
• アイテムサイジング: itemWeightと自動サイジングを通じて設定可能
• スペーシング制御: 列と行のスペーシング設定
• インセット管理: 柔軟なインセット指定（文字列または配列形式）
• スクロール方向: 水平と垂直スクロールの両方をサポート

open class SJUICollectionViewCell: UICollectionViewCell, ViewHolder

ビューホルダー機能を持つコレクションビューセルのベースクラス。

• public var _views: Dictionary<String, UIView> - 簡単アクセス用のビュー辞書

open class SJUICollectionReusableView: UICollectionReusableView, ViewHolder

ビューホルダー機能を持つコレクションビューヘッダーとフッターのベースクラス。

• public var _views: Dictionary<String, UIView> - 簡単アクセス用のビュー辞書

sections 属性は SwiftUIモードでのみ利用可能 で、セクションベースの設定を提供します：

{
  "type": "Collection",
  "items": "@{collectionData}",
  "sections": [
    {
      "header": "SectionHeaderView",
      "cell": "ProductCell", 
      "footer": "SectionFooterView",
      "columns": 3
    },
    {
      "cell": "CategoryCell",
      "columns": 2
    }
  ]
}

各セクションオブジェクトには以下を含めることができます：

• header: セクションヘッダーのビュー名（オプション）
• cell: このセクションのセルのビュー名
• footer: セクションフッターのビュー名（オプション）
• columns: このセクションのカラム数（グローバルの columns 属性を上書き）

SwiftUIモードでは、items 属性は単純な配列ではなく CollectionDataSource オブジェクトにバインドされます：

// ViewModelで
@Published var collectionData = CollectionDataSource()

// データでセクションを設定
let section1 = CollectionDataSection()
section1.cells = ("ProductCell", productDataArray)
section1.numberOfColumns = 3

let section2 = CollectionDataSection()
section2.header = ("SectionHeader", [["title": "カテゴリー"]])
section2.cells = ("CategoryCell", categoryDataArray)
section2.numberOfColumns = 2

collectionData.sections = [section1, section2]

CollectionDataSection の構造:

class CollectionDataSection {
    var header: (viewName: String, data: [[String: Any]])?
    var cells: (viewName: String, data: [[String: Any]])?
    var footer: (viewName: String, data: [[String: Any]])?
    var numberOfColumns: Int = 2
}

このアーキテクチャにより以下が可能になります：

• セクションごとに異なるセルタイプ
• セクションごとに可変のカラム数
• セクション固有のヘッダーとフッター
• 適切なSwiftUI更新による動的データバインディング

UIKitのみの属性:

• cellClasses: セル登録配列（UIKitはクラスベースの登録を使用）
• headerClasses: ヘッダー登録配列
• footerClasses: フッター登録配列
• itemSize: 固定サイズ設定
• estimatedItemSize: セルフサイジング設定

SwiftUIのみの属性:

• sections: セクションベースのレイアウト設定
• items は CollectionDataSource にバインド（単純な配列ではない）

SJUICollectionViewは、UICollectionViewとSJUIViewからすべてのメソッドを継承しています：

• セル管理（dequeueReusableCell、cellForItemなど）
• セクション管理（numberOfSections、numberOfItemsInSectionなど）
• レイアウト管理（performBatchUpdates、reloadDataなど）
• 選択処理（selectItem、deselectItemなど）
• スクロール管理（scrollToItem、setContentOffsetなど）
• SJUIViewからのタッチとジェスチャー処理
• レイアウト制約の管理