{"id":13428169,"url":"https://github.com/faruktoptas/FancyShowCaseView","last_synced_at":"2025-03-16T01:31:59.330Z","repository":{"id":37774068,"uuid":"84318601","full_name":"faruktoptas/FancyShowCaseView","owner":"faruktoptas","description":"An easy-to-use customisable show case view with circular reveal animation.","archived":false,"fork":false,"pushed_at":"2024-10-14T03:49:12.000Z","size":4619,"stargazers_count":1964,"open_issues_count":9,"forks_count":275,"subscribers_count":29,"default_branch":"master","last_synced_at":"2024-10-16T10:24:36.148Z","etag":null,"topics":["android","android-development","android-library","android-ui","animation","circular-reveal","fancyshowcaseview","kotlin","kotlin-android","kotlin-library","material-design","material-ui"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","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/faruktoptas.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-03-08T12:37:15.000Z","updated_at":"2024-10-14T03:49:15.000Z","dependencies_parsed_at":"2024-09-13T08:14:07.882Z","dependency_job_id":null,"html_url":"https://github.com/faruktoptas/FancyShowCaseView","commit_stats":null,"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faruktoptas%2FFancyShowCaseView","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faruktoptas%2FFancyShowCaseView/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faruktoptas%2FFancyShowCaseView/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faruktoptas%2FFancyShowCaseView/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/faruktoptas","download_url":"https://codeload.github.com/faruktoptas/FancyShowCaseView/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221631873,"owners_count":16855019,"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":["android","android-development","android-library","android-ui","animation","circular-reveal","fancyshowcaseview","kotlin","kotlin-android","kotlin-library","material-design","material-ui"],"created_at":"2024-07-31T01:00:48.095Z","updated_at":"2025-03-16T01:31:59.323Z","avatar_url":"https://github.com/faruktoptas.png","language":"Kotlin","readme":"![FancyShowCaseView](https://user-images.githubusercontent.com/1595227/56747421-9aafc580-6786-11e9-9344-e3216f7aa660.png)\n\u003cp align=\"center\"\u003eAn easy-to-use customizable show case view with circular reveal animation.\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n        \u003ca href=\"https://github.com/faruktoptas/FancyShowCaseView/actions\"\u003e\u003cimg src=\"https://github.com/faruktoptas/FancyShowCaseView/workflows/build/badge.svg\" alt=\"Status\"/\u003e\u003c/a\u003e\n        \u003ca href=\"https://jitpack.io/#faruktoptas/FancyShowCaseView\"\u003e\u003cimg src=\"https://jitpack.io/v/faruktoptas/FancyShowCaseView.svg\" alt=\"Download\"/\u003e\u003c/a\u003e\n        \u003ca href=\"https://www.codacy.com/manual/faruktoptas/FancyShowCaseView?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=faruktoptas/FancyShowCaseView\u0026amp;utm_campaign=Badge_Grade\"\u003e\u003cimg src=\"https://app.codacy.com/project/badge/Grade/47050961b2d947d3a58292f50d74e110\" alt=\"\"/\u003e\u003c/a\u003e\n        \u003ca href=\"https://android-arsenal.com/details/1/5440\"\u003e\u003cimg src=\"https://img.shields.io/badge/Android%20Arsenal-FancyShowCaseView-brightgreen.svg?style=flat\" alt=\"\"/\u003e\u003c/a\u003e\n        \u003ca href=\"https://android-arsenal.com/api?level=10\"\u003e\u003cimg src=\"https://img.shields.io/badge/API-14%2B-blue.svg?style=flat\" alt=\"\"/\u003e\u003c/a\u003e\n        \u003ca href=\"https://gitter.im/faruktoptas/FancyShowCaseView?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge\"\u003e\u003cimg src=\"https://badges.gitter.im/faruktoptas/FancyShowCaseView.svg\" alt=\"\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n        \u003cimg src=\"https://cloud.githubusercontent.com/assets/1595227/24761426/f80dbc64-1af3-11e7-9c99-bca3dd836a8e.png\"/\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n        \u003ca href=\"https://material.uplabs.com/posts/fancyshowcaseview\"\u003e@MaterialUp Best of the Day\u003c/a\u003e\n\u003c/p\u003e\n\n## Features\n*   Circular reveal animation (API Level 21+)\n*   Focus on a specific view or position\n*   Background color\n*   Circle and Rounded Rectangle focus shapes\n*   Title style and position \n*   Custom view inflation\n*   Custom enter/exit animations\n*   Chaining multiple FancyShowCaseView instances\n*   Showing only one time\n\n![!gif](https://cloud.githubusercontent.com/assets/1595227/24331187/ad143b80-1237-11e7-919c-36111c1ce559.gif)![!gif](https://cloud.githubusercontent.com/assets/1595227/24331189/afec8d9e-1237-11e7-986d-0ab7c44db7c7.gif)\n\n## Download\nAdd this in your root `build.gradle` file (**not** your module `build.gradle` file):\n\n```gradle\nallprojects {\n    repositories {\n        ...\n        maven { url \"https://jitpack.io\" }\n    }\n}\n```\n\nThen, add the library to your module `build.gradle`\n```gradle\ndependencies {\n    implementation 'com.github.faruktoptas:FancyShowCaseView:1.4.0'\n}\n```\n\n## Sample Usage\n```java\nnew FancyShowCaseView.Builder(this)\n        .focusOn(view)\n        .title(\"Focus on View\")\n        .build()\n        .show();\n```\n\n## Supported Properties\n\n| Command | Description |\n| --- | --- |\n| `focusOn` | The view to be focused. |\n| `title` | The title text to be displayed.  |\n| `typeface` | The custom typeface for the title text. |\n| `titleStyle` | The text style for the title. (style defined in xml file) |\n| `titleGravity` | The gravity (alignment) of the title within the view (e.g., start, center, end). |\n| `titleSize` | The size of the title text, typically in sp units. |\n| `enableAutoTextPosition` | Center text position vertically. |\n| `backgroundColor` | The background color of the view, typically in hexadecimal or resource ID format. |\n| `fitSystemWindows` | This should be set to true, if your root view has this property set to true. |\n| `focusShape` | The shape of the focus area (e.g., rounded rectangle, circle). |\n| `focusBorderColor` | The color of the border around the focus area. |\n| `focusBorderSize` | The thickness of the border around the focus area (px) |\n| `focusDashedBorder` | Makes focus border dashed |\n| `roundRectRadius` | The radius for rounded corners when the focus shape is a rectangle with rounded edges. Use 0 for rectangle shape. |\n| `showOnce` | Determines if the focus should be shown only once. |\n| `clickableOn` | Let the touch event pass through to clickable view zone only if clicking within |\n| `focusCircleRadiusFactor` | Circle radius factor. Default value is 1. Bigger value makes bigger circle. |\n| `focusRectSizeFactor` | Focus rectangle size factor. Default value is 1. Bigger value makes bigger rectangle. |\n| `customView` | Use a fully customized view. If custom view used, title and title properties (titleStyle, titleGravity etc.) will be ignored. |\n| `closeOnTouch` | Closes the FancyShowCaseView when touching it. |\n| `enableTouchOnFocusedView` | Enables touching the focused view. Default value is false. |\n| `enterAnimation` |  |\n| `exitAnimation` |  |\n| `animationListener` |  |\n| `disableFocusAnimation` |  |\n| `focusAnimationMaxValue` | Focus animation max value. Bigger value makes larger focus area. |\n| `focusAnimationStep` | Step for focus animation. Default value is 1. |\n| `focusRectAtPosition` |  |\n| `focusCircleAtPosition` |  |\n| `dismissListener` |  |\n| `delay` | Shows the FancyShowCaseView after a delay. |\n\nPlease see [wiki](https://github.com/faruktoptas/FancyShowCaseView/wiki) for more samples.  \n\n## Already in use in following apps\n(feel free to send me new projects)\n\n*   [News - Newspaper \u0026 Magazine](https://play.google.com/store/apps/details?id=com.moblino.countrynews)\n*   [NN Senin Mobilin](https://play.google.com/store/apps/details?id=com.eteration.ing.mobile.android)\n*   [Umíme česky](https://play.google.com/store/apps/details?id=cz.muni.fi.umimecesky)\n*   [DHIS2 Capture](https://play.google.com/store/apps/details?id=com.dhis2)\n*   [Travel Weather - Forecast plan for your trip](https://play.google.com/store/apps/details?id=pozzo.apps.travelweather)\n*   [muSync for Spotify](https://play.google.com/store/apps/details?id=com.kloczl.musync.android)\n\n## Sample App\n [Latest Release](https://github.com/faruktoptas/FancyShowCaseView/releases)\n\n## Xamarin Port\nThanks to [DigitalSa1nt](https://github.com/DigitalSa1nt) for the Xamarin ported version [Xamarin.ShowcaseView](https://github.com/DigitalSa1nt/Xamarin.ShowcaseView)\n\n## Contribute\nYou can contribute by opening a pull request to **dev** branch.\nPlease try to push one feature in one commit for a clean commit history.\n\n## Buy Me a Coffee\n\n\u003ca href=\"https://www.buymeacoffee.com/faruktoptas\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: auto !important;width: auto !important;\" \u003e\u003c/a\u003e\n\n## License\n[Apache License 2.0](https://github.com/faruktoptas/FancyShowCaseView/blob/master/LICENSE)\n","funding_links":["https://www.buymeacoffee.com/faruktoptas"],"categories":["Libraries","引导图(Intro)"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaruktoptas%2FFancyShowCaseView","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffaruktoptas%2FFancyShowCaseView","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaruktoptas%2FFancyShowCaseView/lists"}