{"id":13645137,"url":"https://github.com/gjiazhe/WaveSideBar","last_synced_at":"2025-04-21T13:31:50.109Z","repository":{"id":49766335,"uuid":"66375028","full_name":"gjiazhe/WaveSideBar","owner":"gjiazhe","description":"An Index Side Bar With Wave Effect","archived":false,"fork":false,"pushed_at":"2017-04-05T06:48:07.000Z","size":632,"stargazers_count":1263,"open_issues_count":9,"forks_count":195,"subscribers_count":32,"default_branch":"master","last_synced_at":"2025-04-08T04:14:19.918Z","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":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gjiazhe.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":"2016-08-23T14:34:42.000Z","updated_at":"2025-03-31T02:36:06.000Z","dependencies_parsed_at":"2022-08-30T11:12:11.944Z","dependency_job_id":null,"html_url":"https://github.com/gjiazhe/WaveSideBar","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gjiazhe%2FWaveSideBar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gjiazhe%2FWaveSideBar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gjiazhe%2FWaveSideBar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gjiazhe%2FWaveSideBar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gjiazhe","download_url":"https://codeload.github.com/gjiazhe/WaveSideBar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250064693,"owners_count":21368950,"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-02T01:02:28.786Z","updated_at":"2025-04-21T13:31:49.756Z","avatar_url":"https://github.com/gjiazhe.png","language":"Java","funding_links":[],"categories":["SideBar"],"sub_categories":[],"readme":"# WaveSideBar\n\nYou can use WaveSideBar in the contacts page of your application.  \nRefer to [AlexLiuSheng/AnimSideBar](https://github.com/AlexLiuSheng/AnimSideBar).\n\n## Screenshot\n![Screenshot](screenshot/gif.gif)\n\n## Include the WaveSideBar to Your Project\nWith gradle:\n\n```groovy\ndependencies {\n   compile 'com.gjiazhe:wavesidebar:1.3'\n}\n```\n\n## Use WaveSideBar in Layout File\n```xml\n\u003ccom.gjiazhe.wavesidebar.WaveSideBar\n        android:id=\"@+id/side_bar\"\n        android:layout_width=\"match_parent\"\n        android:layout_height=\"match_parent\"\n        android:paddingRight=\"8dp\"\n        app:sidebar_position=\"right\"\n        app:sidebar_max_offset=\"80dp\"\n        app:sidebar_lazy_respond=\"false\"\n        app:sidebar_text_color=\"#8D6E63\"\n        app:sidebar_text_size=\"14sp\"\n        app:sidebar_text_alignment=\"center\"/\u003e\n```\n\n## Description of Attributes\n|       Attributes       |           Format           |  Default   |               Description                |\n| :--------------------: | :------------------------: | :--------: | :--------------------------------------: |\n|   sidebar_text_color   |           color            | Color.GRAY |         Text color of side bar.          |\n|   sidebar_text_size    |         dimension          |    14sp    |          Text size of side bar.          |\n|   sidebar_max_offset   |         dimension          |    80dp    |       Offset of the selected item.       |\n|    sidebar_position    |    enum  {right,  left}    |   right    | Be placed on left or right in the view.  |\n| sidebar_text_alignment | enum {center, left, right} |   center   |           Alignment of items.            |\n|  sidebar_lazy_respond  |          boolean           |   false    | If __true__, the listener will not be called until the finger __up__. If __false__, the listener will be called when the finger __down__, __move__ and __up__. |\n\nYou can set these attributes in the layout file, or in the java code:\n```java\nWaveSideBar sideBar = (WaveSideBar) findViewById(R.id.side_bar);\nsideBar.setTextColor(Color.BLACK);\nsideBar.setMaxOffset(100);\nsideBar.setPosition(WaveSideBar.POSITION_LEFT);\nsideBar.setTextAlign(WaveSideBar.TEXT_ALIGN_CENTER);\nsideBar.setLazyRespond(true);\n```\n\n## Set the Listener to Observe WaveSideBar\n```java\nWaveSideBar sideBar = (WaveSideBar) findViewById(R.id.side_bar);\nsideBar.setOnSelectIndexItemListener(new WaveSideBar.OnSelectIndexItemListener() {\n    @Override\n    public void onSelectIndexItem(String index) {\n        Log.d(\"WaveSideBar\", index);\n        // Do something here ....\n    }\n});\n```\n\n## Customize the indexes\nUse **setIndexItems** to Customize the indexes.\n```java\nsideBar.setIndexItems(\"あ\", \"か\", \"さ\", \"た\", \"な\", \"は\", \"ま\", \"や\", \"ら\", \"わ\");\n```\n\n\u003cimg src=\"screenshot/japanese1.png\" width=\"400\"\u003e\n\u003cimg src=\"screenshot/japanese2.png\" width=\"400\"\u003e\n\n## Use Left Hand?\nUse **setPosition** to change the position of side bar.\n```java\nsideBar.setPosition(WaveSideBar.POSITION_LEFT);\n```\n\n\u003cimg src=\"screenshot/position_left.png\" width=\"400\"\u003e\n\n## Lazy respond\nuse **setLazyRespond** to set whether the side bar should respond lazily to your touch events. \n```java\nsideBar.setLazyRespond(true);\n```\n![Screenshot](screenshot/lazy_respond.gif)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgjiazhe%2FWaveSideBar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgjiazhe%2FWaveSideBar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgjiazhe%2FWaveSideBar/lists"}