组件与表单

Wb.getValue(components, itemIds, getFileName);

var jsonObject1 = Wb.getValue(app.window1); //获取window1下所有控件的值组成的对象
var jsonObject2 = Wb.getValue([text1, date1]); //获取text1和date1的值组成的对象

    /**
     * 获取指定控件及其所包含控件的值组成的对象，对象中每个值的名称为指定控件的itemId。
     * 如果控件下存在重复itemId的控件，则只返回第一个控件值，其余重名的控件将被忽略。
     * Example:
     *
     *     var jsonObject1 = Wb.getValue(app.window1); //获取window1下所有控件的值组成的对象
     *     var jsonObject2 = Wb.getValue([text1, date1]); //获取text1和date1的值组成的对象
     *
     * @param {Component/Component[]} components 需要获取值的组件对象或组件对象列表。
     * @param {String/String[]} [itemIds] 需要获取值的组件itemId名称或名称列表，如果值为空则返回所有控件的值。
     * @param {Boolean} [getFileName] 是否获取文件控件的文件名称，默认为false。
     * @return {Object} 获取的控件值组成的对象。
     */

Wb.getAgValue(components, itemIds, getFileName);

var jsonObject1 = Wb.getValue(app.window1); //获取window1下所有控件的值组成的对象
var jsonObject2 = Wb.getValue([text1, date1]); //获取text1和date1的值组成的对象

    /**
     * 获取指定控件及其所包含控件的值组成的对象，对象中每个值的名称为指定控件的itemId。
     * 如果控件下存在重复itemId的控件，则只返回第一个控件值，其余重名的控件将被忽略。
     * Example:
     *
     *     var jsonObject1 = Wb.getValue(app.window1); //获取window1下所有控件的值组成的对象
     *     var jsonObject2 = Wb.getValue([text1, date1]); //获取text1和date1的值组成的对象
     *
     * @param {Component/Component[]} components 需要获取值的组件对象或组件对象列表。
     * @param {String/String[]} [itemIds] 需要获取值的组件itemId名称或名称列表，如果值为空则返回所有控件的值。
     * @param {Boolean} [getFileName] 是否获取文件控件的文件名称，默认为false。
     * @return {Object} 获取的控件值组成的对象。
     */

Wb.getVal(component, itemId);

var dateValue = Wb.getVal(window1, 'date1'); //获取window1下itemId为date1的控件日期值

    /**
     * 获取某个控件下第一个指定itemId控件的值。
     *
     * Example:
     *
     *     var dateValue = Wb.getVal(window1, 'date1'); //获取window1下itemId为date1的控件日期值
     *
     * @param {Component/Component[]} component 需要获取值的组件对象或组件对象列表。
     * @param {String} [itemId] 需要返回值的控件itemId名称，如果缺省该值则返回component[0]指定的值。
     * @return {Object} 获取的指定控件的值。
     */

Wb.setValue(components, values);

Wb.setValue(window1,{text1: 'foo', date1: new Date()});

    /**
     * 对指定控件下的一组控件进行赋值，其值由values对象指定，values中的每一子项的名称为控件的itemId，值为控件值。
     *
     * Example:
     *
     *     Wb.setValue(window1,{text1: 'foo', date1: new Date()});
     *
     * @param {Component/Component[]} components 顶层控件对象列表，只有在指定控件下的控件值才被设置。
     * @param {Object} values 包含一组控件itemId和值组成的Object对象。
     */

Wb.setVal(component, itemId, value);

Wb.setVal(window1,'date1', new Date()); //设置window1下itemId为date1的控件值为new Date()

    /**
     * 设置某个控件下指定itemId控件的值。
     *
     * Example:
     *
     *     Wb.setVal(window1,'date1', new Date()); //设置window1下itemId为date1的控件值为new Date()
     *
     * @param {Component/Component[]} component 顶层控件对象，只有在指定控件下的控件值才被设置。
     * @param {String} itemId 需要设置值的控件itemId名称。
     * @param {Object} value 需要设置的值。
     */

Wb.resetScroll(component);

Wb.resetScroll(app.component);

    /**
     * 重置指定控件的滚动条指顶部。仅用于touch模式。
     * @param {Component} component 需要重置的组件对象。
     */

Wb.reset(components, itemIds);

Wb.reset(
  app.components,
  /* itemIds */ undefined
);

    /**
     * 重置指定控件及其所包含控件的值。
     * @param {Component/Component[]} components 需要重置值的组件对象或组件对象列表。
     * @param {String/String[]} itemIds 需要重置值的组件itemId名称或名称列表，如果值为null则重置所有控件的值。
     */

Wb.getRefer(components, object);

var refer = Wb.getRefer(viewport1);
Wb.info(refer.text1.getValue()); // refer.text1指向viewport1下的text1控件

    /**
     * 获取指定容器及其下每一个具有itemId属性的组件的实例引用组成的对象。
     *
     * Example:
     *
     *     var refer = Wb.getRefer(viewport1);
     *     Wb.info(refer.text1.getValue()); // refer.text1指向viewport1下的text1控件
     *
     * @param {Component/Component[]} components 需要获取引用的顶层容器控件列表。
     * @param {Object} [object] 被添加引用的对象，实例的引用将被添加到该对象。如果名称已经存在，
     * 那么之前的引用将被覆盖。如果缺少该值，系统将创建新的对象来存放引用。
     * @return {Object} 包含引用的对象。
     */

Wb.highlight(comp, warning);

Wb.highlight(
  app.comp,
  true
);

    /**
     * 对指定组件进行高亮操作。如果未指定warning则采用默认高亮方案，否则采用红色渐变1.5秒。
     * @param {Element/Node} comp 需要高亮的元素。
     * @param {Boolean} [warning] 是否采用警告的高亮方案。
     */

Wb.verifyGrid(object);

Wb.verifyGrid(app.object);

    /**
     * 验证可编辑表格数据是否合法。如果非法，系统将把焦点转到第一个非法的单元格。
     * @param {Ext.grid.Panel/Ext.data.Store} object 表格或store对象。
     * @return {Boolean} true合法，false不合法。
     */

Wb.verify(components);

if(Wb.verify(window1))
  alert('window1下所有控件的值合法。');

    /**
     * 对指定的控件及其子控件值的合法性进行校验。当存在非法值时，系统将对控件进行标记，
     * 并把焦点转到第一个存在非法值的控件上。
     *
     * Example:
     *
     *     if(Wb.verify(window1))
     *       alert('window1下所有控件的值合法。');
     *
     * @param {Component/Component[]} components 需要验证的控件。
     * @return {Boolean} 如果验证的所有控件的值合法，返回true，否则返加false。
     */

Wb.isHidden(comp);

if (!Wb.isHidden(app.customerName)) {
  app.customerName.validate();
}

/**
 * 源码未提供 JSDoc。
 */

Wb.quoteRegexp(regexp);

Wb.quoteRegexp(/* regexp */ undefined);

    /**
     * 引用正则表达式，把正则表达式转换为普通的字符串。
     * @param {RegExp} regexp 正则表达式。
     * @return {String} 正则表达式各个字符对应的普通字符串。
     */

Wb.isValue(value);

Wb.isValue(/* value */ undefined);

    /**
     * 判断值是否为不是null和undefined的值。
     * @param {Object} value 任意值。
     * @return {String} 如果值为null或undefined则返回false，否则返回true。
     */

Wb.getDefined();

Wb.getDefined();

    /**
     * 获取参数列表中首个不等于undefined的值。
     * @return {Object} 首个不等于undefined的值或undefined。
     */

Wb.findEditing(object);

Wb.findEditing(app.object);

    /**
     * 查找表格中包含的编辑插件。如果找到则返回该插件，否则返回null。
     * @param {Ext.grid.Panel/Ext.data.Store} object 表格或store对象。
     * @return {Editing} 编辑插件或null。
     */

Wb.remove(component, items, doSelect);

Wb.remove(grid1); //删除grid1中选择的记录

    /**
     * 删除表格中的记录、树的节点或指定的控件。如果删除的对象为表格或树，则在删除后将自动选中被删除记录的最近记录。
     * 1component为树，删除树节点；2compnent为表格，删除表格记录；3component为树节点数据，删除数组中的所有节点；
     * 4component为树节点数组,删除数组中的节点；5component为其他数组，删除数组中值为items的元素。
     *
     * Example:
     *
     *     Wb.remove(grid1); //删除grid1中选择的记录
     *
     * @param {Component} component 需要删除子项的对象。
     * @param {Array} [items] 需要删除的子项条目列表。如果删除对象为表格或树，缺省该值时将删除选中的表格记录或树节点。
     * 如果删除树节点且指定该项值，节点须按深度进行逆向排序（因为删除上级节点后无法删除下级节点），见{@link #reverse}。
     * @param {Boolean} [doSelect] 删除后是否选择下一个节点/记录，默认为true。
     */

Wb.setModified(panel);

Wb.setModified(app.panel);

    /**
     * 设置面板的状态为被更改，设置被更改状态将在面板的标题前加“*”符，并添加isModified属性为true。
     * @param {Panel} panel 面板对象。
     * @return {Panel} panel 本身。
     */

