{"id":13396352,"url":"https://github.com/vikramkakkar/SublimePicker","last_synced_at":"2025-03-13T23:30:55.936Z","repository":{"id":32593634,"uuid":"36177024","full_name":"vikramkakkar/SublimePicker","owner":"vikramkakkar","description":"A material-styled android view that provisions picking of a date, time \u0026 recurrence option, all from a single user-interface. ","archived":false,"fork":false,"pushed_at":"2023-01-14T05:42:32.000Z","size":18633,"stargazers_count":2310,"open_issues_count":65,"forks_count":406,"subscribers_count":69,"default_branch":"master","last_synced_at":"2024-07-31T18:17:09.096Z","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vikramkakkar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-05-24T14:51:50.000Z","updated_at":"2024-07-24T04:49:42.000Z","dependencies_parsed_at":"2023-01-16T23:30:46.126Z","dependency_job_id":null,"html_url":"https://github.com/vikramkakkar/SublimePicker","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/vikramkakkar%2FSublimePicker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vikramkakkar%2FSublimePicker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vikramkakkar%2FSublimePicker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vikramkakkar%2FSublimePicker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vikramkakkar","download_url":"https://codeload.github.com/vikramkakkar/SublimePicker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243499875,"owners_count":20300705,"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-07-30T18:00:46.808Z","updated_at":"2025-03-13T23:30:54.933Z","avatar_url":"https://github.com/vikramkakkar.png","language":"Java","funding_links":[],"categories":["Index `(light-weight pages)`","Android","选择器(Picker)","Java","Index"],"sub_categories":["Components"],"readme":"# SublimePicker\n\nA customizable view that provisions picking of a date, time \u0026 recurrence option, all from a single user-interface. You can also view 'SublimePicker' as a collection of material-styled (API 23) DatePicker, TimePicker \u0026 RecurrencePicker, backported to API 14.\n\nWith the release of version 2, SublimePicker now allows date-range selection.\n\nAll three components have been converted to views, which enables us to add/embed them anywhere - add them to a 'Dialog', a 'PopupWindow', or use them as any regular android widget. \n\nAlmost all styling possibilities have been exposed through attrs. If something has been missed, please bring it to my attention.\n\nSublimePicker provides a single point of entry to all three pickers. What I mean is that once SublimePicker is available for interaction, the user can select a date, a time \u0026 a recurrence option without leaving the picker.\n\nGradle dependency\n-----------------\n\n`compile 'com.appeaser.sublimepickerlibrary:sublimepickerlibrary:2.1.2'`\n\nWalkthrough\n-----------\nFollowing screenshots have been taken from the sample application: [\u003cimg alt=\"Get it on Google Play\" height=\"45px\" src=\"https://play.google.com/intl/en_us/badges/images/apps/en-play-badge-border.png\" /\u003e][1]\n\nLaunching into **DatePicker**:\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/vikramkakkar/SublimePicker/blob/master/img/date_picker_v2.png?raw=true\" width=\"497\" height=\"1000\" /\u003e\n\u003c/p\u003e\n\nVersion 2 allows date-range selection using `SublimeOptions#setCanPickDateRange(boolean)`. Picking date range is _one fluent gesture_ which begins with a long-press on the intended start-date, followed by a drag onto the intended end-date. The range can span as many days, months or years, as needed. During a drag, approaching the left/right edge of date picker scrolls the previous/next month into view.  \n\nDate range selection:\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/vikramkakkar/SublimePicker/blob/master/img/date_picker_date_range_v2.png?raw=true\" width=\"497\" height=\"1000\" /\u003e\n\u003c/p\u003e\n\nLandscape:\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/vikramkakkar/SublimePicker/blob/master/img/date_picker_date_range_land_v2.png?raw=true\" width=\"800\" height=\"397\" /\u003e\n\u003c/p\u003e\n\nDate range selection spanning multiple months:\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/vikramkakkar/SublimePicker/blob/master/img/date_picker_date_range_spanned_v2.png?raw=true\" width=\"497\" height=\"1000\" /\u003e\n\u003c/p\u003e\n\nButton at bottom-left corner can be used to switch to **TimePicker**: \n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/vikramkakkar/SublimePicker/blob/master/img/time_picker_v2.png?raw=true\" width=\"497\" height=\"1000\" /\u003e\n\u003c/p\u003e\n\nLandscape:\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/vikramkakkar/SublimePicker/blob/master/img/time_picker_land_v2.png?raw=true\" width=\"800\" height=\"397\" /\u003e\n\u003c/p\u003e\n\nThe overflow button at top-right opens the **RecurrencePicker**:\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/vikramkakkar/SublimePicker/blob/master/img/recurrence_picker_v2.png?raw=true\" width=\"497\" height=\"1000\" /\u003e\n\u003c/p\u003e\n\nChoosing **Custom...** from this menu brings you to **RecurrenceOptionCreator**:\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/vikramkakkar/SublimePicker/blob/master/img/recurrence_option_creator_v2.png?raw=true\" width=\"497\" height=\"1000\" /\u003e\n\u003c/p\u003e\n\nPicking **Until a date** from the bottom spinner \u0026 clicking on the date shows a stripped down version of DatePicker:\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/vikramkakkar/SublimePicker/blob/master/img/recurrence_option_creator_end_date_v2.png?raw=true\" width=\"497\" height=\"1000\" /\u003e\n\u003c/p\u003e\n\n**Sample Application**:\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/vikramkakkar/SublimePicker/blob/master/img/sampler_v2.png?raw=true\" width=\"497\" height=\"1000\" /\u003e\n\u003c/p\u003e\n\nResults of the selection in **sample application** (single date):\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/vikramkakkar/SublimePicker/blob/master/img/sampler_results_single_date_v2.png?raw=true\" width=\"497\" height=\"1000\" /\u003e\n\u003c/p\u003e\n\nResults of the selection in **sample application** (date range):\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/vikramkakkar/SublimePicker/blob/master/img/sampler_results_date_range_v2.png?raw=true\" width=\"497\" height=\"1000\" /\u003e\n\u003c/p\u003e\n\n**How-to**s will be added in a day or two...\n\nLicense\n-------\n    Copyright (c) 2018 Vikram Kakkar\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\t\n\t\n\t\n[1]: https://play.google.com/store/apps/details?id=com.appeaser.sublimepicker\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvikramkakkar%2FSublimePicker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvikramkakkar%2FSublimePicker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvikramkakkar%2FSublimePicker/lists"}