このプロジェクトについて
JXPhotoBrowserはiOSアプリ向けのメディア閲覧UIコンポーネントで、中核はUIKitとUICollectionViewに基づいています。iOS 12.0+、Swift 5.4+を必要とし、ブリッジ層を通じてSwiftUIに統合できます。コンポーネントは業務用データモデルに結合せず、画像読み込みライブラリも内蔵しません。delegateがアイテム数、Cellの取得、Cellの設定を提供し、実際の画像読み込みは導入側が選択したライブラリが行います。
操作と表示については、水平または垂直の全ページ閲覧、無限ループ、プログラムによるページ移動、ページ間隔の設定、自動再生をサポートします。画像はダブルタップまたはピンチで拡大縮小でき、ダブルタップ時の倍率は設定可能です。閉じる方法には引き下げジェスチャがあり、遷移はZoom、Fade、Noneから選択できます。サムネイル用ビューを提供してZoom遷移に連携させることも可能です。垂直スクロールモードでは引き下げて閉じる操作は有効になりません。
拡張機構にはカスタムCellとカスタムOverlayがあり、READMEの例ではJXZoomImageCellとJXPageIndicatorOverlayを使用しています。モーダル表示のほか、標準のView Controller containmentによりブラウザを埋め込みBannerとして使うこともできます。その場合は通常、遷移と引き下げジェスチャを無効にし、自動再生を設定します。データが変化した後は、内部のcollectionViewを直接操作せず、コンポーネントのreloadData入口を呼び出す必要があります。
インストールはCocoaPods、SwiftPM、Carthageをサポートしています。統合パッケージにはPrivacyInfo.xcprivacyが含まれ、READMEにはユーザーを追跡せず、データを収集せず、Required Reason APIも使用しないと明記されています。既知の制限として、縦向き固定でデバイス回転に非対応であること、各Cellがブラウザの全ページサイズに固定されることがあり、4.1以降はアイテムごとのカスタムサイズには対応していません。プロジェクトはMIT Licenseです。
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.