{"id":17359195,"url":"https://github.com/deeleman/polymer-carousel","last_synced_at":"2025-03-27T15:26:46.542Z","repository":{"id":28777417,"uuid":"32299935","full_name":"deeleman/polymer-carousel","owner":"deeleman","description":"A reusable Polymer component for rendering responsive image slideshows","archived":false,"fork":false,"pushed_at":"2015-03-16T12:00:33.000Z","size":1112,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-01T19:22:02.829Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deeleman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-16T03:48:51.000Z","updated_at":"2015-03-16T12:00:33.000Z","dependencies_parsed_at":"2022-09-01T23:50:15.915Z","dependency_job_id":null,"html_url":"https://github.com/deeleman/polymer-carousel","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deeleman%2Fpolymer-carousel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deeleman%2Fpolymer-carousel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deeleman%2Fpolymer-carousel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deeleman%2Fpolymer-carousel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deeleman","download_url":"https://codeload.github.com/deeleman/polymer-carousel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245870379,"owners_count":20686017,"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":[],"created_at":"2024-10-15T19:08:32.001Z","updated_at":"2025-03-27T15:26:46.509Z","avatar_url":"https://github.com/deeleman.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# polymer-carousel\nA reusable Polymer component for rendering (still not responsive) image slideshows\n\n### A. Documentation in progress\nThe current project lacks from a  decent documentation yet. In the meantime, refer to the code in order to understand its functionality and follow the instructions below to setup a working environment for it, building or even packaging the component.\n\n**Please note:** This is a humble research project. In order to better test and benchmark the differences between building components on Polymer and using plain vanilla JavaScript, a [branch with a plain vanilla Javascript implementation](https://github.com/deeleman/polymer-carousel/tree/plain-vanilla-carousel) has been added to this project.\n\n### B. Yet to be done\nThe following is a list of stuff still required before going gold:\n\n* The component should expose public `width`and `height` properties and honor them where defined. Resizing itself on a fluid way otherwise.\n* Images should adapt themselves to the container and not all the way around.\n* Add a unit testing layer based on the Mocha test runner and the Chai assertion library according to the [vendor guidelines](https://www.polymer-project.org/0.5/articles/unit-testing-elements.html).\n* Replace the *fade in* transition by horizontal/vertical sliding\n* Polyfill transitions with jQuery animate (or any other CSS transitions polifyll library) for MSIE9\n* Support for mobile gestures such as `swipeLeft` and `swipeRight`.\n\n### C. Installation and deployment\n\n#### C.1. Installing dependencies\n\nAll dependencies are managed by means of NPM, except for the basic platform files for building Polymer applications. These are managed by means of Bower using Gulp as a friednly interface.\n\nPlease open a terminal window and proceed with installation by means of the following command:\n\n````\n$ npm install\n`````\n\n##### C.2. Working against the component\n\nIn order to ease the development tasks for maintaining the component you can run the dev tools provided:\n\n```\n$ gulp dev\n````\n\nBasically all Polymer dependencies will be downloaded through Bower and the JavaScript and SCSS files will be build and watched for changes.\n\n\n##### C.3. Building the component\n\nIn a similar fashion as we did previously, you just need to execute the following and... Profit! The component and its subcomponents can be then consumed form the `/components/carousel-slideshow` folder.\n\n```\n$ gulp build\n````\n\n##### C.4. Packaging the component\n\nThe component and all its dependencies can be bundled in a single file to ease its distribution. For doing so, make sure a convenient gulp task will build and package the component for you by executing the following command:\n\n```\n$ gulp package\n````\n\nThe component and all its dependencies including the files required for bootstrapping the component will be bundled into a single file for your convenience, located at `/components/packaged/polymer-carousel.html`. If you want to check the component live a demo has been added for your convenience, and can be viewed at `/demo/index.html`. Feel free to take a look into it by spawning a web server of your choice at the root folder. Eg\n\n```\n$ git clone https://github.com/deeleman/polymer-carousel.git\n$ cd polymer-carousel\n$ npm install\n$ gulp package\n$ python -m SimpleHTTPServer 8080\n```\n\nThe contents will be available for your viewing pleasure at [http://localhost:8080](http://localhost:8080) then.\n\n###### Please note: This a very early work in progress and is not meant for release.\n\n### License\n\nCopyright (C) 2015, Paul Deeleman \u003cdeeleman@gmail.com\u003e\nPermission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeeleman%2Fpolymer-carousel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeeleman%2Fpolymer-carousel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeeleman%2Fpolymer-carousel/lists"}