开发手册 欢迎您！
软件开发者资料库

Framework7 - 自动完成

Framework7自动完成 - 从概述，环境，布局，导航栏，工具栏，搜索栏，状态栏，侧面板，内容块，布局网格，叠加层，预加载器，进度条，列表视图，手风琴，卡片，芯片，按钮，开始学习Framework7动作按钮，表单，选项卡，Swiper滑块，照片浏览器，自动完成，选择器，日历，刷新，无限滚动，消息，消息栏，通知，延迟加载，颜色主题，细线，模板概述，自动编译，Template7页面，活动状态，点按保持事件，触摸波纹。

描述

自动完成是Framework7的移动友好和触摸优化组件，可以是下拉列表或独立方式.您可以使用JavaScript方法创建和初始化自动完成实例 :

myApp.autocomplete(parameters)

其中参数是用于初始化自动完成实例的必需对象.

自动完成参数

下表列出了Framework7中可用的自动完成参数 :

S.No参数&说明键入默认
1

openIn

它定义了如何打开自动填充功能，可以用作下拉列表，弹出窗口或页面.

stringpage
2

source

它使用自动完成实例，搜索查询和渲染函数来传递匹配的项目array.

function(autocomplete，query，render)-
3

valueProperty

它指定匹配项目对象密钥的项目值.

stringid
4

limit

显示数量有限每个查询自动填充的商品.

数字-
5

preloader

预加载器可用于通过将其设置为true来指定自动完成布局.

booleanfalse
6

preloaderColor

它指定预加载器颜色.默认情况下，颜色为"黑色".

string-
7

value

使用默认选定值定义数组.

array-
8

textProperty

它指定匹配项对象键的项值，可用作标题显示的选项.

stringtext

独立自动完成参数

下表列出了Framework7 : 中可用的独立自动完成参数;

S.No参数&说明键入默认
1

opener

这是字符串或HTML元素参数，它将打开独立的自动完成页面.

string或HTMLElement-
2

popupCloseText

它用于关闭自动完成弹出窗口.

string'关闭'
3

backText

当自动填充作为页面打开时，它提供反向链接.

string'返回'
4

pageTitle

它指定自动填充页面标题.

取值tring-
5

searchbarPlaceholderText

它指定搜索栏占位符文本.

string'Search'
6

searchbarCancelText

它定义了搜索栏取消按钮文本.

string'取消'
7

notFoundText

当找不到匹配元素时显示文本.

string'找不到'
8

multiple

它允许通过将其设置为选择多个选择true.

booleanfalse
9

navbarTheme

它指定了颜色主题navbar.

string-
10

backOnSelect

当用户选择值时，自动完成将通过将其设置为true来关闭.

booleanfalse
11

formTheme

它指定表单的颜色主题.

string-

下拉列表自动完成参数

下表列出了Framework7中可用的Dropdown Autocomplete参数 :

S.No参数&说明键入默认
1

input

它是用于文本输入的字符串或HTML元素.

string或HTMLElement-
2

dropdownPlaceholderText

它指定了下拉占位符文本.

string-
3

updateInputValueOnSelect

您可以更新输入值选择时将其设置为true.

booleantrue
4

expandInput

您可以通过设置扩展列表视图中的文本输入，以便在下拉期间全屏显示item-input 它为true.

booleanfalse

自动完成回调函数

下表列出了可用的Dropdown Framework7中的自动填充参数 :

S .No参数&说明键入默认
1

onChange

每当更改自动完成值时，将执行此回调函数.

function( autocomplete，value)-
2

onOpen

每当打开自动完成时，都会执行此回调函数.

function(autocomplete)-
3

onClose

每当关闭自动完成时，将执行此回调函数.

function(autocomplete)-

自动完成模板

下表列出了可用的Drop down Framework7中的自动填充参数 :

S.No参数&说明键入默认
1

navbarTemplate

