Form API

表单API

文件夹

1.概述

2.亮点

3.使用方法

4.表单元素

4.1 基本表单元素

4.2 定制表单元素

5.经常使用函数

5.1  add_action_buttons($cancel =true,$submitlabel =null)

5.2 setDefault()

5.3 disableif()

5.4 addRule()

5.5 setHelpButton

5.6 addHelpButton

5.7 setType()

5.8 disable_form_change_checker()

1.概述

WEB表单在Moodle中创建是使用Form API。Form API支持全部的html表单元素(checkbox/radio/textbox 等等),并且引入安全检查。

2.亮点

1. 支持拖拽

2. 较少使用表格布局.

3. 表当数据安全, 通过携带必须的參数,可选的session key.

4. 支持client有效性检查

5. 能够在表单元素里加入Moodle帮助button.

6. 支持文件库

7. 支持很多定制的moodle特定的与非特定的表单元素。

8. 可加入反复元素.

9. 按组加入表单元素

3.使用方法

在 moodle中创建一个表单, 你须要创建一个class 继承自 moodleform  class 并且还要重写 definition方法来包括你要创建的表单元素。

//moodleform 类定义在 formslib.php文件里
require_once("$CFG->libdir/formslib.php");
 
class simplehtml_form extends moodleform {
//为form加入元素
public function definition() {
global $CFG;
$mform = $this->_form; //别忘了下划线
$mform->addElement('text', 'email', get_string('email')); // 加入元素到你的表单
$mform->setType('email', PARAM_NOTAGS); //设置元素类型
$mform->setDefault('email', 'Please enter email'); //设置元素默认值
...
}
//定制有效性检查能够放在这个函数里
function validation($data, $files) {
return array();
}
}

然后初始化 form (这个样例是初始化 simplehtml_form)在你要加入表单的页面里。

//首先包括 simplehtml_form.php 文件
require_once('PATH_TO/simplehtml_form.php');
 
//然后实例化simplehtml_form
$mform = new simplehtml_form();
 
//Form程序处理和显示放在这里
if ($mform->is_cancelled()) {
//处理取消表单操作(假设有取消button的话)
} else if ($fromform = $mform->get_data()) {
//I这里能够进行数据有效性检查 $mform->get_data() 返回表单传递过来的数据.
} else {
// 这个分支是表单初始化或者假设表单提交后数据不合法,那么表单就得又一次显示  
//设置默认数据 假设存在的话
$mform->set_data($toform);
//显示表单
$mform->display();
}

4.表单元素

4.1 基本表单元素

1. button  普通按钮

2. checkbox  复选框

3. radio   单选框

4. select  下拉列表

5. multi-select  多选下拉列表

6. password  密码框

7. hidden  隐藏表单元素

8. html - div元素

9. static - 显示一个静态的文本.

10. text - 文本框

11. textarea  - 文本域

4.2 定制表单元素

1. advcheckbox - Advance checkbox

2. passwordunmask - 密码元素是可选将密码显示成普通文本.

3. recaptcha   - 验证码

4. selectyesno  - 是否选择框

5. selectwithlink  -  带链接的下拉选择框

6. date_selector   日期选择器

7. date_time_selector  日期时间选择器

8. duration   持续时间

9. editor   富文本编辑器

10. filepicker - 上传单个文件

11. filemanager - 上传多个文件

12. tags   - 标记

13. addGroup  - 加入到组

14. modgrade  - 模块分数

15. modvisible  - 模块可见性

16. choosecoursefile  - 选择课程文件

17. grading   - 等级

18. questioncategory  - 问题类型

5.经常使用函数

5.1  add_action_buttons($cancel =true,$submitlabel =null)

加入动作button,第一个參数是要不要加入取消button,第二个參数是提交button的文本信息是什么可用函数is get_string('savechanges'). 获得,最贱的的默认例如以下:

$this->add_action_buttons();

 5.2  setDefault()

为单个元素设置默认值

  5.3 disableif()

在这里加入条件隐藏某些不满足显示条件的表单元素或组。

5.4 addRule()

 server/client 加入有效性检查规则像文本框类型为email的时候.

5.5 setHelpButton()

   为表单元素设置一个弹出的帮助信息

  5.6 addHelpButton()

   加入上面设置好的帮助信息。

5.7 setType()

PARAM_* 提交时会检查的特殊变量类型.

5.8 disable_form_change_checker()

默认情况下不论什么 Moodle 表单江会弹出"你确定提交?" 的警告框,假设你想做些改变然后尝试离开这个页面不做保存偶尔,这是不希望看到的 这样的情况下你能够调用 

