Таблица описания компонентов WeChat Mini Programs

基础组件

Фреймворк предоставляет разработчикам набор базовых компонентов, с помощью которых разработчики могут быстро создавать приложения, комбинируя эти компоненты.

Что такое компонент:

<tagname property="value">
  Content goes here ...
</tagename>

属性类型

Тип Описание Комментарий
Boolean Булево значение Если компонент имеет этот атрибут, независимо от того, чему он равен, его значение будет `true`. Только если атрибут отсутствует в компоненте, его значение будет `false`. Если значение атрибута является переменной, её значение будет преобразовано в тип `Boolean`.
Number Цифры 1, 2.5
String строка “string”
Array Массив [ 1, “string” ]
Object Объект { key: value }
EventHandler Имя обработчика событий “handlerName” — это имя функции-обработчика событий, определенное в Page.
Any произвольное свойство
共同属性类型
атрибут Тип Описание Комментарий
id String Уникальный идентификатор компонента Сохранить всю страницу уникальной
class String Класс стиля компонента Определенные стилевые классы в соответствующем WXSS
style String Встроенные стили компонента Динамически настраиваемые встроенные стили
hidden String Отображается ли компонент Все компоненты отображаются по умолчанию.
data-* Any Пользовательские атрибуты При срабатывании события на компоненте оно отправляется обработчику событий.
bind* / catch* EventHandler События компонента

基本组件列表

Базовые компоненты делятся на следующие категории:

Контейнер представлений (View Container) Основное содержание (Basic Content) Форма (Form) Навигация Мультимедиа (Media) Карта (Map) Холст (Canvas)

视图容器(View Container):

Название компонента Комментарии Свойства компонента
Имя атрибута Тип Значение по умолчанию 说明 - Объяснение Минимальная версия
view Контейнер представлений hover-class String none 指定按下去的样式类。当 hover-class="none" 时,没有点击态效果
hover-stop-propagation Boolean false Укажите, следует ли блокировать состояние нажатия у предков этого узла. 1.5.0
hover-start-time Number 50 Через сколько миллисекунд появляется состояние нажатия при удержании?
hover-stay-time Number 400 Время удержания нажатия после отпускания пальца, в миллисекундах
scroll-view Контейнер с прокруткой scroll-x Boolean false Разрешить горизонтальную прокрутку
scroll-y Boolean false Разрешить вертикальную прокрутку
upper-threshold Number 50 На каком расстоянии от верха/левого края (в пикселях) срабатывает событие scrolltoupper
lower-threshold Number 50 На каком расстоянии от низа/правой стороны (в пикселях) срабатывает событие scrolltolower
scroll-top Number Установка позиции вертикальной полосы прокрутки
scroll-left Number Установить положение горизонтальной полосы прокрутки
scroll-into-view String Значение должно быть идентификатором дочернего элемента (идентификатор не может начинаться с цифры). Установите, в каком направлении можно прокручивать, и элемент будет прокручиваться в этом направлении.
scroll-with-animation Boolean false При использовании анимации для установки позиции полосы прокрутки
enable-back-to-top Boolean false При нажатии на верхнюю строку состояния на iOS или двойном нажатии на строку заголовка на Android, полоса прокрутки возвращается в начало, поддерживается только вертикальная прокрутка.
bindscrolltoupper EventHandle Прокрутка вверх/влево вызовет событие scrolltoupper.
bindscrolltolower EventHandle Прокрутка до нижней/правой части вызовет событие scrolltolower.
bindscroll EventHandle Срабатывает при прокрутке, event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY}
swiper Контейнер слайдера indicator-dots Boolean false Показывать индикаторы на панели
indicator-color Color rgba(0, 0, 0, .3) Цвет указателя 1.1.0
indicator-active-color Color #000000 Цвет выбранной точки индикации 1.1.0
autoplay Boolean false Автоматический переход
current Number 0 Индекс текущей страницы
interval Number 5000 Автоматическое переключение интервала времени
duration Number 500 Длительность анимации скольжения
circular Boolean false Использовать ли скользящее соединение
vertical Boolean false Является ли направление прокрутки вертикальным?
bindchange EventHandle При изменении `current` будет вызвано событие `change`, где `event.detail = {current: current, source: source}`.

基础内容(Basic Content):

Название компонента Комментарии Свойства компонента
Имя атрибута Тип Значение по умолчанию 说明 - Объяснение Минимальная версия
icon 图标 type String icon的类型,有效值:success, success_no_circle, info, warn, waiting, cancel, download, search, clear
size Number 23 Размер иконки, единица измерения - пиксели (px)
color Color цвет иконки, такой же как цвет в CSS
text Текст selectable Boolean false Текст можно выбрать? 1.1.0
space String false 显示连续空格
有效值 ensp:中文字符空格一半大小 emsp:中文字符空格大小 nbsp:根据字体设置的空格大小
1.4.0
decode Boolean false Расшифровать 1.4.0
progress Полоса прогресса percent Float нет Проценты от 0 до 100
show-info Boolean false Отображать проценты справа от индикатора выполнения
stroke-width Number 6 Ширина линии индикатора выполнения, в пикселях
color Color #09BB07 Цвет индикатора выполнения (используйте activeColor)
activeColor Color Выбранный цвет полосы прогресса
backgroundColor Color Цвет невыбранной полосы прогресса
active Boolean false Анимация индикатора выполнения слева направо
active-mode String backwards назад: анимация воспроизводится с начала; вперед: анимация воспроизводится с места остановки в прошлый раз 1.7.0

表单(Form):

