Vue выгрузка в excel
Обновлено: 06.07.2024
JSON to Excel for VUE 2
Download your JSON data as an Excel file directly from the browser. This component is based on the solution proposed on this thread
Important! Extra prompt in Microsoft Excel
The method implemented in this component uses HTML tables to draw the .xls files, Microsoft Excel no longer recognize HTML as native content so a warning message will be displayed before opening the file. The content will be rendered perfectly but the message can't be avoided.
Get the package:
Register JsonExcel in your vue app entry point:
In your template
| Name | Type | Description | Default |
|---|---|---|---|
| data | Array | Data to be exported. | |
| fields | Object | Fields inside the JSON Object that you want to export. If none provided, all properties in the JSON will be exported. | |
| export-fields (exportFields) | Object | Used to fix the problem with other components that use the variable fields, like vee-validate. exportFields works exactly like fields | |
| type | string | Mime type [xls, csv] | xls |
| name | string | File name to export. | data.xls |
| header | string/Array | Title(s) for the data. Can be a string (one title) or an array of strings (multiple titles). | |
| title(deprecated) | string/Array | same as header, title is maintained for retro-compatibility purposes but its use is not recommended due to the conflict with the HTML5 title attribute. | |
| footer | string/Array | Footer(s) for the data. Can be a string (one footer) or an array of strings (multiple footers). | |
| default-value (defaultValue) | string | Use as fallback when the row has no field values. | '' |
| worksheet | string | Name of the worksheet tab. | 'Sheet1' |
| fetch | Function | Callback to fetch data before download, if it's set it runs immediately after mouse pressed and before download process. IMPORTANT: only works if no data prop is defined. | |
| before-generate | Function | Callback to call a method right before the generate / fetch data, eg:show loading progress | |
| before-finish | Function | Callback to call a method right before the download box pops out, eg:hide loading progress | |
| stringifyLongNum | Boolean | stringify long number and decimal(solve the problem of loss of digital accuracy), default: false | |
| escapeCsv | Boolean | This escapes CSV values in order to fix some excel problems with number fields. But this will wrap every csv data with =" and ", to avoid that you have to set this prop to false. default: True |
In your HTML call it like
- json_data: Contains the data you want to export.
- json_fields: You can select what fields to export. Specify nested data and assign labels to the fields. The key is the label, the value is the JSON field. This will export the field data 'as is'. If you need to customize the the exported data you can define a callback function. Thanks to @gucastiliao.
json_fields is a object that represents which columns will be exported. If no object is provided, the component will be use the first object in your data array to extract the keys as columns names. Json field example:
To export JSON as a CSV file, just add the prop type with a value of "csv":
Multi-line values will appear in a single cell
A single text value in the data that contains newline characters will appear as a single cell in Excel. This avoids the undesired behavior of multi-line values getting split into multiple cells that must be merged before using data filters and pivot tables.
Fetch Data on Demand
In case you need to fetch data from the server, you could use the fetch prop that allows you to define a callback function that is executed when your user click the download button. This function has to return a JSON value containing the data to export. A basic use case is:
when using callback functions in the fields description, you have three option to retrieve data:
- field: 'path.to.nested.property' you can retrieve a specific value using the nested property notation.
- field: 'define.nested.object' you can retrieve a nested object too.
- Or get the whole row if field is undefined.
This project is in an early stage of development. Any contribution is welcome :D
JSON to Excel for VUE 2
Download your JSON data as an Excel file directly from the browser. This component is based on the solution proposed on this thread
Important! Extra prompt in Microsoft Excel
The method implemented in this component uses HTML tables to draw the .xls files, Microsoft Excel no longer recognize HTML as native content so a warning message will be displayed before opening the file. The content will be rendered perfectly but the message can't be avoided.
Get the package:
Register JsonExcel in your vue app entry point:
In your template
| Name | Type | Description | Default |
|---|---|---|---|
| data | Array | Data to be exported. | |
| fields | Object | Fields inside the JSON Object that you want to export. If none provided, all properties in the JSON will be exported. | |
| export-fields (exportFields) | Object | Used to fix the problem with other components that use the variable fields, like vee-validate. exportFields works exactly like fields | |
| type | string | Mime type [xls, csv] | xls |
| name | string | File name to export. | data.xls |
| header | string/Array | Title(s) for the data. Can be a string (one title) or an array of strings (multiple titles). | |
| title(deprecated) | string/Array | same as header, title is maintained for retro-compatibility purposes but its use is not recommended due to the conflict with the HTML5 title attribute. | |
| footer | string/Array | Footer(s) for the data. Can be a string (one footer) or an array of strings (multiple footers). | |
| default-value (defaultValue) | string | Use as fallback when the row has no field values. | '' |
| worksheet | string | Name of the worksheet tab. | 'Sheet1' |
| fetch | Function | Callback to fetch data before download, if it's set it runs immediately after mouse pressed and before download process. IMPORTANT: only works if no data prop is defined. | |
| before-generate | Function | Callback to call a method right before the generate / fetch data, eg:show loading progress | |
| before-finish | Function | Callback to call a method right before the download box pops out, eg:hide loading progress | |
| stringifyLongNum | Boolean | stringify long number and decimal(solve the problem of loss of digital accuracy), default: false | |
| escapeCsv | Boolean | This escapes CSV values in order to fix some excel problems with number fields. But this will wrap every csv data with , to avoid that you have to set this prop to false. default: True |
In your HTML call it like
- json_data: Contains the data you want to export.
- json_fields: You can select what fields to export. Specify nested data and assign labels to the fields. The key is the label, the value is the JSON field. This will export the field data 'as is'. If you need to customize the the exported data you can define a callback function. Thanks to @gucastiliao.
json_fields is a object that represents which columns will be exported. If no object is provided, the component will be use the first object in your data array to extract the keys as columns names. Json field example:
To export JSON as a CSV file, just add the prop type with a value of "csv":
Multi-line values will appear in a single cell
A single text value in the data that contains newline characters will appear as a single cell in Excel. This avoids the undesired behavior of multi-line values getting split into multiple cells that must be merged before using data filters and pivot tables.
Fetch Data on Demand
In case you need to fetch data from the server, you could use the fetch prop that allows you to define a callback function that is executed when your user click the download button. This function has to return a JSON value containing the data to export. A basic use case is:
when using callback functions in the fields description, you have three option to retrieve data:
- field: 'path.to.nested.property' you can retrieve a specific value using the nested property notation.
- field: 'define.nested.object' you can retrieve a nested object too.
- Or get the whole row if field is undefined.
This project is in an early stage of development. Any contribution is welcome :D
The method implemented in this component use HTML tables to draw the .xls files, Microsoft Excel no longer recognize HTML as native content so will prompt a warning message before open the file. The content will be rendered perfectly but the message can't be avoid.
Getting started
Get the package:
Register JsonExcel in your app entrypoint:
In your template
Props List
| Name | Type | Description |
|---|---|---|
| data | Array | (required) Data to be exported |
| fields | Object | fields inside the Json Object that you want to export. If no given, all the properties in the Json are exported |
| export-fields (exportFields) | Object | this prop is used to fix the problem with other components that use the variable fields, like vee-validate. exportFields works exactly like fields |
| type | string | mime type [xls, csv], default: xls |
| name | string | filename to export, deault: data.xls |
| title | string/Array | Title(s) for the data, could be a string or an array of strings (multiple titles) |
| footer | string/Array | Footer(s) for the data, could be a string or an array of strings (multiple footers) |
Example
In your HTML call it like
- json_data: Contains the data you want to export,
- json_fields: You can select what fields to export, especify nested data and assign labels to the fields
the key is the label, the value is the JSON field. This will export the field data 'as is'.
If you need to customize the the exported data you can define a callback function. Thanks to @gucastiliao.
Export CSV
To export JSON to CSV file just add the prop type with value "csv":
JSON to Excel for VUE 2
Important! Extra prompt in Microsoft Excel
The method implemented in this component use HTML tables to draw the .xls files, Microsoft Excel no longer recognize HTML as native content so will prompt a warning message before open the file. The content will be rendered perfectly but the message can't be avoid.
Get the package:
Register excel in your app entrypoint:
In your template
| Name | Type | Description |
|---|---|---|
| data | Array | Data to be exported |
| fields | Object | fields inside the Json Object that you want to export. If no given, all the properties in the Json are exported |
| export-fields (exportFields) | Object | this prop is used to fix the problem with other components that use the variable fields, like vee-validate. exportFields works exactly like fields |
| type | string | mime type [xls, csv], default: xls |
| name | string | filename to export, deault: data.xls |
| title | string/Array | Title(s) for the data, could be a string or an array of strings (multiple titles) |
| footer | string/Array | Footer(s) for the data, could be a string or an array of strings (multiple footers) |
| default-value (defaultValue) | string | Use as fallback when the row has no field values, default: '' |
| worksheet | string | Name of the worksheet tab. default: 'Sheet1' |
| fetch | Function | Callback to fetch data before download, if it's set it runs immediately after mouse pressed and before download process. IMPORTANT: only works if no data prop is defined |
| before-generate | Function | Callback to call a method right before the generate / fetch data, eg:show loading progress |
| before-finish | Function | Callback to call a method right before the download box pops out, eg:hide loading progress |
In your HTML call it like
- json_data: Contains the data you want to export,
- json_fields: You can select what fields to export, especify nested data and assign labels to the fields the key is the label, the value is the JSON field. This will export the field data 'as is'. If you need to customize the the exported data you can define a callback function. Thanks to @gucastiliao.
To export JSON to CSV file just add the prop type with value "csv":
This project is in an early stage of development. Any contribution is welcome :D
Читайте также: