{"id":13469759,"url":"https://github.com/ClickerMonkey/dayspan-vuetify","last_synced_at":"2025-03-26T07:31:07.914Z","repository":{"id":32752479,"uuid":"136424350","full_name":"ClickerMonkey/dayspan-vuetify","owner":"ClickerMonkey","description":"A collection of components that visualizes DaySpan Calendars and Schedules using Vuetify","archived":false,"fork":false,"pushed_at":"2022-12-08T05:27:02.000Z","size":9054,"stargazers_count":1161,"open_issues_count":68,"forks_count":253,"subscribers_count":41,"default_branch":"master","last_synced_at":"2024-10-28T12:39:09.493Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ClickerMonkey.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":null,"patreon":"clickermonkey","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"custom":null}},"created_at":"2018-06-07T05:06:23.000Z","updated_at":"2024-10-26T23:42:34.000Z","dependencies_parsed_at":"2023-01-14T22:07:35.407Z","dependency_job_id":null,"html_url":"https://github.com/ClickerMonkey/dayspan-vuetify","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClickerMonkey%2Fdayspan-vuetify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClickerMonkey%2Fdayspan-vuetify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClickerMonkey%2Fdayspan-vuetify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClickerMonkey%2Fdayspan-vuetify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ClickerMonkey","download_url":"https://codeload.github.com/ClickerMonkey/dayspan-vuetify/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222118387,"owners_count":16934666,"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-07-31T15:01:54.770Z","updated_at":"2024-10-29T22:31:26.847Z","avatar_url":"https://github.com/ClickerMonkey.png","language":"Vue","readme":"# dayspan-vuetify\n\n\u003e A collection of components for Schedules and Calendars in DaySpan using Vuetify\n\nThis library strives to offer all the functionality any modern calendar app could support, and more. Not only can this be used for calendar apps, but any application where the user wishes to control when events should occur within a system.\n\n[Click here for a full app example](https://clickermonkey.github.io/dayspan-vuetify/example/)\n\nEvery feature of the library can be toggled with local and global settings, and all text can be localized.\n\n## Status\n\nThis library is nearing functional completion (documentation on every component, prop, event, slot, method will have to wait) but is still subject to the occasional small change in API.\n\n[Current documentation](docs/README.md)\n\n### Notice\n\n- This library uses v-html in a few places (to display event details for example) so you must sanitize your own data against XSS vulnerabilities.\n\n## Usage\n\nInstall with `npm install --save dayspan-vuetify`\n\n**This library works best with Vuetify \u003e= 1.1.9**\n\n```javascript\nimport DaySpanVuetify from 'dayspan-vuetify'\n\nVue.use( DaySpanVuetify, {\n  // options is vue definition, the resulting reactive component is stored in components as this.$dayspan or Vue.$dayspan\n  data: {\n    // data or computed to override\n  },\n  computed: {\n    // data or computed to override\n  },\n  methods: {\n    // methods to override\n  }\n});\n```\n\nTo see what options can be passed to the plugin, [checkout this file](src/component.js).\n\nOnce done, you can access components like `ds-event`, `ds-calendar`, and `ds-calendar-app` from any component (they are registered globally).\n\n## Example / Template\n\nCheckout [dayspan-vuetify-example](https://github.com/ClickerMonkey/dayspan-vuetify-example) for an example of a calendar app which saves events to localStorage.\n\n## Example Code\n\nInstall with `npm install --save dayspan-vuetify`\n\n#### app.js\n```javascript\nimport Vue from 'vue'\nimport Vuetify from 'vuetify'\nimport DaySpanVuetify from 'dayspan-vuetify'\nimport App from './App.vue'\n\nimport 'vuetify/dist/vuetify.min.css'\nimport 'material-design-icons-iconfont/dist/material-design-icons.css'\nimport 'dayspan-vuetify/dist/lib/dayspan-vuetify.min.css'\n\nVue.config.productionTip = false\n\nVue.use(Vuetify);\n\nVue.use(DaySpanVuetify, {\n  methods: {\n    getDefaultEventColor: () =\u003e '#1976d2'\n  }\n});\n\nnew Vue({\n  el: '#app',\n  render: h =\u003e h(App)\n})\n```\n\n#### App.vue\n```vue\n\u003ctemplate\u003e\n  \u003cv-app id=\"dayspan\" v-cloak\u003e\n    \u003cds-calendar-app :calendar=\"calendar\"\u003e\u003c/ds-calendar-app\u003e\n  \u003c/v-app\u003e\n\u003c/template\u003e\n\n\u003cscript\u003e\nimport { Calendar } from 'dayspan';\n\nexport default {\n  name: 'app',\n  data: () =\u003e ({\n    calendar: Calendar.months()\n  })\n}\n\u003c/script\u003e\n\n\u003cstyle\u003e\nbody, html, #app, #dayspan {\n  font-family: Roboto, sans-serif;\n  width: 100%;\n  height: 100%;\n}\n\u003c/style\u003e\n```\n\n#### index.html\n```html\n\u003c!DOCTYPE html\u003e\n\u003chtml\u003e\n  \u003chead\u003e\n    \u003clink href='https://fonts.googleapis.com/css?family=Roboto:300,400,500,700|Material+Icons' rel=\"stylesheet\"\u003e\n    \u003cmeta charset=\"utf-8\"\u003e\n    \u003cmeta name=\"viewport\" content=\"width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no, minimal-ui\"\u003e\n    \u003cmeta http-equiv=\"x-ua-compatible\" content=\"ie=edge\"\u003e\n    \u003ctitle\u003eYou Calendar App Title\u003c/title\u003e\n    \u003cstyle\u003e [v-cloak] { display: none; } \u003c/style\u003e\n  \u003c/head\u003e\n  \u003cbody\u003e\n    \u003cdiv id=\"app\"\u003e\u003c/div\u003e\n    \u003c!-- built files should be auto injected --\u003e\n  \u003c/body\u003e\n\u003c/html\u003e\n```\n\n### Locales\n\nThis library supports multiple locales but the build only comes with [en-us/en](https://github.com/ClickerMonkey/dayspan-vuetify/blob/master/src/locales/en.js). The following code shows you how to add locales, changing the current locale, and updating a given locale:\n\n```javascript\n// You can access $dayspan via Vue.$dayspan or this.$dayspan inside a component.\n\n$dayspan.setLocale('en'); // if en does not exist, this will have no affect\n$dayspan.setLocale('fr', true); // true was passed, so if the locale does not exist an error is thrown\n$dayspan.locales; // map of locale names to locale values\n\n// A locale is really just an object that overrides the values you specify found in $dayspan. A locale does not need to specify all possible values, just ones that should be overriden when setLocale is called.\n\n$dayspan.addLocale('es', {\n  promptLabels: {\n    // Are you sure you want to remove this event?\n    actionRemove: '¿Estás seguro de que quieres eliminar este evento?'\n  }\n});\n\n// Update locale (merge changes into locale)\n$dayspan.updateLocale('en', {\n  patterns: {\n    lastDay: (day) =\u003e 'Final day of the month'\n  }\n});\n```\n\n#### French Locale\n\n```javascript\nimport fr from 'dayspan-vuetify/src/locales/fr';\nimport Vue from 'vue';\n// dayspan-vuetify should already be loaded at this point\nVue.$dayspan.addLocales(['fr', 'fr-CA', 'fr-BE', 'fr-CH', 'fr-FR', 'fr-LU', 'fr-MC'], fr);\n```\n\n#### Dutch Locale\n\n```javascript\nimport nl from 'dayspan-vuetify/src/locales/nl';\nimport Vue from 'vue';\n// dayspan-vuetify should already be loaded at this point\nVue.$dayspan.addLocales(['nl', 'nl-NL', 'nl-BE'], nl);\n```\n\n#### German Locale\n\n```javascript\nimport de from 'dayspan-vuetify/src/locales/de';\nimport Vue from 'vue';\n// dayspan-vuetify should already be loaded at this point\nVue.$dayspan.addLocales(['de', 'de-DE', 'de-CH', 'de-AT', 'de-BE', 'de-IT', 'de-LI', 'de-LU'], de);\n```\n\n#### Catalan Locale\n\n```javascript\nimport ca from 'dayspan-vuetify/src/locales/ca';\nimport Vue from 'vue';\n// dayspan-vuetify should already be loaded at this point\nVue.$dayspan.addLocales(['ca', 'ca-ES'], ca);\n```\n\n## Build Setup\n\n``` bash\n# install dependencies\nnpm install\n\n# serve with hot reload at localhost:8080\nnpm run dev\n\n# build for production with minification\nnpm run build\n\n# build for production and view the bundle analyzer report\nnpm run build --report\n```\n\nFor detailed explanation on how things work, checkout the [guide](http://vuejs-templates.github.io/webpack/) and [docs for vue-loader](http://vuejs.github.io/vue-loader).\n","funding_links":["https://patreon.com/clickermonkey"],"categories":["Vue","🙌 Projects using Vuetify \u003ca name=\"projects\"\u003e\u003c/a\u003e"],"sub_categories":["Vuetify 2"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FClickerMonkey%2Fdayspan-vuetify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FClickerMonkey%2Fdayspan-vuetify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FClickerMonkey%2Fdayspan-vuetify/lists"}