vue-text-format 一个功能强大的vue自定义格式扩展 vue指令
插件介绍
用过excel格式设置的人,都了解excel格式定义功能的强大,几乎所有想要的格式,都可以设置。
因为前端也需要一个功能全的自定义格式扩展,vue-text-format这个扩展移植了excel的功能,可以在页面上方便的对数据改变显示格式。
使用方式也很简单,通过扩展vue的自定义命令v-format的形式,绑定格式,就可以将内部的文本进行转换。
使用方法
安装
npm install vue-text-format
import Vue from 'vue'
import format from 'vue-text-format';
Vue.use(format);
使用
通过v-format传入想要转换的格式,我们通过几个例子,让你了解一下这个格式代码功能到底有多全多强大
<div v-format="'0.##%'">0.123</div>
<!--最终显示的值是 【12.3%】转换百分比 -->
<div v-format="'0.00%'">0.123</div>
<!--最终显示的值是 【12.30%】 转换百分比,控制占位符-->
<div v-format="'#,##0.00'">1200000</div>
<!--最终显示的值是 【1,200,000.00】千分位 -->
<div v-format="'¥#,##0.00'">1200000</div>
<!--最终显示的值是 【¥1,200,000.00】前缀 -->
<div v-format="'0.00E+00'">1200000</div>
<!--最终显示的值是 【1.20E+06】科学计数法,有占位符 -->
<div v-format="'0.##E+##'">1200000</div>
<!--最终显示的值是 【1.2E+6】科学计数法,无有占位符 -->
<div v-format="'0000-00-00'">20180512</div>
<!--最终显示的值是 【2018-05-12】改变格式-->
<div v-format="'000-0000-0000'">13812345678</div>
<!--最终显示的值是 【138-1234-5678】手机号-->
<div v-format="'YYYY-MM-DD'">1562838244</div>
<!--最终显示的值是 【2019-07-11】时间-->
<div v-format="'??/??'">0.28</div>
<!--最终显示的值是 【7/25】两位数分母的近似分数-->
<div v-format="'?/?'">0.28</div>
<!--最终显示的值是 【2/7】一位数分母的近似分数-->
格式编码是一套完整的声明逻辑,可以通过组合扩展无限的显示方式,下面有完整的讲解,如果您觉得复杂,也可以有多种简单的使用方式。
1、excel里copy
您可以在excel里copy过来您需要的格式编码,就像文章开头的图片一样,剩下的就交给vue-text-format去做就好了。excel中功能的位置,单击“格式”菜单中的“单元格”命令,然后单击“数字”选项卡。选完想要的格式,切换到自定义就会出现它的格式。
2、常用代码事例
在后面的讲解中,都给了一些demo,通过copy和简单的组装这些demo,就能解决绝大部分问题。
格式编码介绍
如果你做一些更定制的格式,就需要了解一下格式编码声明,当然也可以看任何一篇excel自定义格式的文章
1、【 # 】数字占位符
只显有意义的零而不显示无意义的零。小数点后数字如大于”#”的数量,则按”#”的位数四舍五入。
代码 | 数字 | 显示 |
---|---|---|
###.## | 12.1 | 12.1 |
###.## | 12.1263 | 12.13 |
2、【 0 】数字占位符
如果单元格的内容大于占位符,则显示实际数字,如果小于点位符的数量,则用0补足。
代码 | 数字 | 显示 | 备注 |
---|---|---|---|
00000 | 1234567 | 1234567 | |
00000 | 123 | 00123 | |
00.000 | 100.14 | 100.140 | |
00.000 | 1.1 | 01.100 |
3、【 ? 】数字占位符
在小数点两边为无意义的零添加空格,以便当按固定宽度时,小数点可对齐,另外还用于对不等到长数字的分数
例:代码:【??.??】12.121 显示为【12.12】
例:代码:【???.???】12.121 显示为【 12.121】左侧有一个填充空格
例:代码:【???.????】12.121 显示为【 12.121 】左右各一个填充空格
代码 | 数字 | 显示 |
---|---|---|
??.?? | 12.121 | 12.12 |
???.??? | 12.121 | 【 12.121】填充空格 |
???.???? | 12.121 | 【 12.121 】填充空格 |
4、【 % 】百分比
“%”:百分比。
例:代码“#%”。“0.1”显示为“10%”
代码 | 数字 | 显示 |
---|---|---|
#% | 0.1 | 10% |
#.#% | 0.131 | 13.1% |
#.##% | 0.131 | 13.1% |
#.#0% | 0.131 | 13.10% |
5、【 , 】:千位分隔符
代码 | 文本 | 显示 |
---|---|---|
#,### | 12000 | 12,000 |
如时在代码中“,”之后为空,则把原来的数字缩小1000倍。
代码 | 文本 | 显示 | 备注 |
---|---|---|---|
#, | 10000 | 10 | |
#,"k" | 123123 | 123k | |
#,, | 1000000 | 1 | |
0,.# | 12345 | 12.3 | |
#.00, | 12345 | 12.35 | 设置千元显示且四舍五入保留两位小数 |
"人民币 "#,##0,,"百万" | 1234567890 | 人民币 1,235百万 |
6、正负零区分显示
正数格式;负数格式;零格式;文本格式
在自定义格式代码中,最多可以指定四个节;每个节之间用分号进行分隔,这四个节顺序定义了格式中的正数、负数、零和文本。
如果用户在表达方式中只指定两个节,则第一部分用于表示正数和零,第二部分用于表示负数。如果用户在表达方式中只指定了一个节,那么所有数字都会使用该格式。如果在表达方式中要跳过某一节,则对该节仅使用分号即可。
代码 | 文本 | 显示 |
---|---|---|
#;-#;"空" | 1 | 1 |
#;-#;"空" | 0 | 空 |
#;-#;"空" | -1 | -1 |
7、科学计数法
代码 | 文本 | 显示 |
---|---|---|
0.##E+## | 1200000 | 1.2E+6 |
0.00E+00 | 1200000 | 1.20E+06 |
8、【 @ 】文本占位符
如果只使用单个@,作用是引用原始文本
代码 | 文本 | 显示 |
---|---|---|
"集团"@"部" | 财务 | 集团财务部 |
如果使用多个@,则可以重复文本。
代码 | 文本 | 显示 |
---|---|---|
@@@ | 财务 | 财务财务财务 |
9、【 * 】用 * 后面跟着的字符,重复直到充满空余列宽
代码 | 文本 | 显示 |
---|---|---|
@*- | ABC | ABC-------------- |
¥*-# | 123123 | ¥----------123123 |
可就用于仿真密码保护
代码 | 文本 | 显示 |
---|---|---|
** | 123 | ************ |
10、【 \ 】和【""】用这种格式显示下一个字符。
"文本",显示双引号里面的文本。
“\”:显示下一个字符,和【"文本"】用途相同
代码 | 文本 | 显示 |
---|---|---|
#\元 | 123123 | 123123元 |
#"人民币" | 123123 | 123123人民币 |
11、【 [颜色] 】
用指定的颜色显示字符。可有八种颜色可选:红色、黑色、黄色,绿色、白色、兰色、青色和洋红。
例:代码:“[青色];[红色];[黄色];[兰色]”。显示结果为正数为青色,负数显示红色,零显示黄色,文本则显示为兰色
[颜色N]:是调用调色板中颜色,N是0~56之间的整数。
例:代码:“[颜色3]”。单元格显示的颜色为调色板上第3种颜色。
代码 | 文本 | 显示 |
---|---|---|
#,##0.00;[蓝色]-#,##0.00 | 1 | 1 |
#,##0.00;[蓝色]-#,##0.00 | -1 | -1(蓝色) |
12、条件
可以单元格内容判断后再设置格式,判断逻辑放到[ ]中括号里,例如[>1]代表>1的情况。条件格式化只限于使用三个条件,其中两个条件是明确的,另个是“所有的其他”。条件要放到方括号中。必须进行简单的比较。
代码 | 文本 | 显示 |
---|---|---|
[>1]"上升";[=1]"持平";"下降" | 1.2 | 上升 |
[>1]"上升";[=1]"持平";"下降" | 1 | 持平 |
[>1]"上升";[=1]"持平";"下降" | 0.8 | 下降 |
[>1][绿色];[=1][黄色];[红色] | 1.2 | 1.2 (绿色) |
[>1][绿色];[=1][黄色];[红色] | 1 | 1 (黄色) |
[>1][绿色];[=1][黄色];[红色] | 0.8 | 0.8 (红色) |
可以使用的运算符有:
运算符 | 含义 |
---|---|
= | 等于 |
> | 大于 |
< | 小于 |
>= | 大于等于 |
<= | 小于等于 |
<> | 不等于 |
13、 【 ! 】转义字符
由于引号是代码常用的符号。在单元格中是无法用【"】来显示出来“"”。要想显示出来,须在前加入“!” 【!"】
例:代码:【!"#!"】。【10】显示【"10"】
代码 | 文本 | 显示 |
---|---|---|
!"#!" | 10 | "10" |
14、时间和日期代码
常用日期和时间代码,绑定的是10位或13位的时间戳
“YYYY”或“YY”:按四位(1900~9999)或两位(00~99)显示年
“MM”或“M”:以两位(01~12)或一位(1~12)表示月。
“DD”或“D”:以两位(01~31)或一位(1~31)来表示天。
例:代码:“YYYY-MM-DD”。2005年1月10日显示为:“2005-01-10”
例:代码:“YY-M-D”。2005年10月10日显示为:“05-1-10”
“AAAA”:日期显示为星期。
“H”或“HH”:以一位(0~23)或两位(01~23)显示小时
“m”或“mm”:以一位(0~59)或两位(01~59)显示分钟
“s”或“ss”:以一位(0~59)或两位(01~59)显示秒
例:
代码 | 文本 | 显示 |
---|---|---|
YYYY-MM-DD | 1562838244 | 2019-07-11 |
YY-MM-DD | 1562838244 | 19-07-11 |
HH:mm:ss | 1562838244 | 17:44:04 |
15、【 _ 】:显示一个和【_】符号下一个“文本”同等宽度的空格
代码 | 文本 | 显示 |
---|---|---|
#_圆圆 | 123123 | 123123 圆 |
结尾
希望大家在需要的时候多多使用,也可以去下载源码共同学习
源码地址是
https://github.com/13601313270/vue-format
也可以加微信交流
微信号309568486