{"id":24143638,"url":"https://github.com/pgreze/android-reactions","last_synced_at":"2025-04-09T19:21:23.149Z","repository":{"id":37932750,"uuid":"158549952","full_name":"pgreze/android-reactions","owner":"pgreze","description":"Facebook like reaction picker for Android","archived":false,"fork":false,"pushed_at":"2021-07-05T05:19:11.000Z","size":449,"stargazers_count":161,"open_issues_count":13,"forks_count":46,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-02T12:59:40.474Z","etag":null,"topics":["android","android-reactions","facebook","java","kotlin"],"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/pgreze.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":"2018-11-21T13:11:32.000Z","updated_at":"2025-01-14T13:10:52.000Z","dependencies_parsed_at":"2022-07-21T04:39:08.337Z","dependency_job_id":null,"html_url":"https://github.com/pgreze/android-reactions","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pgreze%2Fandroid-reactions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pgreze%2Fandroid-reactions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pgreze%2Fandroid-reactions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pgreze%2Fandroid-reactions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pgreze","download_url":"https://codeload.github.com/pgreze/android-reactions/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248095171,"owners_count":21046803,"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-reactions","facebook","java","kotlin"],"created_at":"2025-01-12T05:28:11.116Z","updated_at":"2025-04-09T19:21:23.103Z","avatar_url":"https://github.com/pgreze.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Android reactions [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![Build Status](https://github.com/pgreze/android-reactions/workflows/Build/badge.svg)](https://github.com/pgreze/android-reactions/actions?query=workflow%3ABuild)\n\nAn open source and fully customizable implementation of the\n[Facebook reactions](https://en.facebookbrand.com/assets/reactions) pattern.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/pgreze/android-reactions/master/resources/demo.gif\" alt=\"Demo\"\u003e\n\u003c/p\u003e\n\n⚠️ Disclaimer: this library is in a maintenance mode (I'm not using it anymore) and maybe lacks some features you may want (design UI libraries is hard).\nFeel free to fork it and add your own features, and hopefully open a PR to give back to the community.\n\nAlternatives:\n1. https://github.com/amrdeveloper/ReactButton\n\n# Installation [![central](https://maven-badges.herokuapp.com/maven-central/com.github.pgreze/android-reactions/badge.svg?style={style})](https://search.maven.org/artifact/com.github.pgreze/android-reactions)\n\n```groovy\nrepositories {\n    mavenCentral()\n}\n\ndependencies {\n    // Check the 🔝 maven central badge 🔝 for latest $version\n    implementation \"com.github.pgreze:android-reactions:$version\"\n}\n```\n\n# Usage [![](https://img.shields.io/badge/dokka-read-blue)](https://android-reactions.netlify.app/)\n\nSee [Java](sample/src/main/java/com/github/pgreze/reactions/sample/MainActivity.java)\nor [Kotlin](sample/src/main/java/com/github/pgreze/reactions/sample/KotlinSamples.kt) samples.\n\n1. Popup creation:\n\nKotlin DSL:\n\n```kotlin\nval config = reactionConfig(context) {\n    reactions {\n        resId    { R.drawable.ic_fb_like }\n        resId    { R.drawable.ic_fb_love }\n        resId    { R.drawable.ic_fb_laugh }\n        reaction { R.drawable.ic_fb_wow scale ImageView.ScaleType.FIT_XY }\n        reaction { R.drawable.ic_fb_sad scale ImageView.ScaleType.FIT_XY }\n        reaction { R.drawable.ic_fb_angry scale ImageView.ScaleType.FIT_XY }\n    }\n}\n\nval popup = ReactionPopup(context, config) { position -\u003e true.also {\n    // position = -1 if no selection\n} }\n```\n\nJava:\n\n```java\nReactionsConfig config = new ReactionsConfigBuilder(context)\n    .withReactions(new int[]{\n        R.drawable.ic_fb_like,\n        R.drawable.ic_fb_love,\n        R.drawable.ic_fb_laugh,\n        R.drawable.ic_fb_wow,\n        R.drawable.ic_fb_sad,\n        R.drawable.ic_fb_angry\n    })\n    .build()\n\nReactionPopup popup = new ReactionPopup(context, config, (position) -\u003e {\n    return true; // true is closing popup, false is requesting a new selection\n});\n```\n\n2. Bind popup with a button/view:\n\n```java\nView reactionButton = findViewById(R.id.reaction_button);\nreactionButton.setOnTouchListener(popup);\n```\n\nNotice: if button is inside a scroll view, you need to temporarily disable it:\n\n```kotlin\nreactionButton.setOnTouchListener { v, event -\u003e\n    // Avoid scroll view to consume events\n    scrollView.requestDisallowInterceptTouchEvent(true)\n    // Resolve reactions selection\n    popup.onTouch(v, event)\n}\n```\n\n3. Additional config:\n\nKotlin:\n\n```kotlin\nval popup = reactionPopup(this, ::onReactionSelected) {\n    // Reaction DSL\n    reactions(scaleType = ImageView.ScaleType.FIT_XY) {\n        resId    { R.drawable.img1 }\n        drawable { Drawable(...) }\n        reaction { R.drawable.img3 scale ImageView.ScaleType.FIT_CENTER }\n        reaction { Drawable(...) scale ImageView.ScaleType.FIT_CENTER }\n    }\n    // Alternative with drawable resource id array\n    reactionsIds = intArrayOf(R.drawable.img1, R.drawable.img2, R.drawable.img3)\n\n    // Optional popup style\n    popupGravity = PopupGravity.DEFAULT\n    popupMargin = resources.getDimensionPixelSize(R.dimen.horizontal_margin)\n    popupCornerRadius = TypedValue.applyDimension(COMPLEX_UNIT_DIP, cornerSizeInDp.toFloat(), resources.displayMetrics)\n    popupColor = Color.WHITE\n    popupAlphaValue = 230\n\n    // Optional item style\n    reactionSize = resources.getDimensionPixelSize(R.dimen.item_size)\n    horizontalMargin = resources.getDimensionPixelSize(R.dimen.item_margin)\n    verticalMargin = resources.getDimensionPixelSize(R.dimen.item_margin)\n\n    // Text provider\n    reactionTextProvider = { position -\u003e \"Item $position\" }\n    reactionTexts = R.array.descriptions\n    // Text styles\n    textBackground = ColorDrawable(Color.TRANSPARENT)\n    textColor = Color.BLACK\n    textHorizontalPadding = resources.getDimension(R.dimen.text_padding)\n    textVerticalPadding = resources.getDimension(R.dimen.text_padding)\n}\n```\n\nJava:\n\n```java\n// With resources\n.withReactions(new int[]{ R.drawable.ic_fb_like, R.drawable.ic_fb_love })\n// With drawables\n.withReactions(Arrays.asList(drawable1, drawable2))\n// item size (default: 24dp)\n.withReactionSize(getResources().getDimensionPixelSize(R.dimen.item_size))\n// Horizontal margin (default: 8dp)\n.withHorizontalReactionMargin(margin)\n// Vertical margin (default: 8dp)\n.withVerticalReactionMargin(margin / 2)\n// Override popup gravity\n.withPopupGravity(PopupGravity.PARENT_RIGHT)\n// Margin between items (default: R.dimen.reactions_item_margin)\n.withPopupMargin(margin)\n// Popup corners radius (default: 90)\n.withCornerRadius(getResources().getDimensionPixelSize(R.dimen.corner_radius))\n// Change popup color (default: white)\n.withPopupColor(Color.LTGRAY)\n// Popup background alpha value between 0 (full transparent) and 255 (full opaque) (default: 230)\n.withPopupAlphaValue(255)\n// Item text provider / string array (default: no texts)\n.withReactionTexts(position -\u003e descriptions[position])\n.withReactionTexts(R.array.descriptions)\n// Text popup background (default: #44000000 circle)\n.withTextBackground(new ColorDrawable(Color.TRANSPARENT))\n// Text color (default: white)\n.withTextColor(Color.BLACK)\n// Text horizontal margin (default: 12dp)\n.withTextHorizontalPadding(0)\n// Text vertical margin (default: 4dp)\n.withTextVerticalPadding(0)\n// Text size (default: 8sp)\n.withTextSize(getResources().getDimension(R.dimen.text_size))\n```\n\n# Credits\n\n- [Hardyk/FbReactionDemo](https://github.com/Hardyk/FbReactionDemo)\n- [coinranking/cryptocurrency-icons](https://github.com/coinranking/cryptocurrency-icons)\n- [LICEcap](https://www.cockos.com/licecap/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpgreze%2Fandroid-reactions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpgreze%2Fandroid-reactions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpgreze%2Fandroid-reactions/lists"}