Название компонента Комментарии Свойства компонента
Имя атрибута Тип Значение по умолчанию 说明 - Объяснение Время вступления в силу Минимальная версия
button Кнопка size String default Размер кнопки
type String default Стиль типа кнопки
plain Boolean false Кнопка ли вырезана, цвет фона прозрачный
disabled Boolean false Выключить ли
loading Boolean false Перед именем есть значок загрузки?
form-type String 用于 <form/> 组件,点击分别会触发 <form/> 组件的 submit/reset 事件
open-type String Возможности открытости WeChat 1.1.0
hover-class String button-hover 指定按钮按下去的样式类。当 hover-class="none" 时,没有点击态效果
hover-stop-propagation Boolean false Укажите, следует ли блокировать состояние нажатия у предков этого узла. 1.5.0
hover-start-time Number 20 Через сколько миллисекунд появляется состояние нажатия при удержании?
hover-stay-time Number 70 Время удержания нажатия после отпускания пальца, в миллисекундах
bindgetuserinfo Handler Когда пользователь нажимает на эту кнопку, возвращается полученная информация о пользователе, значение, полученное из параметра detail, совпадает с wx.getUserInfo. open-type="getUserInfo' 1.3.0
lang String en Укажите язык возвращаемых пользовательских данных: zh_CN — упрощенный китайский, zh_TW — традиционный китайский, en — английский. open-type="getUserInfo" 1.3.0
session-from String Источник разговора open-type="contact" 1.4.0
send-message-title String Текущий заголовок Заголовок карточки сообщения в чате open-type="contact" 1.5.0
send-message-path String Текущий путь для обмена Путь перехода к мини-приложению при нажатии на карточку сообщения в чате open-type="contact" 1.5.0
send-message-img String Скриншот Карточка изображения в чате open-type="contact" 1.5.0
show-message-card Boolean false Отображать карточки сообщений в рамках диалога open-type="contact" 1.5.0
bindcontact Handler Обратный вызов сообщений службы поддержки open-type="contact" 1.5.0
bindgetphonenumber Handler Получение номера телефона пользователя (callback) open-type="getphonenumber" 1.2.0
form Форма report-submit Boolean Возвращать ли formId для отправки шаблонных сообщений
bindsubmit EventHandle Запуск события отправки с данными из формы, event.detail = {value : {'name': 'value'} , formId: ''}
bindreset EventHandle При сбросе формы срабатывает событие reset.
input Поле ввода value String Начальное содержимомокна ввода
type String "text" Тип input
password Boolean false Является ли это паролем
placeholder String Заполнитель при пустом поле ввода
placeholder-style String Стилизация placeholder
placeholder-class String "input-placeholder" Укажите класс стиля для placeholder
disabled Boolean false Выключить ли
maxlength Number 140 Максимальная длина ввода, при установке значения -1 максимальная длина не ограничена.
cursor-spacing Number 0 Задайте расстояние между курсором и клавиатурой в пикселях. В качестве расстояния между курсором и клавиатурой используется минимальное значение между расстоянием от нижней границы input и заданным значением cursor-spacing.
auto-focus Boolean false (Устарело, используйте focus напрямую) Автофокус, вызов клавиатуры
focus Boolean false Получить фокус
confirm-type String "done" Установить текст кнопки в правом нижнем углу клавиатуры 1.1.0
confirm-hold Boolean false При нажатии на кнопку в правом нижнем углу клавиатуры, останется ли клавиатура открытой? 1.1.0
cursor Number Позиция курсора при указании фокуса 1.5.0
bindinput EventHandle При вводе с клавиатуры срабатывает событие `input`, `event.detail = {value, cursor}`. Обработчик может напрямую вернуть строку, которая заменит содержимое поля ввода.
bindfocus EventHandle При фокусировке на поле ввода срабатывает событие, event.detail = {value: value}
bindblur EventHandle Срабатывает при потере фокуса в поле ввода, event.detail = {value: value}
bindconfirm EventHandle Срабатывает при нажатии кнопки «Завершить», event.detail = {value: value}
checkbox Многопозиционный переключатель value String <checkbox/>标识,选中时触发<checkbox-group/>的 change 事件,并携带 <checkbox/> 的 value
disabled Boolean false Выключить ли
checked Boolean false Выбрано ли в данный момент, можно использовать для установки по умолчанию
color Color Цвет флажка, такой же как цвет в CSS
radio Одиночный селектор value String <radio/> 标识。当该<radio/> 选中时,<radio-group/> 的 change 事件会携带<radio/>的value
disabled Boolean false Выключить ли
checked Boolean false Выбрано ли в данный момент, можно использовать для установки по умолчанию
color Color цвет радио, такой же как цвет в CSS
picker
(mode = selector)
(Обычный) селектор списка range Array / Object Array [] При mode равном selector или multiSelector, range действителен.
range-key String Когда `range` является массивом объектов, используйте `range-key`, чтобы указать значение ключа в объекте в качестве содержимого для отображения в селекторе.
value Number 0 Значение value указывает на то, какой элемент из диапазона range был выбран (индексация начинается с 0).
bindchange EventHandle При изменении значения `value` срабатывает событие `change`, где `event.detail = {value: value}`.
disabled Boolean false Выключить ли
picker
(mode = multiSelector)
(Многоколоночный) селектор списка range Двумерный массив / Двумерный массив объектов [] mode为 selector 或 multiSelector 时,range 有效。二维数组,长度表示多少列,数组的每项表示每列的数据,如[["a","b"], ["c","d"]]
range-key String Когда `range` является двумерным массивом объектов, используйте `range-key`, чтобы указать значение ключа в объекте в качестве содержимого для отображения в селекторе.
value Array 0 Значение каждого элемента указывает на выбор элемента с соответствующим индексом в диапазоне (индексация начинается с 0).
bindchange EventHandle При изменении значения `value` срабатывает событие `change`, где `event.detail = {value: value}`.
bindcolumnchange EventHandle При изменении значения в определенном столбце срабатывает событие `columnchange`, где `event.detail = {column: column, value: value}`. Значение `column` указывает на номер столбца, который был изменен (индексация начинается с 0), а значение `value` указывает на индекс измененного значения.
disabled Boolean false Выключить ли
picker
(mode = time)
(Время) Выборщик списка value String 表示选中的时间,格式为"hh:mm"
start String 表示有效时间范围的开始,字符串格式为"hh:mm"
end String 表示有效时间范围的结束,字符串格式为"hh:mm"
bindchange EventHandle При изменении значения `value` срабатывает событие `change`, где `event.detail = {value: value}`.
disabled Boolean false Выключить ли
picker
(mode = date)
(дата) выборщик списка value String 0 表示选中的日期,格式为"YYYY-MM-DD"
start String 表示有效日期范围的开始,字符串格式为"YYYY-MM-DD"
end String 表示有效日期范围的结束,字符串格式为"YYYY-MM-DD"
fields String day Значения year, month, day обозначают уровень детализации селектора.
bindchange EventHandle При изменении значения `value` срабатывает событие `change`, где `event.detail = {value: value}`.
disabled Boolean false Выключить ли
picker
(mode = region)
(дата) выборщик списка value Array [] Указывает выбранные провинцию, город и район, по умолчанию выбирается первое значение в каждом столбце.
custom-item String Можно добавить пользовательский элемент в верхнюю часть каждого столбца. 1.5.0
bindchange EventHandle При изменении значения `value` срабатывает событие `change`, где `event.detail = {value: value}`.
disabled Boolean false Выключить ли
picker-view Встроенный селектор списка value NumberArray Числа в массиве последовательно указывают на выбранный элемент в каждом picker-view-colume внутри picker-view (индексация начинается с 0). Если число превышает длину доступных вариантов в picker-view-column, выбирается последний элемент.
indicator-style String Установка стиля среднего выделенного поля в селекторе
indicator-class String Установка класса для среднего выбранного элемента селектора 1.1.0
mask-style String Установка стиля для наложения 1.5.0
mask-class String Установка класса для наложения 1.5.0
bindchange EventHandle При смене выбранного значения при прокрутке, срабатывает событие change, event.detail = {value: value}; value — это массив, указывающий, какой элемент выбран в текущем picker-view-column (индексация начинается с 0).
slider Скроллер min Number 0 Минимум
max Number 100 Максимум
step Number 0 Шаг должен быть больше 0 и делиться нацело на (max - min).
disabled Boolean false Выключить ли
value Number 0 Текущее значение
color Color #e9e9e9 Цвет фона (используйте backgroundColor)
selected-color Color #1aad19 Выбранный цвет (используйте activeColor)
activeColor Color #1aad19 Выбранный цвет
backgroundColor Color #e9e9e9 Цвет фона
show-value Boolean false Показывать текущее значение
bindchange EventHandle Событие, срабатывающее после завершения перетаскивания, event.detail = {value: value}
bindchanging EventHandle Событие, вызванное во время перетаскивания, event.detail = {value: value} 1.7.0
switch Переключатель выбора checked Boolean false Выбрано ли
type String switch Стиль, допустимые значения: switch, checkbox
bindchange EventHandle При изменении значения `checked` срабатывает событие `change`, где `event.detail = { value: checked }`.
color Color цвет switch, такой же как цвет в CSS
label Метка for String Привязка идентификатора элемента управления

