Discuz common.js代码注释(四)

/**
* 将一些预定义的字符转换为 HTML 实体
* & （和号） 成为 &
* " （双引号） 成为 "
* ' （单引号） 成为 '
* < （小于） 成为 <
*  > （大于） 成为 >
*/
function htmlspecialchars(str) {
    return preg_replace(['&', '<', '>', '"'], ['&', '<', '>', '"'], str);
}
/**
* 判断指定的id对象是否隐藏
*/
function display(id) {
    var obj = $(id);//获取指定的id文档对象
    if (obj.style.visibility) { //判断获取到的对象元素控件的style的visibility属性
        //判断该元素控件是否可见，如果style.visibility="visible"时控件可见，如果style.visibility="hidden"时控件不可见，如果属性值为空则为visible可见
        obj.style.visibility = obj.style.visibility == 'visible' ? 'hidden' : 'visible'; 
    } else {
        obj.style.display = obj.style.display == '' ? 'none' : ''; //否则判断元素控件是都为空，为空则不赋值，如果为style.display="none"控件不显示
    }
}

/**
* 设置或取消全选功能
* form 表单
* prefix 前缀
* checkall 全选
*/
function checkall(form, prefix, checkall) {
    var checkall = checkall ? checkall : 'chkall'; //判断是否为空，如果为空就赋值chkall,否则就赋值checkall
    count = 0;  //声明选中数
    for (var i = 0; i < form.elements.length; i++) {  //循环所有表单元素
        var e = form.elements[i]; //获得表单第i个元素
        if (e.name && e.name != checkall && !e.disabled && (!prefix || (prefix && e.name.match(prefix)))) { //disabled 编辑状态
            e.checked = form.elements[checkall].checked; //获取表单元素的选中状态
            if (e.checked) { //判断表单元素状态
                count++;  //统计选中数
            }
        }
    }
    return count; //返回已选总数
}