m8-framework-mcp 1.0.0 → 1.0.1

package/docs/m8mpdoc-develop/017-/345/206/205/347/275/256/347/273/204/344/273/266/018-map.md

@@ -1,278 +0,0 @@
-#### map
-
-地图组件。
-
-地图组件用于展示地图，而定位 API 只是获取坐标，请勿混淆两者。
-
-**平台差异说明**
-
-| H5  | 微信小程序 | 支付宝小程序 |
-| :-: | :--------: | :----------: |
-|  √  |     √      |      √       |
-
-**地图服务商说明**
-
-| 地图服务商 |   H5    | 微信小程序 |
-| :--------: | :-----: | :--------: |
-|   Goolge   | 3.2.10+ |            |
-|    腾讯    |    √    |     √      |
-
-**属性说明**
-
-| 属性名             | 类型              | 默认值 | 说明                                                          | 平台差异说明                                              |
-| :----------------- | :---------------- | :----- | :------------------------------------------------------------ | :-------------------------------------------------------- |
-| longitude          | Number            |        | 中心经度                                                      |                                                           |
-| latitude           | Number            |        | 中心纬度                                                      |                                                           |
-| scale              | Number            | 16     | 缩放级别，取值范围为 3-20                                     | 高德地图缩放比例与微信小程序不同                          |
-| min-scale          | Number            | 3      | 最小缩放级别                                                  | 微信小程序 2.13+支持                                      |
-| max-scale          | Number            | 20     | 最大缩放级别                                                  | 微信小程序 2.13+支持                                      |
-| layer-style        | Number/String     | 1      | 个性化地图                                                    | 微信小程序 2.13+支持                                      |
-| markers            | Array             |        | 标记点                                                        |                                                           |
-| polyline           | Array             |        | 路线                                                          |                                                           |
-| circles            | Array             |        | 圆                                                            |                                                           |
-| controls           | Array             |        | 控件                                                          |                                                           |
-| include-points     | Array             |        | 缩放视野以包含所有给定的坐标点                                |                                                           |
-| enable-3D          | Boolean           | false  | 是否显示 3D 楼块                                              | 微信小程序 2.3.0 支持                                     |
-| show-compass       | Boolean           | false  | 是否显示指南针                                                | 微信小程序 2.3.0 支持                                     |
-| enable-zoom        | Boolean           | true   | 是否支持缩放                                                  | 微信小程序 2.3.0 支持                                     |
-| enable-scroll      | Boolean           | true   | 是否支持拖动                                                  | 微信小程序 2.3.0 支持                                     |
-| enable-rotate      | Boolean           | false  | 是否支持旋转                                                  | 微信小程序 2.3.0 支持                                     |
-| enable-overlooking | Boolean           | false  | 是否开启俯视                                                  | 微信小程序 2.3.0 支持                                     |
-| enable-satellite   | Boolean           | false  | 是否开启卫星图                                                | 微信小程序 2.7.0 支持                                     |
-| enable-traffic     | Boolean           | false  | 是否开启实时路况                                              | 微信小程序 2.7.0 支持                                     |
-| show-location      | Boolean           |        | 显示带有方向的当前定位点                                      |                                                           |
-| polygons           | Array.`<polygon>` |        | 多边形                                                        |                                                           |
-| @markertap         | EventHandle       |        | 点击标记点时触发，e.detail = {markerId}                       | H5、微信小程序支持 （H5 平台需要指定 marker 对象属性 id） |
-| @labeltap          | EventHandle       |        | 点击 label 时触发，e.detail = {markerId}                      | 微信小程序 2.9.0 支持                                     |
-| @callouttap        | EventHandle       |        | 点击标记点对应的气泡时触发，e.detail = {markerId}             |                                                           |
-| @controltap        | EventHandle       |        | 点击控件时触发，e.detail = {controlId}                        |                                                           |
-| @regionchange      | EventHandle       |        | 视野发生变化时触发                                            |                                                           |
-| @tap               | EventHandle       |        | 点击地图时触发; 微信小程序 2.9 支持返回经纬度                 |                                                           |
-| @updated           | EventHandle       |        | 在地图渲染更新完成时触发                                      | 微信小程序、H5 支持                                       |
-| @anchorpointtap    | EventHandle       |        | 点击定位标时触发，e.detail = {longitude, latitude}            | 微信小程序 2.13+ 支持                                     |
-| @poitap            | EventHandle       |        | 点击地图 poi 点时触发，e.detail = {name, longitude, latitude} | 微信小程序 2.3.0+ 支持                                    |
-
-**注意**
-
--   `<map>` 组件的宽/高推荐写直接量，比如：750px，不要设置百分比值。
--   谷歌地图使用 `wgs84` 坐标，其他地图使用 `gcj02` 坐标，用错坐标类型会显示偏移。
-
-### 近期新增功能
-
-1. 支持点聚合，适用于 marker 过多场景。
-2. 支持彩虹蚯蚓线，常用于路线规划场景。
-3. 覆盖物支持调整与其它地图元素的压盖关系。
-4. 支持 marker（小车）平移动画，适用于轨迹回放场景。
-
-**markers**
-
-标记点用于在地图上显示标记的位置
-
-| 属性          | 说明                                 | 类型   | 必填 | 备注                                                                                                                     | 平台差异说明                 |
-| :------------ | :----------------------------------- | :----- | :--- | :----------------------------------------------------------------------------------------------------------------------- | :--------------------------- |
-| id            | 标记点 id                            | Number | 是   | marker 点击事件回调会返回此 id。建议为每个 marker 设置上 Number 类型 id，保证更新 marker 时有更好的性能。最大限制 9 位数 |                              |
-| latitude      | 纬度                                 | Number | 是   | 浮点数，范围 -90 ~ 90                                                                                                    |                              |
-| longitude     | 经度                                 | Number | 是   | 浮点数，范围 -180 ~ 180                                                                                                  |                              |
-| title         | 标注点名                             | String | 否   | 点击时显示，callout 存在时将被忽略                                                                                       |                              |
-| iconPath      | 显示的图标                           | String | 是   | 项目目录下的图片路径，支持相对路径写法，以'/'开头则表示相对平台小程序根目录；也支持临时路径                                  |                              |
-| rotate        | 旋转角度                             | Number | 否   | 顺时针旋转的角度，范围 0 ~ 360，默认为 0                                                                                 | 微信小程序、支付宝小程序支持 |
-| alpha         | 标注的透明度                         | Number | 否   | 默认 1，无透明，范围 0 ~ 1                                                                                               | 微信小程序、支付宝小程序支持 |
-| width         | 标注图标宽度                         | Number | 否   | 默认为图片实际宽度                                                                                                       |                              |
-| height        | 标注图标高度                         | Number | 否   | 默认为图片实际高度                                                                                                       |                              |
-| callout       | 自定义标记点上方的气泡窗口           | Object | 否   | 支持的属性见下表，可识别换行符。                                                                                         | 微信小程序、支付宝小程序支持 |
-| label         | 为标记点旁边增加标签                 | Object | 否   | 支持的属性见下表，可识别换行符。                                                                                         | 微信小程序、H5 支持          |
-| anchor        | 经纬度在标注图标的锚点，默认底边中点 | Object | 否   | {x, y}，x 表示横向(0-1)，y 表示竖向(0-1)。{x: .5, y: 1} 表示底边中点                                                     | 微信小程序、H5 支持          |
-| clusterId     | 自定义点聚合簇效果时使用             | Number | 否   |                                                                                                                          | 微信小程序 支持              |
-| customCallout | 自定义气泡窗口                       | Object | 否   |                                                                                                                          | 微信小程序支持               |
-| aria-label    | 无障碍访问，（属性）元素的额外描述   | String | 否   |                                                                                                                          | 微信小程序 支持              |
-
-**marker 上的气泡 callout**
-
-| 属性         | 说明                                      | 类型   | 平台差异说明        |
-| :----------- | :---------------------------------------- | :----- | :------------------ |
-| content      | 文本                                      | String | 微信小程序、H5 支持 |
-| color        | 文本颜色                                  | String | 微信小程序、H5 支持 |
-| fontSize     | 文字大小                                  | Number | 微信小程序、H5 支持 |
-| borderRadius | callout 边框圆角                          | Number | 微信小程序、H5 支持 |
-| bgColor      | 背景色                                    | String | 微信小程序、H5 支持 |
-| padding      | 文本边缘留白                              | Number | 微信小程序、H5 支持 |
-| display      | 'BYCLICK':点击显示; 'ALWAYS':常显         | String | 微信小程序、H5 支持 |
-| textAlign    | 文本对齐方式。有效值: left, right, center | String | 微信小程序支持      |
-
-**marker 上的标签 label**
-
-| 属性          | 说明                                      | 类型    | 平台差异说明        |
-| :------------ | :---------------------------------------- | :------ | :------------------ |
-| content       | 文本                                      | String  |                     |
-| color         | 文本颜色                                  | String  | 微信小程序、H5 支持 |
-| fontSize      | 文字大小                                  | Number  | 微信小程序、H5 支持 |
-| x             | label 的坐标，原点是 marker 对应的经纬度  | Number  | H5 支持             |
-| y             | label 的坐标，原点是 marker 对应的经纬度  | Number  | H5 支持             |
-| anchorX       | label 的坐标，原点是 marker 对应的经纬度  | Number  | 微信小程序支持      |
-| anchorY       | label 的坐标，原点是 marker 对应的经纬度  | Number  | 微信小程序支持      |
-| borderWidth   | 边框宽度                                  | Number  | 微信小程序支持      |
-| borderColor   | 边框颜色                                  | String  | 微信小程序支持      |
-| borderRadius  | 边框圆角                                  | Number  | 微信小程序支持      |
-| bgColor       | 背景色                                    | String  | 微信小程序支持      |
-| padding       | 文本边缘留白                              | Number  | 微信小程序支持      |
-| textAlign     | 文本对齐方式。有效值: left, right, center | String  | 微信小程序支持      |
-| customCallout | 自定义气泡窗口                            | Object  | 微信小程序支持      |
-| aria-label    | 无障碍访问，（属性）元素的额外描述        | String  | 微信小程序支持      |
-| joinCluster   | 是否参与点聚合                            | Boolean | 微信小程序支持      |
-
-### 点聚合
-
-当地图上需要展示的标记点 marker 过多时，可能会导致界面上 marker 出现压盖，展示不全，并导致整体性能变差。针对此类问题，推出点聚合能力。
-
-使用流程如下：
-
-通过`Util.createMapContext` 获取`MapContext`。
-
-`MapContext.initMarkerCluster` 对聚合点进行初始化配置（可选）；
-`MapContext.addMarkers` 指定参与聚合的 marker；
-`MapContext.on('markerClusterCreate', callback)` 触发时，通过 `MapContext.addMarkers` 更新聚合簇的样式 （可选）；
-`MapContext.removeMarkers` 移除参与聚合的 marker；
-
-**polyline**
-
-指定一系列坐标点，从数组第一项连线至最后一项
-
-| 属性          | 说明                         | 类型    | 必填  | 备注                                               | 平台差异说明        |
-| :------------ | :--------------------------- | :------ | :---- | :------------------------------------------------- | :------------------ |
-| points        | 经纬度数组                   | Array   | 是    | [{latitude: 0, longitude: 0}]                      |                     |
-| color         | 线的颜色                     | String  | 否    | 8 位十六进制表示，后两位表示 alpha 值，如：#0000AA |                     |
-| width         | 线的宽度                     | Number  | 否    |                                                    |                     |
-| dottedLine    | 是否虚线                     | Boolean | 否    | 默认 false                                         |                     |
-| arrowLine     | 带箭头的线                   | Boolean | 否    | 默认 false，微信小程序开发者工具暂不支持该属性     | 微信小程序支持      |
-| arrowIconPath | 更换箭头图标                 | String  | 否    | 在 arrowLine 为 true 时生效                        | 微信小程序支持      |
-| borderColor   | 线的边框颜色                 | String  | 否    |                                                    | 微信小程序、H5 支持 |
-| borderWidth   | 线的厚度                     | Number  | 否    |                                                    | 微信小程序、H5 支持 |
-| colorList     | 彩虹线                       | Array   | false | 存在时忽略 color 值                                | 微信小程序 支持     |
-| level         | 压盖关系，默认为 abovelabels | String  | false |                                                    | 微信小程序支持      |
-
-**polygon**<br>
-指定一系列坐标点，根据 points 坐标数据生成闭合多边形
-
-| 属性        | 说明                         | 类型   | 必填  | 备注                          |
-| :---------- | :--------------------------- | :----- | :---- | :---------------------------- |
-| points      | 经纬度数组                   | array  | 是    | [{latitude: 0, longitude: 0}] |
-| strokeWidth | 描边的宽度                   | Number | 否    |                               |
-| strokeColor | 描边的颜色                   | String | 否    | 十六进制                      |
-| fillColor   | 填充颜色                     | String | 否    | 十六进制                      |
-| zIndex      | 设置多边形 Z 轴数值          | Number | 否    |                               |
-| level       | 压盖关系，默认为 abovelabels | String | false | 微信小程序 支持               |
-
-**circles**
-
-在地图上显示圆
-
-| 属性        | 说明                         | 类型   | 必填  | 备注                                               |
-| :---------- | :--------------------------- | :----- | :---- | :------------------------------------------------- |
-| latitude    | 纬度                         | Number | 是    | 浮点数，范围 -90 ~ 90                              |
-| longitude   | 经度                         | Number | 是    | 浮点数，范围 -180 ~ 180                            |
-| color       | 描边的颜色                   | String | 否    | 8 位十六进制表示，后两位表示 alpha 值，如：#0000AA |
-| fillColor   | 填充颜色                     | String | 否    | 8 位十六进制表示，后两位表示 alpha 值，如：#0000AA |
-| radius      | 半径                         | Number | 是    |                                                    |
-| strokeWidth | 描边的宽度                   | Number | 否    | &nbsp;                                             |
-| level       | 压盖关系，默认为 abovelabels | String | false | 微信小程序 支持                                    |
-
-**controls**
-
-在地图上显示控件，控件不随着地图移动
-
-| 属性      | 说明             | 类型    | 必填 | 备注                                                                                  |
-| :-------- | :--------------- | :------ | :--- | :------------------------------------------------------------------------------------ |
-| id        | 控件 id          | Number  | 否   | 在控件点击事件回调会返回此 id                                                         |
-| position  | 控件在地图的位置 | Object  | 是   | 控件相对地图位置                                                                      |
-| iconPath  | 显示的图标       | String  | 是   | 项目目录下的图片路径，支持相对路径写法，以'/'开头则表示相对项目根目录；也支持临时路径 |
-| clickable | 是否可点击       | Boolean | 否   | 默认不可点击                                                                          |
-
-**position**
-
-| 属性   | 说明                 | 类型   | 必填 | 备注           |
-| :----- | :------------------- | :----- | :--- | :------------- |
-| left   | 距离地图的左边界多远 | Number | 否   | 默认为 0       |
-| top    | 距离地图的上边界多远 | Number | 否   | 默认为 0       |
-| width  | 控件宽度             | Number | 否   | 默认为图片宽度 |
-| height | 控件高度             | Number | 否   | 默认为图片高度 |
-
-地图组件的经纬度必填，如果不填经纬度则默认值是北京的经纬度。
-
-**示例** [查看示例](https://hellouniapp.dcloud.net.cn/pages/component/map/map)
-
-::: preview https://hellouniapp.dcloud.net.cn/pages/component/map/map
-
-> Template
-
-```html
-<template>
-    <view>
-        <view class="page-body">
-            <view class="page-section page-section-gap">
-                <map
-                    style="width: 100%; height: 300px;"
-                    :latitude="latitude"
-                    :longitude="longitude"
-                    :markers="covers"
-                ></map>
-            </view>
-        </view>
-    </view>
-</template>
-```
-
-> Script
-
-```html
-<script>
-export default {
-    data() {
-        return {
-            id: 0, // 使用 marker点击事件 需要填写id
-            title: 'map',
-            latitude: 39.909,
-            longitude: 116.39742,
-            covers: [
-                {
-                    latitude: 39.909,
-                    longitude: 116.39742,
-                    iconPath: '../../../static/location.png'
-                },
-                {
-                    latitude: 39.9,
-                    longitude: 116.39,
-                    iconPath: '../../../static/location.png'
-                }
-            ]
-        };
-    },
-    methods: {}
-};
-</script>
-```
-
-:::
-
-map 组件相关操作的 JS API：`Util.createMapContext`
-
-**注意事项**
-
--   平台小程序中，`<map>` 组件是由引擎创建的平台小程序原生组件，它的层级是最高的，不能通过 z-index 控制层级。在`<map>`上绘制内容，可使用组件自带的 marker、controls 等属性，也可以使用`<cover-view>`组件。
--   在涉及层级问题的平台小程序中 中，请勿在 scroll-view、movable-view 中使用 `<map>` 组件。
--   平台小程序中，css 动画对 `<map>` 组件无效。
--   map 组件使用的经纬度是国测局坐标。
--   `<map>` 组件在不同平台的底层引擎是不同的：微信小程序为腾讯地图；H5 为腾讯地图或谷歌地图；支付宝（中国大陆地区版本）小程序为高德地图；
--   H5 端获取定位信息，需要部署在 **https** 服务上，本地预览（localhost）仍然可以使用 http 协议。
--   无 GPS 模块或 GPS 无信号的 PC 设备使用 Chrome 浏览器的时候，位置信息是连接谷歌服务器获取的，国内用户可能获取位置信息失败。
--   H5 端使用地图和定位相关，需要在 [manifest.json](/m8mpdoc/index.html?file=0001-前期准备/006-manifest) 内配置腾讯或谷歌等三方地图服务商申请的秘钥（key）。
-
-### 三方定位和地图服务收费说明
-
--   使用三方定位或者地图服务，需向服务提供商（如：高德地图、百度地图、腾讯地图、谷歌地图）申请授权或缴纳费用。
--   申请三方定位或地图服务秘钥时请详细阅读授权和收费说明，并关注服务条款后期的变更。
--   以下是关于部分地图服务商授权和收费的简介，具体以地图服务商官网公布的最新信息为准。
-    -   高德地图：商用授权收费，超出配额收费。
-    -   百度地图：商用授权收费，超出配额收费。
-    -   腾讯地图：商用授权收费，超出配额收费。
-    -   谷歌地图：按量收费，每月赠送一定金额。
-    -   小程序平台内置地图：无需关心地图服务商，免费使用，无配额限制。

package/docs/m8mpdoc-develop/017-/345/206/205/347/275/256/347/273/204/344/273/266/019-input.md

@@ -1,202 +0,0 @@
-#### input
-
-输入框。
-
-**属性说明**
-
-| 属性名                 | 类型        | 默认值              | 说明                                                                                                                                                        | 平台差异说明                                                           |
-| :--------------------- | :---------- | :------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |
-| value                  | String      |                     | 输入框的初始内容                                                                                                                                            |                                                                        |
-| type                   | String      | text                | input 的类型                                                                                                                                                | H5 暂未支持动态切换，详见下方 Tips，请使用 v-if 进行整体切换           |
-| password               | Boolean     | false               | 是否是密码类型                                                                                                                                              | H5 写此属性时，type 失效                                               |
-| placeholder            | String      |                     | 输入框为空时占位符                                                                                                                                          |                                                                        |
-| placeholder-style      | String      |                     | 指定 placeholder 的样式                                                                                                                                     |                                                                        |
-| placeholder-class      | String      | "input-placeholder" | 指定 placeholder 的样式类，注意页面或组件的 style 中写了 scoped 时，需要在类名前写::v-deep                                                                  |                                                                        |
-| disabled               | Boolean     | false               | 是否禁用                                                                                                                                                    |                                                                        |
-| maxlength              | Number      | 140                 | 最大输入长度，设置为 -1 的时候不限制最大长度                                                                                                                |                                                                        |
-| cursor-spacing         | Number      | 0                   | 指定光标与键盘的距离，单位 px 。取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离                                             | 微信小程序支持                                                         |
-| focus                  | Boolean     | false               | 获取焦点。                                                                                                                                                  | 在 H5 平台能否聚焦以及软键盘是否跟随弹出，取决于当前浏览器本身的实现。 |
-| confirm-type           | String      | done                | 设置键盘右下角按钮的文字，仅在 type="text" 时生效。                                                                                                         | 微信小程序、H5 支持                                                    |
-| confirm-hold           | Boolean     | false               | 点击键盘右下角按钮时是否保持键盘不收起                                                                                                                      |                                                                        |
-| cursor                 | Number      |                     | 指定 focus 时的光标位置                                                                                                                                     |                                                                        |
-| selection-start        | Number      | -1                  | 光标起始位置，自动聚集时有效，需与 selection-end 搭配使用                                                                                                   |                                                                        |
-| selection-end          | Number      | -1                  | 光标结束位置，自动聚集时有效，需与 selection-start 搭配使用                                                                                                 |                                                                        |
-| adjust-position        | Boolean     | true                | 键盘弹起时，是否自动上推页面                                                                                                                                | 微信小程序支持                                                         |
-| hold-keyboard          | boolean     | false               | focus 时，点击页面的时候不收起键盘                                                                                                                          | 微信小程序 2.8.2 支持                                                  |
-| ignoreCompositionEvent | boolean     | true                | 是否忽略组件内对文本合成系统事件的处理。为 `false` 时将触发 `compositionstart、compositionend、compositionupdate` 事件，且在文本合成期间会触发 `input` 事件 | H5 不支持                                                              |
-| @input                 | EventHandle |                     | 当键盘输入时，触发 input 事件，event.detail = {value}                                                                                                       | 差异见下方 Tips                                                        |
-| @focus                 | EventHandle |                     | 输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度                                                                                       | 仅微信小程序支持 height                                                |
-| @blur                  | EventHandle |                     | 输入框失去焦点时触发，event.detail = {value: value}                                                                                                         |                                                                        |
-| @confirm               | EventHandle |                     | 点击完成按钮时触发，event.detail = {value: value}                                                                                                           |                                                                        |
-| @keyboardheightchange  | eventhandle |                     | 键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration}                                                                       | 微信小程序基础库 2.7.0+支持                                            |
-
-**Tips**
-
--   `input` 事件处理函数可以直接 return 一个字符串，将替换输入框的内容。仅微信小程序支持。
--   如果遇到 value 属性设置不生效的问题参考：[组件属性设置不生效解决办法](https://uniapp.dcloud.io/tutorial/vue-api.html#%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98)
--   `input` 组件上有默认的 `min-height` 样式，如果 `min-height` 的值大于 `height` 的值那么 `height` 样式无效。
--   H5 暂未支持动态切换，请使用 `v-if`进行整体切换。
-
-```html
-<!-- 错误写法 -->
-<input :type="isText?'text':'number'" placeholder="请输入内容" />
-
-<!-- 正确写法 -->
-<input v-if="isText" type="text" placeholder="请输入文本" />
-<input v-else type="number" placeholder="请输入数字" />
-```
-
-**type 有效值**
-
-| 值     | 说明               | 平台差异说明                                                                            |
-| :----- | :----------------- | :-------------------------------------------------------------------------------------- |
-| text   | 文本输入键盘       |                                                                                         |
-| number | 数字输入键盘       |  |
-| idcard | 身份证输入键盘     | 微信、支付宝支持 |
-| digit  | 带小数点的数字键盘 |  |
-
-**注意事项**
-
--   原 html 规范中 input 不仅是输入框，还有 radio、checkbox、时间、日期、文件选择功能。在 M8跨端框架及平台小程序规范中，input 仅仅是输入框。其他功能 M8跨端框架 有单独的组件或 API：[radio 组件](/m8mpdoc/index.html?file=009-UI组件/029-radio单选框)、[checkbox 组件](/m8mpdoc/index.html?file=009-UI组件/009-checkbox复选框)、图片选择(ejs.util.selectImage)、视频选择(ejs.util.selectVideo)、通用文件选择(ejs.io.selectFile)等等。
--   小程序平台，`number` 类型只支持输入整型数字。微信开发者工具上体现不出效果，请使用真机预览。
--   如果需要在小程序平台输入浮点型数字，请使用 `digit` 类型。
--   平台小程序端 input 在置焦时，会表现为原生控件，此时会层级变高。如需前端组件遮盖 input，需让 input 失焦，或使用 cover-view 等覆盖原生控件的方案，参考开发规范中的平台小程序原生组件说明。具体来讲，微信所有 input 置焦均为原生控件。
--   input 组件若不想弹出软键盘，可设置为 disabled
-
-**confirm-type 有效值**
-
-| 值     | 说明                 | 平台差异说明                                                                                                                      |
-| :----- | :------------------- | :-------------------------------------------------------------------------------------------------------------------------------- |
-| send   | 右下角按钮为“发送”   | 微信、支付宝、 h5(2.9.9+，且要求设备 webview 内核 Chrome81+、Safari13.7+) |
-| search | 右下角按钮为“搜索”   |                                                                                                                                   |
-| next   | 右下角按钮为“下一个” | 微信、支付宝、h5(2.9.9+，且要求设备 webview 内核 Chrome81+、Safari13.7+) |
-| go     | 右下角按钮为“前往”   |                                                                                                                                   |
-| done   | 右下角按钮为“完成”   | 微信、支付宝、h5(2.9.9+，且要求设备 webview 内核 Chrome81+、Safari13.7+) |
-
--   H5 平台 的弹出键盘使用的是浏览器控制的键盘，在 Chrome81+、Safari13.7+之前，键盘右下角文字只能设置完成和搜索，从 Chrome81+、Safari13.7+起支持设置发送、下一个。
-
-#### 关于软键盘弹出的逻辑说明
-
-小程序平台只支持 adjustPan 模式，H5 平台因不同浏览器而异
-
--   adjustResize：软键盘弹出时，webview 窗体高度挤压。屏幕高度=webview 窗体高度+软键盘高度
--   adjustPan：软键盘弹出时，webview 窗体高度不变，但窗体上推，以保证输入框不被软键盘盖住
-
-配置方式，在 pages.json 中配置 style
-
-```json
-"app-plus": {
-	"softinputMode": "adjustResize"
-}
-```
-
-**注意**
-
--   平台小程序端在 input 聚焦期间，避免使用 css 动画。
--   H5 平台只能在用户交互时修改 focus 生效。
--   如果遇到 focus 属性设置不生效的问题参考：[组件属性设置不生效解决办法](https://uniapp.dcloud.io/tutorial/vue-api.html#%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98)
--   如需禁止点击其他位置收起键盘的默认行为，可以监听`touch`事件并使用`prevent`修饰符（仅支持H5，其他平台可以通过设置`focus`来使输入框重新获取焦点），例如在确认按钮上使用：`@touchend.prevent="onTap"`
-
-#### 关于软键盘收起的逻辑说明
-
--   Android 上在软键盘弹出后，点击 back 或点击非置焦区域可收起软键盘。
--   iOS 上如果软键盘上方有带有“完成”的横条，则需要点完成才能收起键盘；如果没有软键盘上方横条，则点击非 input/textarea 区域即可收起软键盘
-
-**input 示例** [查看演示](https://hellouniapp.dcloud.net.cn/pages/component/input/input)
-
-以下示例代码，来自于[hello uni-app 项目](https://github.com/dcloudio/hello-uniapp)。
-
-::: preview https://hellouniapp.dcloud.net.cn/pages/component/input/input
-
-> Template
-
-```html
-<!-- 本示例未包含完整css，获取外链css请参考上文，在hello uni-app项目中查看 -->
-<template>
-    <view>
-        <view class="uni-common-mt">
-            <view class="uni-form-item uni-column">
-                <view class="title">可自动聚焦的input</view>
-                <input class="uni-input" focus placeholder="自动获得焦点" />
-            </view>
-            <view class="uni-form-item uni-column">
-                <view class="title">键盘右下角按钮显示为搜索</view>
-                <input class="uni-input" confirm-type="search" placeholder="键盘右下角按钮显示为搜索" />
-            </view>
-            <view class="uni-form-item uni-column">
-                <view class="title">控制最大输入长度的input</view>
-                <input class="uni-input" maxlength="10" placeholder="最大输入长度为10" />
-            </view>
-            <view class="uni-form-item uni-column">
-                <view class="title">实时获取输入值：{{ inputValue }}</view>
-                <input class="uni-input" @input="onKeyInput" placeholder="输入同步到view中" />
-            </view>
-            <view class="uni-form-item uni-column">
-                <view class="title">控制输入的input</view>
-                <input class="uni-input" @input="replaceInput" v-model="changeValue" placeholder="连续的两个1会变成2" />
-            </view>
-            <!-- #ifndef MP-BAIDU -->
-            <view class="uni-form-item uni-column">
-                <view class="title">控制键盘的input</view>
-                <input class="uni-input" ref="input1" @input="hideKeyboard" placeholder="输入123自动收起键盘" />
-            </view>
-            <!-- #endif -->
-            <view class="uni-form-item uni-column">
-                <view class="title">数字输入的input</view>
-                <input class="uni-input" type="number" placeholder="这是一个数字输入框" />
-            </view>
-            <view class="uni-form-item uni-column">
-                <view class="title">密码输入的input</view>
-                <input class="uni-input" password type="text" placeholder="这是一个密码输入框" />
-            </view>
-            <view class="uni-form-item uni-column">
-                <view class="title">带小数点的input</view>
-                <input class="uni-input" type="digit" placeholder="带小数点的数字键盘" />
-            </view>
-            <view class="uni-form-item uni-column">
-                <view class="title">身份证输入的input</view>
-                <input class="uni-input" type="idcard" placeholder="身份证输入键盘" />
-            </view>
-            <view class="uni-form-item uni-column">
-                <view class="title">控制占位符颜色的input</view>
-                <input class="uni-input" placeholder-style="color:#F76260" placeholder="占位符字体是红色的" />
-            </view>
-        </view>
-    </view>
-</template>
-```
-
-> Script
-
-```html
-<script>
-export default {
-    data() {
-        return {
-            title: 'input',
-            focus: false,
-            inputValue: '',
-            changeValue: ''
-        };
-    },
-    methods: {
-        onKeyInput: function (event) {
-            this.inputValue = event.target.value;
-        },
-        replaceInput: function (event) {
-            var value = event.target.value;
-            if (value === '11') {
-                this.changeValue = '2';
-            }
-        },
-        hideKeyboard: function (event) {
-            if (event.target.value === '123') {
-                uni.hideKeyboard();
-            }
-        }
-    }
-};
-</script>
-```
-
-:::

package/docs/m8mpdoc-develop/017-/345/206/205/347/275/256/347/273/204/344/273/266/020-textarea.md

@@ -1,119 +0,0 @@
-#### textarea
-
-多行输入框。
-
-**属性说明**
-
-| 属性名                  | 类型        | 默认值               | 说明                                                                                                                                                        | 平台差异说明                                                                              |
-| :---------------------- | :---------- | :------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------- |
-| value                   | String      |                      | 输入框的内容                                                                                                                                                |                                                                                           |
-| placeholder             | String      |                      | 输入框为空时占位符                                                                                                                                          |                                                                                           |
-| placeholder-style       | String      |                      | 指定 placeholder 的样式                                                                                                                                     |                                                                                           |
-| placeholder-class       | String      | textarea-placeholder | 指定 placeholder 的样式类，注意页面或组件的 style 中写了 scoped 时，需要在类名前写/deep/                                                                    |                                                                                           |
-| disabled                | Boolean     | false                | 是否禁用                                                                                                                                                    |                                                                                           |
-| maxlength               | Number      | 140                  | 最大输入长度，设置为 -1 的时候不限制最大长度                                                                                                                |                                                                                           |
-| focus                   | Boolean     | false                | 获取焦点                                                                                                                                                    | 在 H5 平台能否聚焦以及软键盘是否跟随弹出，取决于当前浏览器本身的实现。                    |
-| auto-height             | Boolean     | false                | 是否自动增高，设置 auto-height 时，style.height 不生效                                                                                                      |                                                                                           |
-| fixed                   | Boolean     | false                | 如果 textarea 是在一个 position:fixed 的区域，需要显示指定属性 fixed 为 true                                                                                | 微信小程序支持                                                                            |
-| cursor-spacing          | Number      | 0                    | 指定光标与键盘的距离，单位 px 。取 textarea 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离                                          | 微信小程序支持                                                                            |
-| cursor                  | Number      |                      | 指定 focus 时的光标位置                                                                                                                                     | 微信小程序、H5 支持                                                                       |
-| confirm-type            | String      | done                 | 设置键盘右下角按钮的文字                                                                                                                                    | 微信小程序基础库 2.13.0+、H5(2.9.9+，且要求设备 webview 内核 Chrome81+、Safari13.7+) 支持 |
-| confirm-hold            | Boolean     | false                | 点击键盘右下角按钮时是否保持键盘不收起                                                                                                                      | H5 、微信小程序 (基础库 2.16.0+)支持                                                      |
-| show-confirm-bar        | Boolean     | true                 | 是否显示键盘上方带有”完成“按钮那一栏                                                                                                                        | 微信小程序支持                                                                            |
-| selection-start         | Number      | -1                   | 光标起始位置，自动聚焦时有效，需与 selection-end 搭配使用                                                                                                   | 微信小程序、H5 支持                                                                       |
-| selection-end           | Number      | -1                   | 光标结束位置，自动聚焦时有效，需与 selection-start 搭配使用                                                                                                 | 微信小程序、H5 支持                                                                       |
-| adjust-position         | Boolean     | true                 | 键盘弹起时，是否自动上推页面                                                                                                                                | 微信小程序支持                                                                            |
-| disable-default-padding | boolean     | false                | 是否去掉 iOS 下的默认内边距                                                                                                                                 | 微信小程序 2.10.0 支持                                                                    |
-| hold-keyboard           | boolean     | false                | focus 时，点击页面的时候不收起键盘                                                                                                                          | 微信小程序 2.8.2 支持                                                                     |
-| auto-blur               | boolean     | false                | 键盘收起时，是否自动失去焦点                                                                                                                                |                                                                                           |
-| ignoreCompositionEvent  | boolean     | true                 | 是否忽略组件内对文本合成系统事件的处理。为 `false` 时将触发 `compositionstart、compositionend、compositionupdate` 事件，且在文本合成期间会触发 `input` 事件 | H5 不支持                                                                                 |
-| @focus                  | EventHandle |                      | 输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度                                                                                       | 仅微信小程序支持 height                                                                   |
-| @blur                   | EventHandle |                      | 输入框失去焦点时触发，event.detail = {value, cursor}                                                                                                        |                                                                                           |
-| @linechange             | EventHandle |                      | 输入框行数变化时调用，event.detail = {height: 0, heightRpx: 0, lineCount: 0}                                                                                |                                                                                           |
-| @input                  | EventHandle |                      | 当键盘输入时，触发 input 事件，event.detail = {value, cursor}， @input 处理函数的返回值并不会反映到 textarea 上                                             |                                                                                           |
-| @confirm                | EventHandle |                      | 点击完成时， 触发 confirm 事件，event.detail = {value: value}                                                                                               | 微信小程序支持                                                                            |
-| @keyboardheightchange   | Eventhandle |                      | 键盘高度发生变化的时候触发此事件，event.detail = {height: height, duration: duration}                                                                       | 微信小程序基础库 2.7.0+支持                                                               |
-
-**confirm-type 有效值**
-
-| 值     | 说明                 |
-| :----- | :------------------- |
-| send   | 右下角按钮为“发送”   |
-| search | 右下角按钮为“搜索”   |
-| next   | 右下角按钮为“下一个” |
-| go     | 右下角按钮为“前往”   |
-| done   | 右下角按钮为“完成”   |
-
-**示例** [查看示例](https://hellouniapp.dcloud.net.cn/pages/component/textarea/textarea)
-
-以下示例代码，来自于[hello uni-app 项目](https://github.com/dcloudio/hello-uniapp)。
-
-::: preview https://hellouniapp.dcloud.net.cn/pages/component/textarea/textarea
-
-> Template
-
-```html
-<!-- 本示例未包含完整css，获取外链css请参考上文，在hello uni-app项目中查看 -->
-<template>
-    <view>
-        <view class="uni-title uni-common-pl">输入区域高度自适应，不会出现滚动条</view>
-        <view class="uni-textarea">
-            <textarea @blur="bindTextAreaBlur" auto-height />
-        </view>
-        <view class="uni-title uni-common-pl">占位符字体是红色的textarea</view>
-        <view class="uni-textarea">
-            <textarea placeholder-style="color:#F76260" placeholder="占位符字体是红色的" />
-        </view>
-    </view>
-</template>
-<script>
-export default {
-    data() {
-        return {};
-    },
-    methods: {
-        bindTextAreaBlur: function (e) {
-            console.log(e.detail.value);
-        }
-    }
-};
-</script>
-```
-
-:::
-
-**Tips**
-
--   textarea 的 blur 事件会晚于页面上的 tap 事件。
--   如果遇到 value 属性设置不生效的问题参考：[组件属性设置不生效解决办法](https://uniapp.dcloud.io/tutorial/vue-api.html#%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98)
--   微信小程序中，textarea 是平台小程序原生组件，层级高于前端组件，请勿在 scroll-view、movable-view 中使用 textarea 组件。覆盖 textarea 需要使用 cover-view。
--   平台小程序端 css 动画对 textarea 组件无效。
--   H5 平台只能在用户交互时修改 focus 生效。
--   如果遇到 focus 属性设置不生效的问题参考：[组件属性设置不生效解决办法](https://uniapp.dcloud.io/tutorial/vue-api.html#%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98)
--   软键盘的弹出和收起逻辑，详见[input 的文档](/m8mpdoc/index.html?file=017-内置组件/019-input)
--   如需禁止点击其他位置收起键盘的默认行为，可以监听`touch`事件并使用`prevent`修饰符（仅支持H5，其他平台可以通过设置`focus`来使输入框重新获取焦点），例如在确认按钮上使用：`@touchend.prevent="onTap"`
--   js 中给 textarea 组件赋值为字符串，在字符串中加\n 可实现换行。
--   旧版本 chrome 或同内核浏览器会将输入多个标点符号放在一行，此时可通过将 textarea 样式设置为`word-break: break-word;`实现自动换行。
-
-```html
-<template>
-    <view class="content">
-        <textarea class="textarea" v-model="txt"></textarea>
-    </view>
-</template>
-<script>
-    export default {
-        data() {
-            return {
-                txt: 'hello world！\n textarea多行输入框'
-            };
-        }
-    };
-</script>
-```
-
-**富文本编辑的解决方案**
-在输入框里图文混排内容，在 web 上该功能依赖 document，而平台小程序的正常页面又没有 document。
-
--   方式一：采用 markdown 编辑器方案，输入区输入 markdown 语法，预览区提供预览。这种方式可以跨端。插件市场搜[富文本编辑](https://ext.dcloud.net.cn/search?q=%E5%AF%8C%E6%96%87%E6%9C%AC%E7%BC%96%E8%BE%91)，有不少插件。
--   方式二：使用 web-view 组件，加载 html 页面，此时可使用 web 中常见的各种富文本编辑器，插件市场也有这类插件。