https://github.com/simonpoole/openinghoursfragment

Android UI element for displaying and editing an opening hours value
https://github.com/simonpoole/openinghoursfragment

android-library openstreetmap

Last synced: 6 days ago
JSON representation

Android UI element for displaying and editing an opening hours value

• Host: GitHub
• URL: https://github.com/simonpoole/openinghoursfragment
• Owner: simonpoole
• License: mit
• Created: 2015-08-20T16:07:23.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-11-25T12:20:22.000Z (28 days ago)
• Last Synced: 2024-11-25T13:25:49.283Z (28 days ago)
• Topics: android-library, openstreetmap
• Language: Java
• Size: 1.55 MB
• Stars: 9
• Watchers: 2
• Forks: 2
• Open Issues: 17
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.txt

Awesome Lists containing this project

README

        
[![build status](https://github.com/simonpoole/OpeningHoursFragment/actions/workflows/android.yml/badge.svg)](https://github.com/simonpoole/OpeningHoursFragment/actions) [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=OpeningHoursFragment%3Alib&metric=alert_status)](https://sonarcloud.io/dashboard?id=OpeningHoursFragment) [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=OpeningHoursFragment%3Alib&metric=coverage)](https://sonarcloud.io/dashboard?id=OpeningHoursFragment) [![sonarcloud bugs](https://sonarcloud.io/api/project_badges/measure?project=OpeningHoursFragment%3Alib&metric=bugs)](https://sonarcloud.io/component_measures?id=OpeningHoursFragment%3Alib&metric=bugs) [![sonarcould maintainability](https://sonarcloud.io/api/project_badges/measure?project=OpeningHoursFragment%3Alib&metric=sqale_rating)](https://sonarcloud.io/component_measures?id=OpeningHoursFragment%3Alib&metric=Maintainability) [![sonarcloud security](https://sonarcloud.io/api/project_badges/measure?project=OpeningHoursFragment%3Alib&metric=security_rating)](https://sonarcloud.io/component_measures?id=OpeningHoursFragment%3Alib&metric=Security) [![sonarcloud reliability](https://sonarcloud.io/api/project_badges/measure?project=OpeningHoursFragment%3Alib&metric=reliability_rating)](https://sonarcloud.io/component_measures?id=OpeningHoursFragment%3Alib&metric=Reliability)

# OpeningHoursFragment

This is a re-usable UI element for editing opening hour values that covers the complete specification, it is suitable for non-destructive editing (it will not overwrite or destroy valid opening hours values).

![Screenshot](documentation/images/Screenshot_basic.png)

Please see the [end user documentation](lib/documentation/docs/help/en/Opening%20hours.md) for more information. 

## Usage

### From a FragmentActivity

``` java

    FragmentManager fm = getSupportFragmentManager();

    ...

	OpeningHoursFragment openingHoursDialog = OpeningHoursFragment.newInstance(key,finalValue, R.style.Theme_AppCompat_Light_Dialog_Alert, -1, true);

	openingHoursDialog.show(fm, "fragment_opening_hours");

```

The calling activity needs to implement ch.poole.openinghoursfragement.OnSaveListener which will be used when the user saves a OH value. Have a look at the test app for a working trivial example.

### From a Fragment

``` java

    FragmentManager fm = getChildFragmentManager();

    ...

	OpeningHoursFragment openingHoursDialog = OpeningHoursFragment.newInstanceForFragment(key,finalValue, R.style.Theme_AppCompat_Light_Dialog_Alert, -1, true);

	openingHoursDialog.show(fm, "fragment_opening_hours");

```

The calling Fragment needs to implement ch.poole.openinghoursfragement.OnSaveListener which will be used when the user saves a OH value. Have a look at the test app for a working trivial example.

For other variants please see the javadoc.

If you are overriding onActivityResult in the Activity calling the Fragment, you need to check that you calling through to super, or else loading and saving templates will fail silently. 

## Including in your project

Add the following to your *build.gradle* file(s):

``` groovy

repositories {

    maven {

    	mavenCentral()

    }

}

```

``` groovy

dependencies {

    compile "ch.poole:OpeningHoursFragment:0.14.1"

}

```