它是独立的自动完成导航栏模板.

string-
2

itemTemplate

它是独立的template7表单项.

string-
3

dropdownTemplate

这是template7下拉模板.

string-
4

dropdownItemTemplate

这是template7下拉列表项.

string-
5

dropdownPlaceholderTemplate

它是template7下拉占位符项.

字符串-

默认模板

以下是上面定义的模板参数的默认模板代码片段 :

navbarTemplate

                  {{#if material}}                                                {{else}}                                          {{#if inPopup}}                  {{popupCloseText}}               {{else}}                  {{backText}}               {{/if}}                     {{/if}}      
      {{pageTitle}}
      {{#if preloader}}                                                {{/if}}   

itemTemplate

  •                {{#if material}}                                                               {{text}}               {{else}}         {{#if checkbox}}                                                {{/if}}                                 {{text}}               {{/if}}   

    • dropdownTemplate

                      
                     {{#if preloader}}               {{#if material}}            {{materialPreloaderHtml}}         {{/if}}         {{/if}}

      dropdownItemTemplate

    •                   {{text}}         

      • dropdownPlaceholderTemplate

                        {{text}}         

      自动填充方法

      下表指定了Framework7中可用的自动填充方法 :

      S.No方法&说明
      1

      myAutocomplete.params

      定义与对象一起传递的初始化参数.

      2

      myAutocomplete.value

      它使用选定的值定义数组.

      3

      myAutocomplete.opened

      如果设置为true，则会打开自动填充功能.

      4

      myAutocomplete.dropdown

      它指定了一个自动完成下拉列表的实例.

      5

      myAutocomplete.popup

      它指定了一个自动完成弹出窗口的实例.

      6

      myAutocomplete.page

      它指定一个自动填充页面的实例.

      7

      myAutocomplete.pageData

      它定义了自动填充页面数据.

      8

      myAutocomplete.searchbar

      它定义了自动填充搜索栏实例.

      自动完成属性

      下表指定了Framework7中可用的自动填充方法 :

      S.No属性&说明
      1

      myAutocomplete.open()

      它会打开自动填充功能，可以用作下拉菜单，弹出窗口或页面.

      2

      myAutocomplete.close()

      关闭自动完成.

      3

      myAutocomplete.showPreloader()

      显示自动完成预加载器.

      4

      myAutocomplete.hidePreloader( )

      它隐藏了自动完成预加载器.

      5

      myAutocomplete.destroy()

      它破坏了自动完成预加载器实例并删除所有事件.

      示例

      下面的示例演示了使用隐藏在Framework7 :

                                 Autocomplete                                                                                                                                                                   Autcomplete                                                                                                                      Simple Dropdown Autocomplete                                             
                                                                 Country                                                                                                                                                
                                                                  Dropdown With Input Expand                                             
                                                                 Country                                                                                                                                                
                                                                  Dropdown With All Values                                             
                                                                 Country                                                                                                                                                
                                                                  Dropdown With Placeholder                                             
                                                                 Country                                                                                                                                                
                                                                  Simple Standalone Autocomplete                                             
                                   
      •                                                                                                                                     Favorite Country                                                                                                                              
        •                         
                                                                  Popup Standalone Autocomplete                                             
                                   
      •                                                                                                                                     Favorite Country                                                                                                                              
        •                         
                                                                  Multiple Values Standalone Autocomplete                                             
                                   
      •                                                                                                                                     Favorite Countries                                                                                                                              
        •                         
                                                                                                                                        

      输出

      让我们执行以下步骤，看看上面给出的代码如何工作 : 去;

      • 将上面给出的HTML代码保存为服务器根文件夹中的 autocomplete.html 文件.

      • 将此HTML文件打开为http://localhost/autocomplete.html，输出显示如下.

      • 该示例提供简单下拉列表中的值自动完成，所有值下拉列表，占位符下拉列表，独立自动完成等等.