导航(Navigation):

Название компонента Комментарии Свойства компонента
Имя атрибута Тип Значение по умолчанию 说明 - Объяснение Минимальная версия
navigator Ссылка на приложение url String Ссылки для перехода внутри приложения
open-type String navigate Способ перехода
delta Number Действительно, когда open-type имеет значение 'navigateBack', указывает количество уровней для возврата назад.
hover-class String navigator-hover 指定点击时的样式类,当hover-class="none"时,没有点击态效果
hover-stop-propagation Boolean false Укажите, следует ли блокировать состояние нажатия у предков этого узла. 1.5.0
hover-start-time Number 50 Через сколько миллисекунд появляется состояние нажатия при удержании?
hover-stay-time Number 600 Время удержания нажатия после отпускания пальца, в миллисекундах
其中open-type 的有效值如下:
Значение 说明 - Объяснение Минимальная версия
navigate Функция, соответствующая wx.navigateTo
redirect Функция, соответствующая wx.redirectTo
switchTab Функция, соответствующая wx.switchTab
reLaunch Функция, соответствующая wx.reLaunch 1.1.0
navigateBack Функция, соответствующая wx.navigateBack 1.1.0

多媒体(Media):

Название компонента Комментарии Свойства компонента
Имя атрибута Тип Значение по умолчанию 说明 - Объяснение Минимальная версия
audio Аудио id String уникальный идентификатор компонента audio
src String Адрес ресурса для воспроизведения аудио
loop Boolean false Повторять ли?
controls Boolean false Показывать ли стандартные элементы управления
poster String Адрес изображения обложки аудио на стандартном элементе управления. Если значение атрибута `controls` равно `false`, установка `poster` не будет иметь эффекта.
name String Неизвестный аудиофайл Имя аудио на стандартном элементе управления, если значение атрибута controls равно false, то установка name не будет иметь эффекта.
author String Неизвестный автор Имя автора по умолчанию на элементе управления, если значение свойства controls равно false, то установка author недействительна.
binderror EventHandle При возникновении ошибки срабатывает событие `error`, `detail` = {errMsg: MediaError.code}
bindplay EventHandle Срабатывание события play при начале/продолжении воспроизведения
bindpause EventHandle При приостановке воспроизведения срабатывает событие pause.
bindtimeupdate EventHandle При изменении прогресса воспроизведения срабатывает событие `timeupdate`, `detail = {currentTime, duration}`
bindended EventHandle Срабатывает событие ended при достижении конца воспроизведения.
image Изображение src String Адрес ресурса изображения
mode String 'scaleToFill' Режимы обрезки и масштабирования изображений
lazy-load Boolean false Ленивая загрузка изображений. Действует только для изображений внутри page и scroll-view. 1.5.0
binderror HandleEvent Когда происходит ошибка, имя события, публикуемого в AppService, объект события event.detail = {errMsg: 'что-то пошло не так'}
bindload HandleEvent Когда изображение загружено, имя события, публикуемого в AppService, объект события event.detail = {height: 'высота изображения в px', width: 'ширина изображения в px'}
video Видео src String Адрес ресурса для воспроизведения видео
initial-time Number Указать начальную позицию воспроизведения видео 1.6.0
duration Number Укажите продолжительность видео 1.1.0
controls Boolean true Показывать ли элементы управления воспроизведением по умолчанию (кнопки воспроизведения/паузы, прогресс воспроизведения, время)?
danmu-list Object Array Список комментариев
danmu-btn Boolean false Показывать ли кнопку для отображения комментариев, действует только при инициализации, не может быть изменена динамически.
enable-danmu Boolean false Показывать ли субтитры действителен только при инициализации и не может быть изменен динамически.
autoplay Boolean false Автоматический запуск
loop Boolean false Повторять ли? 1.4.0
muted Boolean false Включить беззвучный режим воспроизведения? 1.4.0
page-gesture Boolean false В неполноэкранном режиме, включены ли жесты для регулировки яркости и громкости 1.6.0
direction Number Настройка ориентации видео при полноэкранном режиме; если не указано, определяется автоматически по соотношению сторон. Допустимые значения: 0 (обычная вертикальная), 90 (экран повернут на 90 градусов против часовой стрелки), -90 (экран повернут на 90 градусов по часовой стрелке). 1.7.0
bindplay EventHandle Срабатывание события play при начале/продолжении воспроизведения
bindpause EventHandle При приостановке воспроизведения срабатывает событие pause.
bindended EventHandle Срабатывает событие ended при достижении конца воспроизведения.
bindtimeupdate EventHandle Запускается при изменении прогресса воспроизведения, event.detail = {currentTime, duration}. Частота срабатывания — 250 мс.
bindfullscreenchange EventHandle Когда видео переходит в полноэкранный режим или выходит из него, срабатывает событие, где `event.detail = {fullScreen, direction}`, а `direction` принимает значения `vertical` или `horizontal`. 1.4.0
objectFit String contain Когда размер видео не совпадает с размером контейнера video, поведение видео: contain (включать), fill (заполнять), cover (покрывать).
poster String URL-адрес изображения для обложки видео, если значение атрибута controls равно false, то установка poster не будет иметь эффекта.

