JavaScript 前端框架(封装库) BETA 5.0 已于10月10日正式发布，今天开始提供 BETA 5.0 的 API 参考文献。相较于之前 5 个版本的发布都是草草的提供源代码，并没有很多人参与进来，而且各大博客对源代码的处理也不是很感冒，导致发表的文章很大程度上并没有人知道。所以从此次开始，今后每次发布新版本都会提供相应的 API 手册，目的就是要让大家都能够参与其中，了解与使用框架。简化大家在平时开发中的步骤，提高产出效率，这也是我的目标。
参考文档分为 5 大部分，分别为：1.主方法文档、2.库方法文档、3.插件库文档、工具库文档、嗅探器文档。由于内容体系庞大，并没有一次性全部更新完毕，目前只更新了主方法文档，其他文档会在数日内悉数补完，请大家保持关注。目前的主方法已经能够完成几乎所有的基础功能，大家在对照文档的时候如果有任何的困惑或者不解，请及时的留言，我会在第一时间回复。
关于 BETA 5.0 的索取，请大家移至我的个人官网进行下载，且提供其他历代版本的源码下载和在线的实例演示，让大家更加直观的了解到，框架每次更新了哪些内容，目前能做到什么样的程度。
BETA 5.0 力求全面兼容 W3C 主流浏览器与 IE6/7/8，但 IE 6/7/8 仍然会有些许隐晦的 BUG 所以大家在使用的过程中，如果发现了任何 BUG 也请第一时间给我留言，我会在今后的版本中尽全力将其修正！
目前合作的媒介有：CNBlogs、51CTO、ITeye、CSDN等 4 大网博平台，希望大家积极的参与其中，有任何问题请留言！
我的个人官网地址：http://www.shibuyi.net/
BETA 5.0 在线实例演示地址：http://www.shibuyi.net/demo/javascript/beta_5.0/
JavaScript 封装库 BETA 5.0：主方法 API 参考文档
|
API 名称 |
参数 | 说明 | 示例 |
|
1. $(positionerList) |
positionerList 选填[对象、字符串、方法] | 构造方法 | $(‘#id‘, ‘.class‘, ‘@name‘,document) |
| 2. $().selector(positioner) | positioner 必填[字符串] | 元素定位选择器 | $().selector(‘div#id‘) |
| 3. $().getId(ids, positioner) | ids 必填[字符串]，positioner 选填[字符串、对象] | 获取 id 元素节点 | $().getId(‘id‘, document.body) |
| 4. $().getTagName(tagName, positioner) | tagName 必填[字符串]，positioner 选填[字符串、对象] | 获取 tag 元素节点 | $().getTagName(‘div‘, ‘#id‘) |
| 5. $().getClass(className, positioner) | className 必填[字符串]，positioner 选填[字符串、对象] | 获取 class 元素节点 | $().getClass(‘class‘, ‘[email protected]‘) |
| 6. $().getName(name, positioner) | name 必填[字符串]，positioner 选填[字符串、对象] | 获取 name 元素节点 | $().getName(‘name‘, ‘span.class‘) |
| 7. $().getNodes() | 无 | 输出所有元素节点 | $(‘#id‘, ‘.class‘, ‘@fm‘).getNodes() |
| 8. $().firstNode() | 无 | 获取首位元素节点 | $(‘div.class‘).firstNode() |
| 9. $().getFirstNode() | 无 | 输出首位元素节点 | $(‘div.class‘).getFirstNode() |
| 10. $().lastNode() | 无 | 获取末位元素节点 | $(‘span.class‘).lastNode() |
| 11. $().getLastNode() | 无 | 输出末位元素节点 | $(‘span.class‘).getLastNode() |
| 12. $().indexNode(index) | index 必填[正整数] | 获取索引元素节点 | $(‘div‘).indexNode(5) |
| 13. $().getIndexNode(index) | index 必填[正整数] | 输出索引元素节点 | $(‘[email protected]‘).indexNode(0) |
| 14. $().firstChild() | 无 | 获取首位子元素节点 | $(document.body).firstChild() |
| 15. $().getFirstChild() | 无 | 输出首位子元素节点 | $(document.body).getFirstChild() |
| 16. $().lastChild() | 无 | 获取末位子元素节点 | $(‘[email protected]‘).lastChild() |
| 17. $().getLastChild() | 无 | 输出末位子元素节点 | $(‘[email protected]‘).getLastChild() |
| 18. $().allChild() | 无 | 获取所有子元素节点 | $(‘span#id‘).allChild() |
| 19. $().getAllChild() | 无 | 输出所有子元素节点 | $(‘span#id‘).getAllChild() |
| 20. $().parentNode() | 无 | 获取父级元素节点 | $(‘#id‘).parentNode() |
| 21. $().getParentNode() | 无 | 输出父级元素节点 | $(‘#id‘).getParentNode() |
| 22. $().previousNode() | 无 | 获取前位兄弟节点 | $(‘[email protected]‘).previousNode() |
| 23. $().getPreviousNode() | 无 | 输出前位兄弟节点 | $(‘[email protected]‘).getPreviousNode() |
| 24. $().nextNode() | 无 | 获取后位兄弟节点 | $(‘div#id‘).nextNode() |
| 25. $().getNextNode() | 无 | 输出后位兄弟节点 | $(‘div#id‘).getNextNode() |
| 26. $().bothNode() | 无 | 获取前后位兄弟节点 | $(‘#id‘).bothNode() |
| 27. $().getBothNode() | 无 | 输出前后位兄弟节点 | $(‘#id‘).getBothNode() |
| 28. $().allPrevious() | 无 | 获取所有前位兄弟节点 | $(‘#id‘).allPrevious() |
| 29. $().getAllPrevious() | 无 | 输出所有前位兄弟节点 | $(‘#id‘).getAllPrevious() |
| 30. $().allNext() | 无 | 获取所有后位兄弟节点 | $(‘#id‘).allNext() |
| 31. $().getAllNext() | 无 | 输出所有后位兄弟节点 | $(‘#id‘).getAllNext() |
| 32. $().allBoth() | 无 | 获取所有兄弟节点 | $(‘#id‘).allBoth() |
| 33. $().getAllBoth() | 无 | 输出所有兄弟节点 | $(‘#id‘).getAllBoth() |
| 34. $().html(string) | string 选填[字符串] | 获取与设置元素节点内容(含HTML) | $(‘#id‘).html(‘文本‘) |
| 35. $().text(string) | string 选填[字符串] | 获取与设置元素节点文本 | $(‘#id‘).text(‘纯文本‘) |
| 36. $().value(string) | string 选填[字符串] | 获取与设置表单元素内容 | $(‘#id‘).value(‘表单值‘) |
| 37. $().defaultValue(string) | string 选填[字符串] | 获取与设置表单元素默认内容 | $(‘#id‘).defaultValue() |
| 38. $().css(cssList) | cssList 选填[字符串] | 获取与设置 css 样式 | $(‘#id‘).css(‘color:#333;‘, ‘background:red;‘) |
| 39. $().addRule(ruleList, rulePosition, sheetIndex) | ruleList 必填[数组]，rulePosition 选填[正整数]，sheetIndex 选填[正整数] | 添加 css 样式规则 | $().addRule([‘#box {color:red;}‘], 0, 0) |
| 40. $().removeRule(namePosition, sheetIndex) | namePosition 必填[字符串、正整数]，sheetIndex 选填[正整数] | 移除 css 样式规则 | $().removeRule(‘#box‘, 0, 0) |
| 41. $().bind(eventName, method, mode) | eventName 必填[字符串]，method 必填[方法]，mode 选填[布尔值] | 元素事件绑定 | $(document).bind(‘click‘, function () {}, true) |
| 42. $().loaded(method) | method 必填[方法] | HTML DOM 加载 | $().loaded(function () {}) |
| 43. $().getInfo(sizePosition) | sizePosition 选填[字符串] | 获取元素尺寸与方位信息 | $(‘#id‘).getInfo(‘width‘) |
| 44. $().scroll(x, y) | x 选填[正整数]，y 选填[正整数] | 获取与设置滚动条 | $().scroll(0, 0) |
| 45. $().addClass(classList) | classList 必填[数组、字符串] | 添加 class 选择器 | $(‘#id‘).addClass(‘a‘, ‘b‘, ‘c‘) |
| 46. $().removeClass(classList) | classList 必填[数组、字符串] | 移除 class 选择器 | $(‘#id‘).removeClass(‘a‘, ‘b‘, ‘c‘) |
| 47. $().add(elementName, attributes, html) | elementName 必填[字符串]，attributes 选填[数组、字符串]，html 选填[字符串] | 添加元素节点 | $().add(‘div‘, ‘id=box‘, ‘新元素‘) |
| 48. $().remove() | 无 | 删除元素节点 | $(‘div‘).remove() |
| 49. $().move(targetElement, mode) | targetElement 必填[对象、字符串]，mode 选填[布尔值] | 剪切与复制元素节点 | $(‘#id‘).move(‘span.class‘, false) |
| 50. $().getLength() | 无 | 获取元素总个数 | $(‘div‘).getLength() |
| 51. $().formAll() | 无 | 获取所有表单元素 | $().formAll() |
| 52. $().form(index) | index 必填[字符串、正整数] | 获取指定表单元素 | $().form(‘fm‘) |
| 53. $().formChildAll() | 无 | 获取所有表单子元素 | $(‘@fm‘).formChildAll() |
| 54. $().formChild(index) | index 必填[字符串、正整数] | 获取指定表单子元素 | $(‘@fm‘).formChild(‘username‘) |
| 55. $().addOption(optionText, optionValue, selected) | optionText 必填[字符串]，optionValue 选填[字符串]，selected 选填[布尔值] | 新增 Option 元素 | $(‘@select‘).addOption(‘内容‘) |
| 56. $().removeOption(index) | index 必填[正整数] | 移除 Option 元素 | $(‘@select‘).removeOption(0) |
| 57. $().keepOption(length) | length 必填[正整数] | 指定需保留的 Option 元素个数 | $(‘@select‘).keepOption(1) |
| 58. $().optionAll() | 无 | 获取所有 Option 元素 | $(‘@select‘).optionAll() |
| 59. $().plugins(methodList) | methodList 必填[方法] | 自动加载插件 | $().plugins(methodName1, methodName2, methodName3) |
未完待续，请保持关注！
时间： 2024-10-22 01:17:22