内置组件

uni-app 教程 · 第 4 章 · 7 次浏览

uni-app 的模板语法就是 Vue 语法:{{ }} 插值、v-for 列表、v-if 条件、:属性 绑定、@事件 监听。会 Vue 就会 uni-app。

常用语法

  • {{ item.name }}:插值
  • v-for="(item, index) in list" :key="item.id":列表
  • v-if / v-else:条件
  • :src="url":动态属性
  • @click="fn":点击事件

注意

标签用 view/text/image(跨端统一标签),小程序端不识别 div/span。

代码示例

<template>
  <view class="list">
    <view v-for="(item, index) in products" :key="item.id"
          class="item" @click="onTap(item)">
      <text>{{ index + 1 }}. {{ item.name }}</text>
      <text class="price">¥{{ item.price }}</text>
    </view>
    <view v-if="products.length === 0" class="empty">暂无商品</view>
  </view>
</template>

<script>
export default {
  data() {
    return {
      products: [
        { id: 1, name: "苹果", price: 5.5 },
        { id: 2, name: "香蕉", price: 3.2 }
      ]
    };
  },
  methods: {
    onTap(item) {
      uni.navigateTo({ url: `/pages/detail/detail?id=${item.id}` });
    }
  }
}
</script>
📚 HTML 标签速查
常用条目速查,完整版见对应教程章节。可复制代码到在线运行中测试。
写法 / 语法作用
&lt;h1&gt;-&lt;h6&gt;标题,h1 最高,每页只用一个 h1
&lt;p&gt;段落,自动加前后间距
&lt;a href=""&gt;链接,href 是目标地址
&lt;img src="" alt=""&gt;图片,src 地址,alt 替代文字
&lt;ul&gt; / &lt;li&gt;无序列表
&lt;ol&gt; / &lt;li&gt;有序列表,数字编号
&lt;dl&gt; / &lt;dt&gt; / &lt;dd&gt;自定义列表:术语 + 说明
&lt;table&gt; / &lt;tr&gt; / &lt;td&gt; / &lt;th&gt;表格:行 / 单元格 / 表头
&lt;form action="" method=""&gt;表单,action 提交地址,method 提交方式
&lt;input type=""&gt;输入控件,type 有 text/password/email/number 等
&lt;textarea&gt;多行文本输入
&lt;select&gt; / &lt;option&gt;下拉框及选项
&lt;button type="submit"&gt;按钮,submit 提交表单
&lt;strong&gt; / &lt;em&gt;加粗(重要)/ 斜体(强调)
&lt;div&gt; / &lt;span&gt;区块容器 / 行内容器
&lt;header&gt; &lt;nav&gt; &lt;main&gt;语义化:页眉 / 导航 / 主体
&lt;section&gt; &lt;article&gt; &lt;aside&gt;语义化:分节 / 独立内容 / 侧栏
&lt;footer&gt;页脚:版权、备案
&lt;video&gt; / &lt;audio&gt;HTML5 视频 / 音频,加 controls 显示控制条
&lt;iframe src=""&gt;嵌入其他网页
&lt;!-- 注释 --&gt;HTML 注释,不显示在页面
&lt;br&gt; / &lt;hr&gt;换行 / 水平分割线
&lt;pre&gt;保留空格和换行,原样显示
&lt;blockquote&gt; / &lt;q&gt;块级引用 / 行内引用
&lt;figure&gt; / &lt;figcaption&gt;图文组合及说明