循序渐进(10)- 初探krpano xml静态代码

更新 2020.9.15 krpano 1.20.8

什么是krpano xml静态代码?

krpano xml静态代码其实就是krpano元素。我们在学习krpano里的时候经常要面对krpano的xml文件,krpano的xml文件里的静态代码相当于一个个具有功能说明的积木。虽然krpano的代码在文本中是一个个元素,且是有顺序地布局着,但实际上除了相同元素的载入的先后次序,不同元素之间的先后关系并不重要(除了krpano根元素)。

 

基本XML结构

  • xml文件由若干xml元素组成,也叫做xml节点或xml标签。krpano自身一共有若干个系统定义的元素(krpano 1.19 pr4官网不再描述textstyle和progress两个元素),如krpano、include、view、image、layer、events、scene等等。
  • xml元素的名字由一对单括号<>包围。
  • 每个xml元素都需要闭合。
    有两种形式 – 一个是在开始与结束时包含元素的名字。注意斜杠的位置
    一个是如下简单的闭合,注意斜杠的位置
  • 一个xml元素可以包含附加的xml子元素。当然,这些子元素也可以包含自己的子元素,这样的话会出现多层嵌套。
    在这种情况下,xml元素必须写成以下形式:
  • 一个xml元素可以拥有一个或多个属性。每个属性由一个属性名与属性值组成。属性值必须写在单引号或双引号里。如果是系统定义元素中的系统定义属性,则需要按照规定的数值类型填写属性值。例如布尔值必须写“true”或者“false”。
    注意 – 元素的属性重复撰写是不允许的,会引起语法错误
  • 在xml文件里必须要有一个根元素。它的级别高于其它元素。所有其它的xml元素必须包含在其中。
    对于krpano浏览内核而言,这个元素就是<krpano> 元素,例如:
  • 注释 – 注释是xml的一部分,在读取或解析xml文件时会被忽略。xml的注释始于:
    结束于:
    在注释中不允许包含字符串‘–’。也就是说注释符号是成对出现的。

    例子:

 

什么是系统内置与自定义的元素和属性?

对于新手而言,需要使用Sublime Test 3进行编写,软件会提示哪些是系统定义的属性。系统定义的属性在krpano官网有详细的说明。krpano允许添加自定义的元素、允许在系统定义的元素中添加自定义属性。例如下面的代码

这是根元素krpano元素,version和onstart都是系统内置属性,而title则是自定义属性。对于新手而言,如果不是非常熟悉官方文档,是很难区分哪些系统定义属性哪些是自定义属性。建议多参看本站文章:krpano元素官方文档krpano元素完全解析 所有元素均有中文官网文档

因此,我们可以在系统内置元素中添加自定义属性,好处就是方便我们进行其它操作。例如上面的title属性,实际上只是为了在官方皮肤导航缩略图的左上角显示一段文字。同时,我们也可以完全自定义一个元素出来。例如下面:

这个元素skin_settings 是自定义元素。在krpano官网文档中是不存在的,krpano在载入xml文件解析静态代码时会忽略掉自定义元素。自定义的元素和属性除了语法上不能违反krpano的规定,在属性值设置上更为自由。

请继续阅读: 循序渐进(11)- 1.19版本的默认xml解析

在 “循序渐进(10)- 初探krpano xml静态代码” 上有 1 条评论

发表评论