{"id":18270664,"url":"https://github.com/litl/WKVerticalScrollBar","last_synced_at":"2025-04-05T01:30:45.510Z","repository":{"id":3739589,"uuid":"4813671","full_name":"litl/WKVerticalScrollBar","owner":"litl","description":"A traditional-style scrollbar for iOS that integrates with existing UIScrollView or UIScrollView subclasses.","archived":false,"fork":false,"pushed_at":"2016-03-07T23:37:18.000Z","size":784,"stargazers_count":249,"open_issues_count":7,"forks_count":41,"subscribers_count":29,"default_branch":"master","last_synced_at":"2024-09-17T14:27:24.980Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Objective-C","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/litl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-06-27T21:13:33.000Z","updated_at":"2024-03-05T07:35:19.000Z","dependencies_parsed_at":"2022-08-20T22:50:32.843Z","dependency_job_id":null,"html_url":"https://github.com/litl/WKVerticalScrollBar","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litl%2FWKVerticalScrollBar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litl%2FWKVerticalScrollBar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litl%2FWKVerticalScrollBar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/litl%2FWKVerticalScrollBar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/litl","download_url":"https://codeload.github.com/litl/WKVerticalScrollBar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247276042,"owners_count":20912285,"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":[],"created_at":"2024-11-05T11:38:47.707Z","updated_at":"2025-04-05T01:30:45.111Z","avatar_url":"https://github.com/litl.png","language":"Objective-C","readme":"# WKVerticalScrollBar\n\n![WKVerticalScrollBar in repose](https://raw.github.com/litl/WKVerticalScrollBar/master/images/demo-02.png)\n![WKVerticalScrollBar in action with optional accessory view](https://raw.github.com/litl/WKVerticalScrollBar/master/images/demo-01.png)\n\nA traditional-style scrollbar for iOS that integrates with existing UIScrollView or UIScrollView subclasses.\n\n`WKScrollBar` draws a persistent scrollbar handle on top of a UIScrollView.  When tapped and dragged, `WKScrollBar` will scroll proportionately to its position on the screen.  This comes in handy with apps which present long lists of items (`UITextView`, `UITableView`, `AQGridView`, etc), as it makes it easy to navigate to any point in a list.\n\n## Installing\n### CocoaPods\nInstalling via [cocoapods](http://cocoapods.org) is the preferred method of using `WKVerticalScrollBar`.  Simply add the following line to your `Podfile`:\n\n    dependency 'WKVerticalScrollBar', '0.2.0'\n        \n### Manually\nCopy both `WKVerticalScrollBar.h` and `WKVerticalScrollBar.m` into your project.  Make sure you've linked your project with `QuartzCore.framework`.\n\n## Usage\n`WKVerticalScrollBar` is meant to integrate quickly with projects using `UIScrollView` or `UIScrollView` subclasses like  `AQGridView`.  Getting started is easy:\n\n1. Create a `WKVerticalScrollBar` instance either in IB or in your `-init` method.\n2. Add the `WKVerticalScrollBar` to the parent `UIView`, making sure that it is the frontmost `UIView` either by adding it last, or via `-bringSubviewToFront:`.\n3. Size the `WKVerticalScrollBar` so that it takes up the same area as the `UIScrollView` that it will manage.\n4. Tell `WKVerticalScrollBar` which `UIScrollView` it will manage via `-setScrollView:`.\n\n## Appearance\nModifying the look and feel of `WKScrollBar` can be done via the following methods:\n\n* `-setHandleColor:forState:`\n\n    Sets a color for `UIControlStateNormal` and `UIControlStateSelected` to control the normal and selected (finger down) colors of the handle.\n    \n    Defaults: `UIControlStateNormal`: 40% black, `UIControlStateSelected`: 60% black\n\n* `-setHandleWidth:`\n\n    Sets the width of the handle in the normal state.\n    \n    Default: 5pt.\n    \n* `-setHandleSelectedWidth:`\n\n    Sets the width of the handle when selected.  This allows you to grow the handle when the user's finger is over the handle.\n    \n    Default: 15pt.\n    \n* `-setHandleHitArea:`\n\n    Sets the width of the hit area for the handle.  This will allow your control to have a slightly larger hit area than what is visually presented.  Apple's iOS Human Interface Guidelines suggest that this be 44pt.\n    \n    Default: 44pt.\n    \n* `-setHandleMinimumHeight:`\n\n    Sets the minimum height of the handle.\n    \n    The height of the handle is calculated based upon the ratio of the `contentOffset` and the `frame`.  If the `contentOffset` is too large, the handle may be too small to touch comfortably.  Use this parameter to ensure that a minimum handle size is preserved.\n    \n* `-setHandleCornerRadius:` and `-setHandleSelectedCornerRadius:`\n\n    Sets the corner radius of the handle in normal and selected mode.\n\n## Contributing\nAnyone who would like to contribute to the project is more than welcome.\nBasically, there's just a few steps to getting started:\n\n1. Fork this repo\n2. Make your changes\n3. Add yourself to the AUTHORS file and submit a pull request!\n\n## Copyright and License\nWKVerticalScrollBar is Copyright (c) 2012 litl, LLC and licensed under the MIT license. See the LICENSE file for full details.\n","funding_links":[],"categories":["etc"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flitl%2FWKVerticalScrollBar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flitl%2FWKVerticalScrollBar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flitl%2FWKVerticalScrollBar/lists"}