地图(Map):

Название компонента Комментарии Свойства компонента
Имя атрибута Тип Значение по умолчанию 说明 - Объяснение Минимальная версия
map Карта longitude Number Центральный меридиан
latitude Number Центральная широта
scale Number 16 Уровень масштабирования, диапазон значений от 5 до 18
markers Array Метка
covers Array Будет удалено, используйте markers
polyline Array Маршрут
circles Array Круг
controls Array Элемент управления
include-points Array Увеличьте масштаб, чтобы охватить все заданные координаты.
show-location Boolean Отображение текущей точки с указанием направления
bindmarkertap EventHandle При нажатии на маркер срабатывает
bindcallouttap EventHandle При нажатии на пузырек, соответствующий отмеченной точке, срабатывает. 1.2.0
bindcontroltap EventHandle Срабатывание при нажатии на элемент управления
bindregionchange EventHandle Срабатывание при изменении поля зрения
bindtap EventHandle Срабатывание при нажатии на карту
bindupdated EventHandle Срабатывает при завершении обновления рендеринга карты. 1.6.0

画布(Canvas):

Название компонента Комментарии Свойства компонента
Имя атрибута Тип Значение по умолчанию 说明 - Объяснение Минимальная версия
canvas холст src String Адрес ресурса для воспроизведения видео
initial-time Number Указать начальную позицию воспроизведения видео 1.6.0
duration Number Укажите продолжительность видео 1.1.0
controls Boolean true Показывать ли элементы управления воспроизведением по умолчанию (кнопки воспроизведения/паузы, прогресс воспроизведения, время)?
danmu-list Object Array Список комментариев
danmu-btn Boolean false Показывать ли кнопку для отображения комментариев, действует только при инициализации, не может быть изменена динамически.
enable-danmu Boolean false Показывать ли субтитры действителен только при инициализации и не может быть изменен динамически.
autoplay Boolean false Автоматический запуск
loop Boolean false Повторять ли? 1.4.0
muted Boolean false Включить беззвучный режим воспроизведения? 1.4.0
page-gesture Boolean false В неполноэкранном режиме, включены ли жесты для регулировки яркости и громкости 1.6.0
direction Number Настройка ориентации видео при полноэкранном режиме; если не указано, определяется автоматически по соотношению сторон. Допустимые значения: 0 (обычная вертикальная), 90 (экран повернут на 90 градусов против часовой стрелки), -90 (экран повернут на 90 градусов по часовой стрелке). 1.7.0
show-progress Boolean true Если не установлено, отображается только при ширине больше 240. 1.9.0
show-fullscreen-btn Boolean true Показывать ли кнопку полного экрана 1.9.0
show-play-btn Boolean true Показывать ли кнопку воспроизведения в нижней панели управления видео 1.9.0
show-center-play-btn Boolean true Показывать ли кнопку воспроизведения в середине видео 1.9.0
enable-progress-gesture Boolean true Включить жесты для управления прогрессом 1.9.0
bindplay EventHandle Срабатывание события play при начале/продолжении воспроизведения
bindpause EventHandle При приостановке воспроизведения срабатывает событие pause.
bindended EventHandle Срабатывает событие ended при достижении конца воспроизведения.
bindtimeupdate EventHandle Запускается при изменении прогресса воспроизведения, event.detail = {currentTime, duration}. Частота срабатывания — 250 мс.
bindfullscreenchange EventHandle Когда видео переходит в полноэкранный режим или выходит из него, срабатывает событие, где `event.detail = {fullScreen, direction}`, а `direction` принимает значения `vertical` или `horizontal`. 1.4.0
objectFit String contain Когда размер видео не совпадает с размером контейнера video, поведение видео: contain (включать), fill (заполнять), cover (покрывать).
poster String URL-адрес изображения для обложки видео, если значение атрибута controls равно false, то установка poster не будет иметь эффекта.

Вы недавно использовали:

收藏 - Коллекция Меню QQ