https://github.com/jbvincey/nestedradiobutton

An implementation of RadioButton and RadioGroup allowing to have radio buttons any layout level under a radiogroup.
https://github.com/jbvincey/nestedradiobutton

android android-app android-library android-ui

Last synced: 3 months ago
JSON representation

An implementation of RadioButton and RadioGroup allowing to have radio buttons any layout level under a radiogroup.

• Host: GitHub
• URL: https://github.com/jbvincey/nestedradiobutton
• Owner: jbvincey
• License: apache-2.0
• Created: 2018-03-11T16:17:50.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2021-04-21T13:28:09.000Z (almost 4 years ago)
• Last Synced: 2024-11-08T23:12:28.395Z (3 months ago)
• Topics: android, android-app, android-library, android-ui
• Language: Java
• Size: 693 KB
• Stars: 64
• Watchers: 2
• Forks: 11
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Maven Central release](https://img.shields.io/badge/MavenCentral-1.1-blue.svg?style=flat)](https://s01.oss.sonatype.org/service/local/repositories/releases/content/com/github/jbvincey/nestedradiobutton/1.1/)

[![GitHub license](https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg?style=flat)](http://www.apache.org/licenses/LICENSE-2.0)

NestedRadioButton

=======

NestedRadioButton lets you have any number of ViewGroup intermediates between your RadioButton and RadioGroup. This allows to embed your RadioButton in more complex selectable views (examples in sample). 

![NestedRadioButton overview](assets/nestedradiobutton_sample.png)

## Install

NestedRadioButton is available on **Maven Central**. To use in your project, simply add the following dependency to your app:

```gradle

dependencies {

    ...

    implementation 'com.github.jbvincey:nestedradiobutton:1.1'

    ...

}

```

#### Warning

NestedRadioButton used to be available on **JCenter** under the package name `com.jbvincey:nestedradiobutton`. Due to **JCenter** shutdown, the NestedRadioButton library has been migrated to **Maven Central** with a different package name `com.github.jbvincey:nestedradiobutton`. If you were pulling the NestedRadioButton library from **JCenter**, make sure to add **Maven Central** repository in your configuration and to update the package name of NestedRadioButton library.

## Usage

```xml

    

        

...

```

In your layout, use one of the 4 nested ViewGroup implementation among :

 * `NestedLinearRadioGroup`

 * `NestedConstraintRadioGroup`

 * `NestedRelativeRadioGroup`

 * `NestedFrameRadioGroup`

 

Then you can use `NestedRadioButton` at any hierarchy level under your nested ViewGroup. 

The `app:checkedButton` attribute in the nested ViewGroup allows to define the radio button checked by default in your layout. The `app:clickableParent` attribute in NestedRadioButton lets you define a parent ViewGroup that will check the RadioButton on click to this ViewGroup.

## Contributors

Jean-Baptiste VINCEY, [email protected]

License

=======

    Copyright 2018 Jean-Baptiste VINCEY.

    Licensed under the Apache License, Version 2.0 (the "License");

    you may not use this file except in compliance with the License.

    You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software

    distributed under the License is distributed on an "AS IS" BASIS,

    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    See the License for the specific language governing permissions and

    limitations under the License.