Wb.unModified(panel);

Wb.unModified(app.panel);

    /**
     * 设置面板的状态为未更改，设置未更改状态将移除面板的标题前置“*”符，并设置isModified属性为false。
     * @param {Panel} panel 面板对象。
     * @return {Panel} panel 本身。
     */

Wb.setTitle(panel, subTitle);

Wb.setTitle(
  app.panel,
  /* subTitle */ undefined
);

    /**
     * 设置面板的子标题，子标题将以“标题 - 子标题”的形式显示在面板标题上。
     * @param {Panel} panel 面板对象。
     * @param {String} subTitle 子标题。
     * @return {Panel} 面板本身。
     */

Wb.parseBool(value, defaultValue);

Wb.parseBool(
  /* value */ undefined,
  /* defaultValue */ undefined
);

    /**
     * 把值解析为布尔型。如果值为false, 'false', 0, '0', null, undefined和空串返回false，其他值返回true。
     * 如果指定默认值，则当值为null或undefined时返回此默认值。
     * @param {Object} value 需要解析的值。
     * @return {Boolean} 解析后的布尔值。
     */

Wb.getBool(value, defaultValue);

Wb.getBool(
  /* value */ undefined,
  /* defaultValue */ undefined
);

    /**
     * 判定指定值语义是否为真。如果值为undefined，则返回默认值。
     * @param {Mixed} value 需要判断的值。
     * @param {Mixed} [defaultValue] 默认值，默认为false。
     * @return {Boolean} true为真，false为假。
     */

Wb.reload(component, object, params);

Wb.reload(
  app.component,
  app.object,
  { /* 参数或数据 */ }
);

    /**
     * 重新加载树或表格。树：加载完成后重新选择最后选择的节点。表格或Ext.data.Store：不同于store.reload，使用该方法会叠加params指定参数。
     * @param {GridPanel/TreePanel/Store} component 表格、树或其绑定的Store对象。
     * @param {Function/Object} [object] 树：加载完成后执行的回调函数。表格：参数对象，同store.reload的options参数。
     * @param {Object} [params] 树：可选的参数对象。
     * @param {Object} [params.field] 刷新树时保存路径使用的字段名称，默认为displayField。
     * @param {Object} [params.separator] 刷新树时保存路径使用的分隔符，默认为'\n'。
     */

Wb.verifyName(name);

Wb.verifyName("示例值");

    /**
     * 验证名称的合法性。
     * @param {String} name 需要被验证的字符串对象。
     * @return {Boolean} 如果名称由字母、下划线和数字构成且第一个字母不为数字则返回true，否则返回false。
     */

Wb.verifyFile(name);

Wb.verifyFile("示例值");

    /**
     * 验证文件名称的合法性。
     * @param {String} name 需要被验证的文件名称。
     * @return {Boolean} 如果名称是一个有效的文件名称则返回true，否则返回false。
     */

Wb.htmlRender(v);

var safeHtml = Wb.htmlRender("<span>文本</span>");

/**
 * 源码未提供 JSDoc。
 */

Wb.getDoc(iframe);

Wb.getDoc(app.iframe);

    /**
     * 获取iframe的文档对象。
     * @param {Iframe} iframe Iframe对象。
     * @return {Document} Iframe的document对象，如果获取过程发生异常将返回null。
     */

Wb.relayEvent(event);

Wb.relayEvent(/* event */ undefined);

    /**
     * 把Iframe中的事件传递到父窗口。
     */

Wb.insertIframe(owner, useMask);

Wb.insertIframe(
  app.owner,
  true
);

    /**
     * 在指定的控件中插入iframe，插入的iframe具有自动显示加载进度，自动释放资源，并管理全局点击事件的功能。
     * 管理全局点击事件是指iframe和其上层窗体之间的点击事件管理，比如当上层窗口显示菜单时，点击iframe能隐藏上层窗口的菜单。
     * 插入的iframe提供submit(url, params, method)方法，用于向指定url提交参数并显示在iframe中，示例：<br>
     * owner.iframe.submit('m?xwl=name', {p1: 'foo', p2: 'bar'}); //POST方法<br>
     * owner.iframe.submit('m', {xwl:'name', p1: 'foo', p2: 'bar'}, 'GET');//GET方法<br>
     * @param {Component} owner 需要被插入iframe的控件。
     * @param {Component} useMask 指定在加载过程中是否需要使用mask，默认为true。
     * @return {Element} 插入的iframe Element，也可通过owner.iframe获取iframe element。
     * 如果要获取dom，可通过iframe.dom获取iframe dom。
     */