框架指令

了解框架提供的指令与组件:for,if,show,block,slot

通过本节,你将学会:

  • 指令for
  • 指令if与指令show
  • 组件block
  • 组件slot

指令for

for指令用于循环输出一个数组类型的数据

示例如下:

<template>
  <div class="tutorial-page">
    <!-- 方式1:默认$item代表数组中的元素, $idx代表数组中的索引 -->
    <div class="tutorial-row" for="{{list}}">
      <text>{{$idx}}.{{$item.name}}</text>
    </div>
    <!-- 方式2:自定义元素变量名称 -->
    <div class="tutorial-row" for="value in list">
      <text>{{$idx}}.{{value.name}}</text>
    </div>
    <!-- 方式3:自定义元素、索引的变量名称 -->
    <div class="tutorial-row" for="(personIndex, personItem) in list">
      <text>{{personIndex}}.{{personItem.name}}</text>
    </div>
  </div>
</template>

<style lang="less">
  .tutorial-page {
    flex-direction: column;
    .tutorial-row {
      width: 85%;
      margin-top: 10px;
      margin-bottom: 10px;
    }
  }
</style>

<script>
  export default {
    private: {
      list: [
        {name: 'aa'},
        { name: 'bb' }
      ]
    },
    onInit () {
      this.$page.setTitleBar({ text: '指令for' })
    }
  }
</script>

在渲染页面时, div.tutorial-row的结构,会根据script中的数据list的定义,被循环的生成多个

注意:

  • 自定义变量表示for指令的数组索引和数组元素时,变量名不可以用$_开头;

指令if与指令show

if条件指令,是指if/elif/else这3个相关指令,用于控制是否增加或者删除组件;

show指令,是指是否显示组件,用于控制组件的显示状态,并不会从DOM结构中删除

示例如下:

<template>
  <div class="tutorial-page">
    <text onclick="onClickShow">显示隐藏:</text>
    <text show="{{showVar}}">show: 渲染但控制是否显示</text>

    <text onclick="onClickCondition">条件指令:</text>
    <text if="{{conditionVar === 1}}">if: if条件</text>
    <text elif="{{conditionVar === 2}}">elif: elif条件</text>
    <text else>else: 其余</text>
  </div>
</template>

<style lang="less">
  .tutorial-page {
    flex-direction: column;
  }
</style>

<script>
  export default {
    private: {
      showVar: true,
      conditionVar: 1
    },
    onInit () {
      this.$page.setTitleBar({ text: '指令if与指令show' })
    },
    onClickShow () {
      this.showVar = !this.showVar
    },
    onClickCondition () {
      this.conditionVar = ++this.conditionVar % 3
    }
  }
</script>

当if/elif指令的值为false时,节点会从页面中移除,当if/elif指令值为true,组件会动态插入节点中;

当show指令的值为true时,节点可见, 当其值为false时,组件不可见,但节点仍会保留在页面DOM结构中

注意:

  • if/elif/else节点必须是相邻的兄弟节点

组件block

block组件是表达逻辑区块的组件,没有对应的Native组件。可以使用<block>实现更为灵活的"列表/条件渲染"。如在<block>上使用for指令和if指令

示例如下:

<template>
  <div class="tutorial-page">
    <text onclick="toggleCityList">点击:控制是否显示城市</text>
    <div class="city" for="city in cities" if="{{showCityList === 1}}">
      <text>城市:{{city.name}}</text>
      <block if="{{city.showSpots}}" for="{{city.spots}}">
        <text>景点:{{$item.name}}</text>
      </block>
    </div>
  </div>
</template>

<style lang="less">
  .tutorial-page {
    flex-direction: column;
  }
  .city {
    flex-direction: column;
  }
</style>

<script>
  import {dataDirective} from '../../Common/js/data'

  export default {
    private: {
      showCityList: 1,
      cities: dataDirective
    },
    onInit () {
      this.$page.setTitleBar({ text: '组件block' })
    },
    toggleCityList () {
      this.showCityList = this.showCityList === 1 ? 0 : 1
    }
  }
</script>

这个示例有点复杂,综合了前述的知识点。对示例中的变量解释如下:

  • showCityList用于控制是否在页面中生成列表元素即城市的列表
  • cityList数组代表需要列表渲染的城市列表数据
  • cityList数组的每个元素中的showSpots,决定了是否显示当前city的spots数据

读者可以看到,通过这些组合,可以表达复杂的业务逻辑

组件slot

slot节点用于向开发者额外开发的自定义ux组件中插入内容;

通常自定义组件的模板中提供slot组件,当该组件被引入到页面组件中后,开发者可以灵活定义该自定义组件内部的子内容。

示例如下:

自定义组件part1.ux

<!-- par1.ux -->
<template>
  <div>
    <text>{{ header }}</text>
    <slot></slot>
    <text>{{ footer }}</text>
  </div>
</template>

<script>
  export default {
    props: [
      'header', 'footer'
    ]
  }
</script>

自定义组件使用者页面index.ux

<!-- index.ux -->
<import src="./part1"></import>
<template>
  <part1 class="component" header="{{header}}" footer="{{footer}}">
    <text>slot节点内容</text>
  </part1>
</template>

<style>
  .component {
    flex-direction: column;
  }
</style>

<script>
  export default {
    private: {
      header: 'HEAD',
      footer: 'FOOT'
    },
    onInit () {
      this.$page.setTitleBar({ text: '组件slot' })
    }
  }
</script>

在子组件中使用slot组件,使得子组件接纳调用者传入的子内容,从而动态渲染子组件,得到最终的页面

总结

指令for、if、show与组件block是很常用的,掌握使用方法很有必要!

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容