引言
在HTML中,javascript占据了很重的部分,无论是前端和后端,javascript都为网页带来了大量的可操作性和交互性,使得网页内容不断丰富,不断契合人们的操作。
在Tin中,编写者可以使用<code>
标签来写入内嵌代码,将一定格式的脚本内联到Tin文件中。这类似于HTML的<script>
元素。该标签允许编写者使用特定脚本增强文件的操作性和交互性。
一般使用
<code>
标签允许四个参数。
<code>代码名称;代码种类[;参数]
代码
</code>
代码名称是在本TinText中,该代码段的标志。当名称重复时,则代表代码段覆盖或者是更新;当名称为“now”时,该代码段无需触发,即刻执行。
代码种类是在TinText中允许运行的脚本类型,包括:Python、tcl、vbs三种。其中,Python和tcl均有所限制,具体限制内容查看TinEngine的使用说明,或者下载TinReader获取说明文件。vbs文件通过生成临时文件,使用Windows系统的wscript进行运行。
代码参数是一串参数,这些参数使用“|”来分割。这是非必选的,这些参数在代码段中用“%参数%”的形式存在,当触发该代码段并给定代码段参数时,这些参数将被替换,否则,这个参数内容就是参数的默认值。该选项对一般使用者来讲没有用处,但如果你希望你的Tin文件能给读者留下深刻印象,这个功能也可以尝试使用。
代码触发
目前,可以使用即刻启动、<do>
标签和内部函数三种方法触发内联代码。
我们以下方的Python代码为例子:
self.insert('end','main')
即刻启动
在上文中讲到,当代码名称为“now”使,TinText会直接运行这一段代码,同时会阻塞渲染。
<code>now;python
self.insert('end','main')
</code>
do标签启动
<do>
标签是Tin中启动指定脚本的特定标签,一般使用一个参数:<do>code_name[;args]
。更多用法请查看Tin说明文件。
该方法为前置代码段
<code>test;python
self.insert('end','main')
</code>
;代码段需要提前载入
<do>test
内部函数启动
在TinText中,使用函数==self.get_codes_to_run(name,args:list=[])==触发指定代码段。
前置代码段
<code>test;python
self.insert('end','main')
</code>
<tkinter>
get_codes_to_run('test')
</tkinter>
后置代码段
<tkinter>
window_create(self.end,window=Button(self,text='code button',command=lambda:self.get_codes_to_run('test')))
</tkinter>
;在TinReader中,使用:
;<tkinter>
;window_create(self.end,window=Button(self,text='code button',command=lambda:MyText.get_codes_to_run('test')))
;</tkinter>
<code>test;python
self.insert('end','main')
</code>
后置代码段的效果:
这一段代码虽然很简单,但是足以展现<code>
应用于Tin中的重要性。
使用参数
对于普通使用者来说,以上的使用已经足够了,但是对于想玩点花样的编写者,没有参数设定可是少了很多乐趣。
接下来,我们仍然以上面的一段简单的Python代码作为例子,看看如何在<code>
中使用参数。
直接执行,忽略参数
在Tin中,代码可以拥有参数列表,但是当一段代码被触发时,可以不传递参数,或者说参数可以不全(不建议,要么传参,要么不传使用默认值)。当参数传递使,代码段中的“%参数%”字样将被代替为参数值,否则直接被替换成“参数”
那么以上的代码段需要进行改写:
<code>now;python;self.end|main
self.insert('end','TIN')
self.insert(%self.end%,' %main%')
</code>
此时,在TinText中显示的是:TIN main
。
导入参数
触发标签
如果使用<do>
标签进行触发,不传参使用方法如下:
<code>test;python;self.end|main
self.insert('end','TIN')
self.insert(%self.end%,' %main%')
</code>
<do>test
此时,在TinText中显示的是:TIN main
。
传参使用方法:
<code>test;python;self.end|main
self.insert('end','TIN')
self.insert(%self.end%,' %main%')
</code>
<do>test;1.1|code
此时,在TinText中显示的是:T codeIN
。
内部函数
使用内部函数,仍可以不传参:
<code>test;python;self.end|main
self.insert('end','TIN')
self.insert(%self.end%,' %main%')
</code>
<code>now;python
self.get_codes_to_run('test')
</code>
此时,在TinText中显示的是:TIN main
。
传递参数:
<code>test;python;self.end|main
self.insert('end','TIN')
self.insert(%self.end%,' %main%')
</code>
<code>now;python
self.get_codes_to_run('test',['1.1','code'])
</code>
此时,在TinText中显示的是:T codeIN
。
结语
这就是在Tin语言中使用内嵌代码段的基本方法,使用脚本控制可以让TinText的交互功能更加丰富。