1.6.8 • Published 4 years ago
yhongm_rv.js v1.6.8
rv.js 一个 JavaScript 框架
无任何依赖
虚拟 dom
数据驱动视图更新
声明式组件化
HTML 语法声明组件
使用方法:
安装:
npm install yhongm_rv.js
一. 基本使用:
- 符号说明:
"%# #%" 数据占位符。html模板中的数据占位符最终会渲染成data中对应的真实数据
"{ }" 函数运行符。html模板中的函数运行符最终会将JavaScript函数返回的真实数据渲染到dom中。("{}"中可以使用"%##%"数据占位符,"{}"最终会将JavaScript函数返回值和数据占位符在data中的对应真实数据拼接成字符串后渲染到dom,比如"
{%#id#%+'_icon'}",假如id对应在data中为1,那么渲染到dom中为"1_icon"。假如"{}"中不包含%##%,那么直接将JavaScript函数运行结果渲染到dom)
"for="value _in_ values" for _in_ 循环指令。html模板中遍历数据渲染页面.
"childDomData" 将当前dom中data传到子dom中("适用于当前dom为父dom通过for指令渲染,但当前dom不通过for指令渲染子dom,仅仅将当前dom中data传递到子dom中。 childDomData="$this" 当前dom为非for指令渲染的子dom时候使用,因为当前dom子dom无法访问for指令对应的Array data,所以将当前dom data直接传递给子dom.childDomData="$this"传递的data,子dom中使用对应数据,不需要使用.访问对应数据")
"domData" 将父dom中data传递到当前dom中("适用于当前dom为父dom通过for指令渲染,当前dom通过for指令渲染子dom,需要将父dom中对应当前dom的Array data传递到当前dom,以便当前dom可以通过for指令渲染子dom")
rv-event="eventName" 用于监听事件(包括Window 事件属性,Form 事件,Keyboard 事件,Mouse 事件等等)。eventName为在当前RV对象methods中声明的函数。事件参数会通过参数传递到eventName函数中。
rv-watch="value" 用于观察input标签value值,value值变化会自动更新data中对应value
- demo 及使用说明
let myData = {
parent: "parent",
child: "child",
pcolor: "red",
c1color: "blue",
c2color: "green",
child2: "child2",
time: 10000,
pkey: "dddd",
componentColor: "red", //用于自定义组件的数据
componentCotent: "componentCotent 888", //用于自定义组件的数据
componentValue: "componentValue 888", //用于自定义组件的数据组件
week: [
{
id: 11,
content: "111",
},
{
id: 22,
content: "222",
},
{
id: 33,
content: "333",
},
],
};
window.data = myData; //控制台修改data数据,视图自动刷新内容
var rv = new RV({
//创建对象
el: "#app", //el对象挂载的节点
style: ``, //css样式
data: myData, //数据对象,用于驱动视图更新,数据变化,视图自动更新
template: `<div key="1" style="color:%#pcolor#%,width:100px,height:100px" onclick="clickDiv()">
"%#parent#%"
<p key="2" style="color:%#c1color#%,width:50px,height:50px" onclick="clickP1()">
"%#child#%"
</p>
<p key="3" style="color:%#c2color#%,width:50px,height:50px" onclick="clickP2()">
"%#child2#%"
</p>
<div key="4">
<p key="{%#v.id#%+'_content'}" childDomData="v" for="v _in_ week" domData="week">"%#v.content#%"</p>
</div>
<MyComponent content="%#componentCotent#%" time="{Math.floor(new Date()/1000)+'_ttt'}" value="%#componentValue#%" key="888"></MyComponent>
</div>`,
});
//rv.watch("key",callback) 观察data数据对象对应key的数值变化,变化触发callback
rv.watch("parent", () => {
alert("parent,change");
});
rv.watch("child", () => {
alert("child,change");
});
rv.watch("child2", () => {
alert("child2,change");
});
rv.methods({
//为rv对象添加函数,函数中this指向本rv对象
test1(){
this.methods.test2()//调用test2()函数
}
test2(){
this.data // 访问data数据
}
})
rv.run(callback); //callback 运行时候执行的函数
function clickDiv() {
rv.data.parent = `click Div time:${new Date() / 1000}`; //点击更新data,视图自动更新
}
function clickP1() {
rv.data.child = `click p1 time:${new Date() / 1000}`; //点击更新data变化,视图自动更新
}
function clickP2() {
rv.data.child2 = `click p2 time:${new Date() / 1000}`; //点击更新data变化,视图自动更新
}
- for="value in values" 指令在 RV 模板中的 demo 使用以及说明:
<tbody
cellspacing="0"
cellpadding="0"
id="calendar"
style="text-decoration: none;width: 170;background-color: #C0D0E8;font-size: 9pt;border: 0px dotted #1C6FA5;"
align="center"
border="1"
key="tbody"
>
<tr
style="cursor:hand"
key="%#week.id#%"
for="week _in_ weeks"
domData="week"
>
<td
key="%#v.id#%"
onclick="clickDay(this)"
style="%#v.style#%"
lable="%#v.lable#%"
onMouseover="mouseOver(this)"
onMouseOut="mouseOut(this)"
childDomData="v"
for="v _in_ week"
>
<p
key="{%#v.id#%+'_content'}"
style="margin-block-start: 0em;margin-block-end: 0em"
>
"%#v.content#%"
</p>
<p
key="{%#v.id#%+'_lunarInfo'}"
style="margin-block-start: 0em;margin-block-end: 0em"
time="{new Date()}"
>
"%#v.lunarInfo#%"
</p>
</td>
</tr>
</tbody>
- rv.watch(data,callback)观察 data 属性对象变化,变化后触发 callback
- el 挂载对象节点选择器
- data 数据对象,虚拟 dom 中使用%##%访问 data 中数据
- rv.methods({}) ,为 rv 对象添加函数,函数中 this 指向此 rv 对象,可以访问此 rv 对象数据,调用此 rv 对象函数
- rv.run(callback) ,启动 rv,callback 为运行执行的函数
二. 声明组件以及使用组件:
- 参数说明:
RV.component用于声明组件的方法,
组件对象传参name 为RV组件名字
组件对象传参template 为RV组件html声明模板
组件对象传参style 为RV组件声明css样式
组件对象传参props 为RV组件属性,目的为暴漏给父控件用于设置组件相应参数
组件对象传参data 为RV组件data
组件对象传参methods,为RV组件method对象,在对象中创建方法以及回调。其中方法中的this指向此组件
组件对象传参run 为RV组件方法,用于运行组件相关js代码
组件对象传参domChange为RV组件方法,dom变化时触发此代码,用于运行dom相关代码
组件对象传参watch为RV组件对象,用于观察组件data数据变化
组件对象函数内调用this.$sendEvent({name,value}) 发送事件到其他组件 ,name为事件名称,value为事件值。可以将此组件状态或属性值发送到其他组件。其他组件通过在组件methods中声明(组件名+事件名+'event')函数监听次事件(比如RvSelectIDEvent(newId),其中RvSelect为组件名,ID为事件名,newId为事件的新值)。
1.声明组件: 通过 RV.component 声明组件 任何组件都可以通过 use()方法注册已经声明好的的 rv 组件
var con = RV.component({ //定义自定义RV组件
name: "MyComponent",//定义RV组件名字
template: `
<div class="aaa" key="aaa"><p key="bbb" style="color:%#pcolor#%" time="%#time#%" componentValue="%#pvalue#%">"%#pcontent#%"</p><div>
`,//定义RV组件,HTML语法声明组件模板
style: `
.aaa {
background-color: red
}
.bbb {
width: 500px;
height:200px;
}
`,//定义RV组件样式表,css语法声明组件样式
props: {//定义RV组件属性,用于外部设值组件属性
time: "1000",
content: "a custom component",
value: "componentValue"
},
data: {//定义RV组件data,data数据变化,自动更新模板内容
pcontent: "a custom component",
pcolor: "yellow",
time: 10000,
pvalue: "cvalue"
},
methods:{
test1(){
//其中this指向此组件
this.methods.test2()
}
test2(){
}
}
run() {//定义自定义RV组件运行代码,用于运行RV组件相关JS代码,RV组件启动时启动此方法
let colors = ['red', 'green', 'blue', 'yellow', 'gray', 'white', 'black']
setInterval(() => {
this.data.pcontent = this.props.content
this.data.time = this.props.time
this.data.pvalue = this.props.value
this.data.pcolor = colors[getRandomInt(6)]
/*将此组件的color值变化发送到其他组件
其他组件在method中声明组件名+事件值+'event'方法接收此变化
methods{
MyComponentColorEvent(value){
//此方法在组件调用this.$sendEvent({name:"Color",value:this.data.pcolor})时触发
}
}
*/
this.$sendEvent({name:"Color",value:this.data.pcolor})
}, 1000)
function getRandomInt(max) {
return Math.floor(Math.random() * Math.floor(max));
}
},
domChange(){
//dom 变化时触发,用于运行dom相关代码
}
watch: {
pcolor() {
console.log(`pcolorChange,change:`)
}
}
})
- 使用组件: 通过 rv.use 注册自定义组件到当前 RV 对象中,在 RV template 中使用注册过的组件名字声明组件。 组件可以使用 use 方法注册其他 rv 组件到当前组件中。
rv = new RV({
//创建对象
el: "#app",
//el对象挂载的节点s
data: myData,
template: `<div key="1" style="color:%#pcolor#%,width:100px,height:100px" onclick="clickDiv()">
"%#parent#%"
<p key="2" style="color:%#c1color#%,width:50px,height:50px" onclick="clickP1()">
"%#child#%"
</p>
<p key="3" style="color:%#c2color#%,width:50px,height:50px" onclick="clickP2()">
"%#child2#%"
</p>
<div key="4">
<p key="{%#v.id#%+'_content'}" childDomData="v" for="v _in_ week" domData="week">"%#v.content#%"</p>
</div>
<MyComponent content="%#componentCotent#%" time="{Math.floor(new Date()/1000)+'_ttt'}" value="%#componentValue#%" key="888"></MyComponent>
</div>`,
// MyComponent为自定义RV组件名字,定义组件时name值.content,value,time为定义组件时属性,定义组件时props值
});
rv.methods({
MyComponentColorEvent(color){
//组件MyComponent调用this.$sendEvent({name:"Color",value:this.data.pcolor}) 会触发此函数,color为新值
//this指向本组件,通过this可以访问本组件
this.methods.fun1()
}
fun1(){
},
})
rv.use(con); //调用rv对象的use方法注册自定义组件
DEMO
1.6.8
4 years ago
1.6.7
4 years ago
1.6.6
4 years ago
1.6.5
4 years ago
1.3.8
4 years ago
1.3.7
4 years ago
1.3.6
4 years ago
1.3.5
4 years ago
1.3.4
4 years ago
1.3.3
4 years ago
1.3.2
4 years ago
1.3.0
4 years ago
1.2.8
4 years ago
1.2.7
4 years ago
1.2.5
4 years ago
1.2.4
4 years ago
1.2.3
4 years ago
1.2.2
4 years ago
1.2.1
4 years ago
1.2.0
4 years ago
1.1.9
5 years ago
1.1.8
5 years ago
1.1.6
5 years ago
1.1.5
5 years ago
1.1.4
5 years ago
1.1.3
5 years ago
1.1.2
5 years ago
1.1.1
5 years ago
1.0.9
5 years ago
1.0.7
5 years ago
1.0.6
5 years ago
1.0.5
5 years ago
1.0.4
5 years ago
1.0.3
5 years ago
1.0.2
5 years ago
1.0.1
5 years ago
1.0.0
5 years ago