{"id":20198542,"url":"https://github.com/eclipsesource/tabris-plugin-calendar","last_synced_at":"2025-04-10T10:53:16.817Z","repository":{"id":65513919,"uuid":"41302357","full_name":"eclipsesource/tabris-plugin-calendar","owner":"eclipsesource","description":"A custom calendar widget for Tabris.js","archived":false,"fork":false,"pushed_at":"2019-10-01T14:31:07.000Z","size":246,"stargazers_count":4,"open_issues_count":1,"forks_count":1,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-03-24T09:47:03.428Z","etag":null,"topics":["android","calendar-widget","tabris","tabris-js"],"latest_commit_sha":null,"homepage":null,"language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eclipsesource.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":"2015-08-24T12:41:25.000Z","updated_at":"2019-10-01T14:31:09.000Z","dependencies_parsed_at":"2023-01-26T21:01:21.470Z","dependency_job_id":null,"html_url":"https://github.com/eclipsesource/tabris-plugin-calendar","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipsesource%2Ftabris-plugin-calendar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipsesource%2Ftabris-plugin-calendar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipsesource%2Ftabris-plugin-calendar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipsesource%2Ftabris-plugin-calendar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eclipsesource","download_url":"https://codeload.github.com/eclipsesource/tabris-plugin-calendar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248125991,"owners_count":21051845,"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","calendar-widget","tabris","tabris-js"],"created_at":"2024-11-14T04:32:05.466Z","updated_at":"2025-04-10T10:53:16.782Z","avatar_url":"https://github.com/eclipsesource.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tabris.js Calendar Plugin\n\nA calendar widget for [Tabris.js](https://tabrisjs.com), allowing to show and pick a date. Currently only Android is supported.\n\n![Calendar widget on Android](assets/screenshots/calendar-widget-android.png)\n\n## Compatibility\n\nCompatible with [Tabris.js 3.x](https://github.com/eclipsesource/tabris-js/releases/tag/v3.0.0). For [Tabris.js 2.x](https://github.com/eclipsesource/tabris-js/releases/tag/v3.0.0) compatibility see the branch [1.x-tabris-2.x](https://github.com/eclipsesource/tabris-plugin-calendar/tree/1.x-tabris-2.x).\n\n## Example\n\nThe following snippet shows how the `tabris-plugin-calendar` plugin can be used in a Tabris.js app:\n\n```javascript\nnew escalendar.Calendar({\n  left: 0, right: 0, top: 0, bottom: 0,\n  date: 946684800000 // year 2000\n}).on('dateChanged', ({value: date}) =\u003e console.log(date))\n  .appendTo(tabris.ui.contentView);\n```\nA more elaborate example can be found in the [example](example/) folder. It provides a Tabris.js project that demonstrates the various features of the `tabris-plugin-calendar` widget. Consult the [README](example/README.md) of the example for build instructions.\n\n## Integrating the plugin\nThe Tabris.js website provides detailed information on how to [integrate custom widgets](https://tabrisjs.com/documentation/latest/build#adding-plugins) in your Tabris.js app. To add the plugin to your app add the following entry in your apps `config.xml`:\n\n```xml\n\u003cplugin name=\"tabris-plugin-calendar\" spec=\"^1.0.0\" /\u003e\n```\n\nTo fetch the latest development version use the GitHub URL:\n\n```xml\n\u003cplugin name=\"tabris-plugin-calendar\" spec=\"https://github.com/eclipsesource/tabris-plugin-calendar.git\" /\u003e\n```\n\n## API\n\nThe widget api consists of the object `escalendar.Calendar` with the following properties and events.\n\n### Properties\n\nThe following properties can be applied on top of the [common Tabris.js properties](https://tabrisjs.com/documentation/latest/api/Widget#properties):\n\n* `date` : _number_\n  * The currently selected date as a unix timestamp in milliseconds\n* `minDate` : _number_\n  * The minimum date as a unix timestamp in milliseconds.  Defaults to January 1 1900\n* `maxDate` : _number_\n  * The maximum date as a unix timestamp in milliseconds.  Defaults to January 1 2100\n\n### Events\n\n#### dateChanged\n\nFired when the user selects a date in the calendar widget.\n\n##### Event parameter\n* `event.value`: _number_\n  * The new date as a unix timestamp in milliseconds\n\n### Supported platforms\n\n * Android\n\n## Development of the widget\n\nWhile not required by the consumer or the widget, this repository provides a `project` folder that contains platform specific development artifacts. These artifacts allow to more easily consume the native source code when developing the native parts of the widget.\n\n### Android\n\nThe project provides a gradle based build configuration, which also allows to import the project into Android Studio.\n\nIn order to reference the Tabris.js specific APIs, the environment variable `TABRIS_ANDROID_PLATFORM` has to point to the Tabris.js Android Cordova platform root directory.\n\n```bash\nexport TABRIS_ANDROID_PLATFORM=/home/user/tabris-android-cordova\n```\n The environment variable is consumed in the gradle projects [build.gradle](project/android/build.gradle) file.\n\n## Copyright\n\n See [LICENSE](LICENSE) notice.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feclipsesource%2Ftabris-plugin-calendar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feclipsesource%2Ftabris-plugin-calendar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feclipsesource%2Ftabris-plugin-calendar/lists"}