{"id":13848843,"url":"https://github.com/andraskindler/quickscroll","last_synced_at":"2025-07-12T13:32:56.917Z","repository":{"id":7849024,"uuid":"9220898","full_name":"andraskindler/quickscroll","owner":"andraskindler","description":"[Development stopped in 2014. Unfinished and not stable - not recommended to use.] Bringing extended scrolling features to Android's native ListView and ExpandableListView.","archived":true,"fork":false,"pushed_at":"2021-04-19T06:49:51.000Z","size":1475,"stargazers_count":455,"open_issues_count":9,"forks_count":151,"subscribers_count":23,"default_branch":"master","last_synced_at":"2024-07-01T10:57:30.132Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andraskindler.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-04-04T15:08:46.000Z","updated_at":"2024-04-04T03:09:35.000Z","dependencies_parsed_at":"2022-09-13T08:00:44.367Z","dependency_job_id":null,"html_url":"https://github.com/andraskindler/quickscroll","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andraskindler%2Fquickscroll","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andraskindler%2Fquickscroll/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andraskindler%2Fquickscroll/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andraskindler%2Fquickscroll/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andraskindler","download_url":"https://codeload.github.com/andraskindler/quickscroll/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":213949827,"owners_count":15661677,"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-08-04T19:00:59.276Z","updated_at":"2024-08-04T19:03:29.606Z","avatar_url":"https://github.com/andraskindler.png","language":"Java","funding_links":[],"categories":["Java","Libs"],"sub_categories":["\u003cA NAME=\"Widget\"\u003e\u003c/A\u003eWidget"],"readme":"Development stopped in 2014\n=================\nNot developed since 2014. Unfinished and not stable - not recommended to use.\n\nAbout QuickScroll\n=================\n\nQuickScroll is a library aimed at creating similar scrolling experiences to the native Contacts app's People view. It has the same scrolling capabilities as the ListView's native *fastscroll*, but comes with a much a much more customizable design, two indicator styles and an allways visible scrollbar. The two most common modes are *popup* and *indicator*. Works with ListView and ExpandableListView.\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"http://howrobotswork.files.wordpress.com/2013/08/quickscroll_11.png\"/\u003e\u003c/p\u003e\n\nUsage\n=====\n\n*A project with mulitple working samples can be found in the /sample folder.*\n\n1. Include the widget in your layout. Currently, you can only put it to the right side of the ListView, this can be done via a RelativeLayout, a LinearLayout or any other positioning trick of your choice. The default width is 30 dp, but if you really want to change it, you can do it via an object method.\n\n        \u003ccom.andraskindler.quickscroll.QuickScroll\n        android:id=\"@+id/quickscroll\"\n        android:layout_width=\"wrap_content\"\n        android:layout_height=\"match_parent\"/\u003e\n\n2. Implement the *Scrollable* interface in your BaseExpandableListAdapter or BaseAdapter subclass. You must override the methods below.\n \n   The first function returns the corresponding String to display at any given position:\n        \n        @Override\n        public String getIndicatorForPosition(int childposition, int groupposition) {\n            return null;\n        }\n\n   The second function is responsible for is for implementing scroll behaviour. This can be used to perform special tasks, e.g. if you want to *snap* to the first item starting with a letter in an alphabetically ordered list or jump between groups in an ExpandableListView. If you want the normal approach, simply return *childposition*.\n\n        @Override\n        public int getScrollPosition(int childposition, int groupposition) {\n\t    return 0;\n        }\n        \n3. Initialize the QuickScroll widget:\n\t\n        final QuickScroll quickscroll = (QuickScroll) layout.findViewById(R.id.quickscroll);\n        quickscroll.init(QuickScroll.TYPE_INDICATOR, listview, adapter, QuickScroll.STYLE_HOLO);\n\n\tThe first parameter assigns the type, the second and third binds the ListView (or ExpandableListView) and its adapter. \n\tThe last one defines the style, currently there are two available:\n\t* STYLE_HOLO creates a scrollbar fitting into stock holo design.\n\t* STYLE_NONE creates a transparent scrollbar, so you can create a fully customised underlying layout.\n\n\tBoth styles also come with a *_WITH_HANDLE* suffix, creating a holo-themed handlebar on the scrollbar.\n\n4. (Optional) Do some customizing: change the colors, sizes and font styles. This can be done via object methods.\n\nIncluding in your app\n=====================\n\nQuickScroll is available as an Android Library Project. In Eclipse, you can include it by referencing as a library project, in IntelliJ, you can add it as a module.\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"http://howrobotswork.files.wordpress.com/2013/08/quickscroll_21.png\"/\u003e\u003c/p\u003e\n\nOther notices\n=============\n\nThe lowest supported API level is 8 (FroYo)\n\nDeveloped by **Andras Kindler** (andraskindler@gmail.com)\n\nLicense\n=======\n\n    Copyright 2014 Andras Kindler\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandraskindler%2Fquickscroll","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandraskindler%2Fquickscroll","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandraskindler%2Fquickscroll/lists"}