$mform->disable_form_change_checker().

因为时间精力有限,没有细化的查出每一个函数及表单元素的用法,可是,相关用法能够点击相应文字连接到官方相应说明文档中查找。

moodle中文API之表单API的更多相关文章

  1. Django表单API详解

    声明:以下的Form.表单等术语都指的的广义的Django表单. Form要么是绑定了数据的,要么是未绑定数据的. 如果是绑定的,那么它能够验证数据,并渲染表单及其数据,然后生成HTML表单.如果未绑 ...

  2. 第四章:Django表单 - 2:Django表单API详解

    声明:以下的Form.表单等术语都指的的广义的Django表单. Form要么是绑定了数据的,要么是未绑定数据的. 如果是绑定的,那么它能够验证数据,并渲染表单及其数据,然后生成HTML表单.如果未绑 ...

  3. c# post方式请求java form表单api

    using System; using System.Collections.Generic; using System.Net.Http; namespace ConsoleApplication1 ...

  4. 元数据管理—动态表单设计器在crudapi系统中完整实现

    表单设计 在前面文章中,我们通过一系列案例介绍了表单设计的一些基本功能,表单设计起到非常重要作用,也是crudapi核心,所以本文会详细介绍表单设计中一些其它功能. 概要 表单字段column属性 列 ...

  5. sbadmin表单事件

    Form表单 自定义表单 <from action="" method="'><!---      这里可以用表单组件快速生成表单元素哦        ...

  6. jQuery表单验证组件BootstrapValidator

    github:https://github.com/nghuuphuoc/bootstrapvalidator 参考博客:JS组件系列——Form表单验证神器: BootstrapValidator ...

  7. django Form表单的使用

    Form django表单系统中,所有的表单类都作为django.forms.Form的子类创建,包括ModelForm 关于django的表单系统,主要分两种 基于django.forms.Form ...

  8. AngularJs学习笔记-表单处理

    表单处理 (1)Angular表单API 1.模板式表单,需引入FormsModule 2.响应式表单,需引入ReactiveFormsModule   (2)模板式表单 在Angular中使用for ...

  9. Vue中Form表单验证无法消除验证问题

    iView的表单api给出了一个resetFields方法,用于重置整个表单输入的内容并清除验证提示. 但是有时候需要只消除部分的iview的resetFields方法源码是这样的resetField ...

随机推荐

  1. ORACLE客户端乱码

    sqlplus 打开CMD窗口,出现乱码情况的解决办法 C:\Documents and Settings>set NLS_LANG=american_america.AL32UTF8 C:\D ...

  2. ViewPageAsImage

    var ViewPageAsImage = function(target, label) {  var setting = {   min_height:   4,   min_width:   4 ...

  3. 数学之路-python计算实战(14)-机器视觉-图像增强(直方图均衡化)

    我们来看一个灰度图像,让表示灰度出现的次数,这样图像中灰度为 的像素的出现概率是  是图像中全部的灰度数, 是图像中全部的像素数,  实际上是图像的直方图,归一化到 . 把  作为相应于  的累计概率 ...

  4. Materialized View in Oracle - Concepts and Architecture

    List all of MV inoracle: select owner, query, query_len from dba_mviews See content of aMV: select * ...

  5. 集合简单总结 ArrayList、List、Hashtable、Dictionary

      ============================ 集合综述 ============================== 1.什么是泛型: 泛型就是限制了操作类型,意思如下:       ...

  6. linux工具:ssh---未完

    ssh server_ip 或者 ssh username@server_ip 或者 ssh username@server_name , 再按提示输入密码. ____________________ ...

  7. 如何捕获winform程序全局异常?(续)

    前言 上篇文章我提供了一种方案可以供我们捕获单线程程序中的所有未处理异常.但是如果程序是多线程,那么新增线程出现了异常上个方案就无能为力了.本着方案总比问题多的态度,我再给大家提供一种新的方案,供大家 ...

  8. 如何捕获winform程序全局异常?

    1.在C#中我们如何处理异常? 上面的问题学过C#的问题大家可能都能回答处理,用try-catch-finally具体如下: try { //可能出错的语句 } catch (Exception) { ...

  9. forEach嵌套循环的问题

    程序中: List firstList = ; i<firstList.size(); i++) { List secondListList = request.setAttribute(&qu ...

  10. Qt调用摄像头(截取并保存图片)

    原地址:http://blog.csdn.net/liang19890820/article/details/12782531 Qt如何调用系统摄像设备进行显示.截图.录制?     QCamera: ...