{"id":20645864,"url":"https://github.com/victorboissiere/vue-xls-csv-parser","last_synced_at":"2025-07-29T11:32:54.313Z","repository":{"id":21982277,"uuid":"94550965","full_name":"victorboissiere/vue-xls-csv-parser","owner":"victorboissiere","description":"Simple VueJS component to parse XLS/CSV files with validation","archived":false,"fork":false,"pushed_at":"2022-12-07T01:15:04.000Z","size":11284,"stargazers_count":27,"open_issues_count":24,"forks_count":21,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-06-25T21:06:08.989Z","etag":null,"topics":["csv","parser","vuejs","xlsx"],"latest_commit_sha":null,"homepage":"","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/victorboissiere.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":"2017-06-16T14:19:11.000Z","updated_at":"2025-06-24T20:45:16.000Z","dependencies_parsed_at":"2023-01-12T03:46:20.912Z","dependency_job_id":null,"html_url":"https://github.com/victorboissiere/vue-xls-csv-parser","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/victorboissiere/vue-xls-csv-parser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorboissiere%2Fvue-xls-csv-parser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorboissiere%2Fvue-xls-csv-parser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorboissiere%2Fvue-xls-csv-parser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorboissiere%2Fvue-xls-csv-parser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/victorboissiere","download_url":"https://codeload.github.com/victorboissiere/vue-xls-csv-parser/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/victorboissiere%2Fvue-xls-csv-parser/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267678448,"owners_count":24126333,"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","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["csv","parser","vuejs","xlsx"],"created_at":"2024-11-16T16:22:27.668Z","updated_at":"2025-07-29T11:32:54.297Z","avatar_url":"https://github.com/victorboissiere.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vue XLS/CSV parser\n\n## Description\n\nThis npm package will help you parse XLS/CSV files and validate them. The user will be asked to associate his file columns with the columns you require. Once validated, an event will be triggered where you will be able to get only the data you need.\n\n![Demo](wiki/demo.gif)\n\n## Requirements\n\nYou will need Bootstrap 3.x. It has not been tested yet with Boostrap 4.\n\n## Components\n\n### XlsCsvParser\n\n#### Props\n\n| Name        | Type           | Description  |\n| ------------ |:-------------:| -----:|\n| columns (required) | Array | An array of object representing the columns you required: `[{ name: 'Student login', value: 'login', isOptional: false }]` |\n| validateButtonId | String | The id of the custom validate button. The component validation button will not be displayed |\n| help | String  |  Help text shown on the file dropzone |\n| lang | String | `en`, `nl` or `fr`. Default: `en` |\n\n#### Events\n\n- `onValidate(results)`: all the data parsed by the component and returned after the user validation\n\n#### Example usage\n\n```html\n\u003ctemplate\u003e\n  \u003cdiv class=\"app\"\u003e\n    \u003ch3\u003eExample - Import file with required login, firstname, lastname and optional values\u003c/h3\u003e\n    \u003cbr\u003e\n    \u003cxls-csv-parser :columns=\"columns\" @on-validate=\"onValidate\" :help=\"help\" lang=\"en\"\u003e\u003c/xls-csv-parser\u003e\n    \u003cbr\u003e\u003cbr\u003e\n    \u003cdiv class=\"results\" v-if=\"results\"\u003e\n      \u003ch3\u003eResults:\u003c/h3\u003e\n      \u003cpre\u003e{{ JSON.stringify(results, null, 2) }}\u003c/pre\u003e\n    \u003c/div\u003e\n  \u003c/div\u003e\n\u003c/template\u003e\n\n\u003cscript\u003e\n  import { XlsCsvParser } from 'vue-xls-csv-parser';\n  export default {\n    name: 'App',\n    components: {\n      XlsCsvParser,\n    },\n    methods: {\n      onValidate(results) {\n        this.results = results;\n      },\n    },\n    data() {\n      return {\n        columns: [\n          { name: 'Student login', value: 'login' },\n          { name: 'Student firstname', value: 'firstname' },\n          { name: 'Student lastname', value: 'lastname' },\n          { name: 'Other', value: 'other', isOptional: true },\n        ],\n        results: null,\n        help: 'Necessary columns are: login, firstname and lastname',\n      };\n    },\n  };\n\u003c/script\u003e\n```\n\n## Tests\n\nSimpliy run `yarn mocha`.\n\n## Build Setup\n\n``` bash\n# install dependencies\nyarn intall\n\n# serve with hot reload at localhost:8080\nyarn start\n\n# build for a release\nyarn bundle:dist\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictorboissiere%2Fvue-xls-csv-parser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvictorboissiere%2Fvue-xls-csv-parser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvictorboissiere%2Fvue-xls-csv-parser/lists"}