{"id":21748316,"url":"https://github.com/surfstudio/reactivedatadisplaymanager","last_synced_at":"2025-04-07T13:08:38.061Z","repository":{"id":37484268,"uuid":"98958400","full_name":"surfstudio/ReactiveDataDisplayManager","owner":"surfstudio","description":null,"archived":false,"fork":false,"pushed_at":"2024-12-17T07:40:26.000Z","size":6289,"stargazers_count":41,"open_issues_count":8,"forks_count":13,"subscribers_count":24,"default_branch":"develop","last_synced_at":"2025-03-31T12:05:15.182Z","etag":null,"topics":["collections","hacktoberfest","ios","rddm","swift","tableview","tableviewcell"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/surfstudio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-08-01T04:13:20.000Z","updated_at":"2025-03-04T13:13:22.000Z","dependencies_parsed_at":"2023-02-12T07:46:15.172Z","dependency_job_id":"07eabaa6-b5ca-422b-95bc-4bb2727f852c","html_url":"https://github.com/surfstudio/ReactiveDataDisplayManager","commit_stats":{"total_commits":888,"total_committers":46,"mean_commits":"19.304347826086957","dds":0.7601351351351351,"last_synced_commit":"d35d70eb8025a3958448a9a1a445b28214d837d0"},"previous_names":[],"tags_count":44,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/surfstudio%2FReactiveDataDisplayManager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/surfstudio%2FReactiveDataDisplayManager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/surfstudio%2FReactiveDataDisplayManager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/surfstudio%2FReactiveDataDisplayManager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/surfstudio","download_url":"https://codeload.github.com/surfstudio/ReactiveDataDisplayManager/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247657281,"owners_count":20974345,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["collections","hacktoberfest","ios","rddm","swift","tableview","tableviewcell"],"created_at":"2024-11-26T08:13:02.453Z","updated_at":"2025-04-07T13:08:38.041Z","avatar_url":"https://github.com/surfstudio.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ReactiveDataDisplayManager\n\n[![Build](https://github.com/surfstudio/ReactiveDataDisplayManager/actions/workflows/Build.yml/badge.svg)](https://github.com/surfstudio/ReactiveDataDisplayManager/actions/workflows/Build.yml)\n[![codebeat badge](https://codebeat.co/badges/aa8b4a6a-970f-4e1b-8400-bfe902f8aa68)](https://codebeat.co/projects/github-com-surfstudio-reactivedatadisplaymanager-develop)\n[![codecov](https://codecov.io/gh/surfstudio/ReactiveDataDisplayManager/branch/master/graph/badge.svg)](https://codecov.io/gh/surfstudio/ReactiveDataDisplayManager)\n\nIt is the whole approach to working with scrollable lists or collections.\n\n[![Logo](https://i.ibb.co/zs8P9c3/716-225-Reactive-Logo.jpg)](https://ibb.co/Q98YSBW)\n\n## About\n\nThis Framework was made to speed up development of scrollable collections like UITableView or UICollectionView, and to provide new way to easy extend collections functionality.\n\n## Breaking changes\n\nWe made a massive refactoring with version 7.0.0.\nPlease read our [migration guide](/Documentation/MigrationGuide.md) if you were using version 6 or older.\n\n## Currently supported features\n\n- Populating cells without implementing delegate and datasource by yourself\n- Inserting, replacing or removing cells without reload\n- Expanding and collapsing cells inside collection\n- Moving or Drag'n'Drop cells inside collection\n- Customizing of section headers and index titles\n\n## Usage\n\nStep by step example of configuring simple list of labels.\n\n### Prepare cell\n\nYou can layout your cell from xib or from code. It doesn't matter.\nJust extend your cell to `ConfigurableItem` to fill subviews with model, when cell will be created.\n\n```swift\nimport ReactiveDataDisplayManager\n\nfinal class LabelCell: UITableViewCell {\n\n    // MARK: - IBOutlets\n\n    @IBOutlet private weak var titleLabel: UILabel!\n\n}\n\n// MARK: - ConfigurableItem\n\nextension LabelCell: ConfigurableItem {\n\n    typealias Model = String\n\n    func configure(with model: Model) {\n        titleLabel.text = model\n    }\n}\n```\n\n### Prepare collection\n\nJust call `rddm` from collection\n- add plugins for your needs\n- build your ReactiveDataDisplayManager\n\n```swift\nfinal class ExampleTableController: UIViewController {\n\n    // MARK: - IBOutlets\n\n    @IBOutlet private weak var tableView: UITableView!\n\n    // MARK: - Private Properties\n\n    private lazy var ddm = tableView.rddm.baseBuilder\n        .add(plugin: .selectable())\n        .build()\n\n    // MARK: - UIViewController\n\n    override func viewDidLoad() {\n        super.viewDidLoad()\n        fill()\n    }\n\n}\n```\n\n### Fill collection\n\nConvert models to generators and call `ddm =\u003e .reload`\n\n```swift\nprivate extension MainTableViewController {\n\n    func fill() {\n\n        let models = [\"First\", \"Second\", \"Third\"]\n\n        for model in models {\n            let generator = TitleTableViewCell.rddm.baseGenerator(with: model)\n\n            generator.didSelectEvent += { [weak self] in\n                // do some logic\n            }\n\n            // Add generator to adapter\n            ddm.addCellGenerator(generator)\n            // or simple use operator `+=`\n            ddm += generator\n        }\n\n        ddm =\u003e .reload\n    }\n\n}\n```\n\n### Enjoy\n\nAs you can see, you don't need to conform `UITableViewDelegate` and `UITableViewDataSource`. This protocols are hidden inside ReactiveDataDisplayManager.\nYou can extend table functionality with adding plugins and replacing generator.\n\n[![Feature](https://i.ibb.co/WFrzQNK/2021-02-20-15-52-34.png)](https://ibb.co/mtnymrz)\n\nYou can check more examples in our [example project](/Example/) or in full [documentation](/Documentation/Entities.md).\nSmall [cheat sheet](/Documentation/Operations.md) table could also be usefull.\n\n\n## Installation\n\nJust add ReactiveDataDisplayManager to your `Podfile` like this\n\n```\npod 'ReactiveDataDisplayManager' ~\u003e 7.3\n```\n\n## Changelog\n\nAll notable changes to this project will be documented in [this file](./CHANGELOG.md).\n\n## Issues\n\nFor issues, file directly in the [main ReactiveDataDisplayManager repo](https://github.com/surfstudio/ReactiveDataDisplayManager).\n\n## Contribute\n\nIf you would like to contribute to the package (e.g. by improving the documentation, solving a bug or adding a cool new feature), please review our [contribution guide](/Documentation/ContributingGuide.md) first and send us your pull request.\n\nYou PRs are always welcome.\n\n## License\n\n[MIT License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsurfstudio%2Freactivedatadisplaymanager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsurfstudio%2Freactivedatadisplaymanager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsurfstudio%2Freactivedatadisplaymanager/lists"}