PageRenderTime 43ms CodeModel.GetById 17ms RepoModel.GetById 0ms app.codeStats 0ms

/5.0/guides/event-custom/index.html

https://github.com/kissyteam/kissyteam.github.com
HTML | 209 lines | 199 code | 10 blank | 0 comment | 0 complexity | 2df111d7a060b3cee99e52aac28852ba MD5 | raw file
Possible License(s): Apache-2.0 
    

  1. <!doctype html>
    2. 

  2. <html lang="en">
    3. 

  3. <head>
    4. 

  4. 	<meta charset="UTF-8">
    5. 

  5. 	<meta name="viewport" content="width=device-width,initial-scale=1,user-scale=no">
    6. 

  6. 	<title>Guides - KISSY v5.0 Documentation</title>
    7. 

  7. 	<link rel="shortcut icon" href="/5.0/assets/img/favicon.ico">
    8. 

  8. 	<link rel="stylesheet" type="text/css" href="/5.0/assets/css/base.css">
    9. 

  9. 	<link rel="stylesheet" type="text/css" href="/5.0/assets/css/main.css">
    10. 

  10. 	<link rel="stylesheet" type="text/css" href="/5.0/assets/css/github.css"/>
    11. 

  11. 	<script type="text/javascript" src="http://g.tbcdn.cn/kissy/edge/2014.09.05/seed.js" data-config="{combine:true}"></script>
    12. 

  12. </head>
    13. 

  13. <body>
    14. 

  14. 	<div class="header">
    15. 

  15. 		<div class="inner">
    16. 

  16. 	<div class="toolbar">
    17. 

  17. 		<a href="/5.0">
    18. 

  18. 			<img class="mini-logo" src="/5.0/assets/img/mini-logo.png">
    19. 

  19. 		</a>
    20. 

  20. 		<ul class="nav clearfix">
    21. 

  21. 			<li class="docs">
    22. 

  22. 				<span>
    23. 

  23. 					Docs
    24. 

  24. 					<b class="caret"></b>
    25. 

  25. 				</span>
    26. 

  26. 				<ul>
    27. 

  27. 					<li><a href="/5.0/guides/">Guides</a></li>
    28. 

  28. 					<li><a href="/5.0/api">Api Docs</a></li>
    29. 

  29. 					<li><a href="/5.0/demos">Demos</a></li>
    30. 

  30. 				</ul>
    31. 

  31. 			</li>
    32. 

  32. 			<li class="more">
    33. 

  33. 				<span>
    34. 

  34. 					More
    35. 

  35. 					<b class="caret"></b>
    36. 

  36. 				</span>
    37. 

  37. 				<ul>
    38. 

  38. 					<li><a href="/5.0/more/faq.html">FAQ</a></li>
    39. 

  39. 					<li><a href="http://gallery.kissyui.com/">Gallery</a></li>
    40. 

  40. 					<li><a href="http://blog.kissyui.com/">KISSY Blog</a></li>
    41. 

  41. 					<li><a href="https://github.com/daxingplay/kmc">KMC</a></li>
    42. 

  42. 					<li><a href="https://github.com/minghe/generator-bee/wiki/generator-bee%E4%BD%BF%E7%94%A8%E6%95%99%E7%A8%8B">Generator</a></li>
    43. 

  43. 				</ul>
    44. 

  44. 			</li>
    45. 

  45. 			<li class="split"></li>
    46. 

  46. 			<li class="nav-other"><a href="/5.0/quick-start.html">Quick Start</a></li>
    47. 

  47. 			<li class="nav-other"><a href="https://github.com/kissyteam/kissy">Contribute</a></li>
    48. 

  48. 			<li class="nav-other"><a target="_blank" href="/5.0/kissyup-middle.html">KISSY UP</a></li>
    49. 

  49. 		</ul>
    50. 

  50. 	</div>
    51. 

  51. 	<div class="search">
    52. 

  52. 		<script>
    53. 

  53. 			(function() {
    54. 

  54. 			var cx = '003618533255763067140:5nkycw1pbey';
    55. 

  55. 			var gcse = document.createElement('script');
    56. 

  56. 			gcse.type = 'text/javascript';
    57. 

  57. 			gcse.async = true;
    58. 

  58. 			gcse.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') +
    59. 

  59. 			    '//www.google.com/cse/cse.js?cx=' + cx;
    60. 

  60. 			var s = document.getElementsByTagName('script')[0];
    61. 

  61. 			s.parentNode.insertBefore(gcse, s);
    62. 

  62. 			})();
    63. 

  63. 		</script>
    64. 

  64. 		<gcse:search></gcse:search>
    65. 

  65. 	</div>
    66. 

  66. </div>
    67. 

  67. 	</div>
    68. 

  68. 	<div class="main">
    69. 

  69. 		<div class="guide">
    70. 

  70. 			<div class="logo-on-top clearfix">
    71. 

  71. 				<img src="/5.0/assets/img/logo-on-top.png">
    72. 

  72. 			</div>
    73. 

  73. 			<div class="inner clearfix">
    74. 

  74. 				<div id="sidebar">
    75. 

  75. 					<a class="link-apidocs btn btn-primary" href="../../api/classes/CustomEvent.html">API Docs</a>
    76. 

  76. 					<div class="panel panel-primary">
    77. 

  77. 						<div class="panel-heading">
    78. 

  78. 							<h3 class="panel-title">Outline</h3>
    79. 

  79. 						</div>
    80. 

  80. 						<div class="panel-body">
    81. 

  81. 							<ul class="outline">
    82. 

  82. 								<li class="level2"><a href="#简单引用">简单引用</a></li><li class="level2"><a href="#自定义事件简单示例">自定义事件简单示例</a></li><li class="level2"><a href="#继承Base的类成员可以自定义事件">继承Base的类成员可以自定义事件</a></li>
    83. 

  83. 							</ul>
    84. 

  84. 						</div>
    85. 

  85. 					</div>
    86. 

  86. 					<div class="panel panel-primary ajax-load ">
    87. 

  87. 						<div class="panel-heading">
    88. 

  88. 							<h3 class="panel-title">Features</h3>
    89. 

  89. 						</div>
    90. 

  90. 						<div class="panel-body">
    91. 

  91. 							<p><a href="../../guides/event-custom/index.html">event-custom 模块基本介绍</a></p>
    92. 

  92. 						</div>
    93. 

  93. 					</div>
    94. 

  94. 					<div class="panel panel-primary ajax-load hide">
    95. 

  95. 						<div class="panel-heading">
    96. 

  96. 							<h3 class="panel-title">Demos</h3>
    97. 

  97. 						</div>
    98. 

  98. 						<div class="panel-body">
    99. 

  99. 							
    100. 

  100. 						</div>
    101. 

  101. 					</div>
    102. 

  102. 				</div>
    103. 

  103. 				<div id="main-content">
    104. 

  104. 					<p></p>
    105. 

  105. <h1 id="event-custom 模块基本介绍">event-custom 模块基本介绍</h1><p>event-custom 模块事先自定义事件功能，只要将 CustomEvent.Target 混合（Util.mix 或 Util.augment）进想要自定义事件的对象，那么这个对象就可以进行自定义事件了。</p>
    106. 

  106. <h2 id="简单引用">简单引用</h2><pre><code><span class="hljs-built_in">require</span>([<span class="hljs-string">'event-custom'</span>], <span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">(CustomEvent)</span></span>{
    107. 

  107.     <span class="hljs-comment">//use CustomEvent...</span>
    108. 

  108. })
    109. 

  109. </code></pre><h2 id="自定义事件简单示例">自定义事件简单示例</h2><pre><code><span class="hljs-built_in">require</span>([<span class="hljs-string">'util'</span>, <span class="hljs-string">'event-custom'</span>], <span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">(Util, CustomEvent)</span></span>{
    110. 

  110.     <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">Dog</span><span class="hljs-params">(name)</span></span>{
    111. 

  111.         <span class="hljs-keyword">this</span>.name = name;
    112. 

  112.     }
    113. 

  113.     Util.augment(Dog, CustomEvent.Target, {
    114. 

  114.         shout : <span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">()</span></span>{
    115. 

  115.             <span class="hljs-keyword">this</span>.fire(<span class="hljs-string">'shout'</span>,{
    116. 

  116.                 content : <span class="hljs-string">'I am hungry...'</span>
    117. 

  117.             });
    118. 

  118.         }
    119. 

  119.     });
    120. 

  120.     <span class="hljs-keyword">var</span> myDog = <span class="hljs-keyword">new</span> Dog(<span class="hljs-string">'cuteDog'</span>);
    121. 

  121.     myDog.on(<span class="hljs-string">'shout'</span>, <span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">(ev)</span></span>{
    122. 

  122.         alert(<span class="hljs-keyword">this</span>.name + <span class="hljs-string">'say that '</span> + ev.conent);
    123. 

  123.     });
    124. 

  124. 

  125.     myDog.shout();
    126. 

  126. })
    127. 

  127. </code></pre><h2 id="继承Base的类成员可以自定义事件">继承Base的类成员可以自定义事件</h2><p>事件本身是一个抽象概念，和平台无关、和设备无关、更和浏览器无关，浏览器只是使用“事件”的方法来触发特定的行为，进而触发某段网页逻辑。而常见的DOM事件诸如click,dbclick是浏览器帮我们实现的“特定行为”。而这里的“特定行为”就是触发事件的时机，是可以被重新定义的，原理上，事件都是需要精确的定义的，比如下面这个例子，我们定义了一个新事件：“初始化1秒后”</p>
    128. 

  128. <p>这里我们使用Base内嵌的事件对象来描述</p>
    129. 

  129. <pre><code><span class="hljs-comment">// 为了便于理解，这里用 define 写成模块将代码隔离开</span>
    130. 

  130. 

  131. <span class="hljs-comment">// 实现Klass内部的自定义事件</span>
    132. 

  132. define(<span class="hljs-string">'klass'</span>,<span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">(Base)</span></span>{
    133. 

  133.     <span class="hljs-comment">// Klass 是一个类，它在被实例化后1秒会触发一个事件"afterOneSecond"</span>
    134. 

  134.     <span class="hljs-keyword">var</span> Klass = Base.extend({
    135. 

  135.         initializer:<span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">()</span></span>{
    136. 

  136.             <span class="hljs-keyword">var</span> <span class="hljs-keyword">self</span> = this;
    137. 

  137. 

  138.             <span class="hljs-comment">// Your Code</span>
    139. 

  139.             setTimeout(<span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">()</span></span>{
    140. 

  140.                 <span class="hljs-keyword">self</span>.fire(<span class="hljs-string">'afterOneSecond'</span>,{
    141. 

  141.                     a:<span class="hljs-number">1</span>,b:<span class="hljs-number">2</span> <span class="hljs-comment">//挂两个回调属性</span>
    142. 

  142.                 });
    143. 

  143.             },<span class="hljs-number">1000</span>);
    144. 

  144.         }
    145. 

  145.     },{<span class="hljs-comment">/*ATTRS*/</span>});
    146. 

  146. 

  147.     <span class="hljs-keyword">return</span> Klass;
    148. 

  148. },{
    149. 

  149.     requires:[<span class="hljs-string">'base'</span>]    
    150. 

  150. });
    151. 

  151. 

  152. <span class="hljs-comment">// 绑定自定义事件</span>
    153. 

  153. <span class="hljs-keyword">require</span>(<span class="hljs-string">'klass'</span>,<span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">(S,Klass)</span></span>{
    154. 

  154.     <span class="hljs-comment">// 初始化这个类</span>
    155. 

  155.     <span class="hljs-keyword">var</span> k = <span class="hljs-keyword">new</span> Klass();
    156. 

  156. 

  157.     <span class="hljs-comment">// 绑定事件监听</span>
    158. 

  158.     k.on(<span class="hljs-string">'afterOneSecond'</span>,<span class="hljs-function"><span class="hljs-keyword">function</span><span class="hljs-params">(e)</span></span>{
    159. 

  159.         alert(<span class="hljs-string">'1秒后触发这里的逻辑'</span>);
    160. 

  160.         <span class="hljs-comment">// e.a === 1</span>
    161. 

  161.         <span class="hljs-comment">// e.b === 1</span>
    162. 

  162.     });
    163. 

  163. });
    164. 

  164. </code></pre><p>这是一个很纯粹的自定义事件（Base组件内置自定义事件机制），它有事件名称“afterOneSecond”，有事件的触发条件<code>self.fire(&#39;afterOneSecond&#39;)</code>，有事件的绑定，<code>k.on(&#39;afterOneSecond&#39;)</code>。这样这个事件就能顺利的发生，并被成功监听。在代码组织层面，一般<code>Klass</code>类中实现了事件命名、定义和实现，属于内聚的功能实现。而绑定事件时可以是Klass这段代码的用户，他不会去关心事件的具体实现，只要关心Klass&quot;暴露了什么事件可以让我绑定&quot;就可以了，这就是KISSY中使用自定义事件的用法。你可以通过Base来创建自定义事件。</p>
    165. 

  165. 

  166. 				</div>
    167. 

  167. 			</div>
    168. 

  168. 		</div>
    169. 

  169. 	</div>
    170. 

  170. 	<div class="footer">
    171. 

  171. 		<div class="wrap-disqus">
    172. 

  172.     <div class="top-repeat"></div>
    173. 

  173. 	<div id="disqus_thread"></div>
    174. 

  174. </div>
    175. 

  175. <script>
    176. 

  176.     if((window.location.hostname.indexOf("kissyui.com")!=-1 )&& window.localStorage.getItem("kissy-commment")!="0"){
    177. 

  177.     /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
    178. 

  178.     var disqus_shortname = 'kissy-docs'; // required: replace example with your forum shortname
    179. 

  179. 

  180.     // The following are highly recommended additional parameters. Remove the slashes in front to use.
    181. 

  181.      //var disqus_identifier = '/anim';
    182. 

  182.      //var disqus_url = window.location;
    183. 

  183. 

  184.     /* * * DON'T EDIT BELOW THIS LINE * * */
    185. 

  185.     (function() {
    186. 

  186.         var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
    187. 

  187.         dsq.src = 'http://' + disqus_shortname + '.disqus.com/embed.js';
    188. 

  188.         (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
    189. 

  189.     })();
    190. 

  190.     }
    191. 

  191. </script>
    192. 

  192. <div class="other-page">
    193. 

  193.     <div class="wrap">
    194. 

  194.         <div class="content">
    195. 

  195.             <div class="wrap-content">
    196. 

  196.                 <p>@2010 - 2112 KISSY UI LIBARAY</p>
    197. 

  197.                 <div class="github-msg">
    198. 

  198.                     <iframe src="http://ghbtns.com/github-btn.html?user=kissyteam&repo=kissy&type=watch&count=true"
    199. 

  199. allowtransparency="true" frameborder="0" scrolling="0" width="100" height="20"></iframe>
    200. 

  200.                     <iframe src="http://ghbtns.com/github-btn.html?user=kissyteam&repo=kissy&type=fork&count=true"
    201. 

  201. allowtransparency="true" frameborder="0" scrolling="0" width="100" height="20"></iframe>
    202. 

  202.                 </div>
    203. 

  203.             </div>
    204. 

  204.         </div>
    205. 

  205.     </div>
    206. 

  206. </div>
    207. 

  207. 	</div>
    208. 

  208. </body>
    209. 

  209. </html>
    210.