MediaWiki扩展：内容折叠隐藏

wangsisi

<showhide> 部分不需要隐藏的文本（通常为标题） __HIDER__ <hide>隐现文本内容</hide> </showhide>

这个折叠隐藏扩展可以制作通过开关进行显示/隐藏的内容元素，表现方式如同表格。

本扩展的创意来自Avala因创建了一系列非对其的国家列表（类似于NATO列表）而受到的指责。一方面，这种列表非常合理，但另一方面又完全不常用。本扩展使得这种列表合理化。

本扩展可以在ShowHide Wikimedia SCG的crash wiki看到实地应用。由于并非mediawiki的内置功能，所以其他wiki网站并不一定能见到本功能；你可以访问测试页面来观察实际例子，以了解和测试其工作表现。

注意，本扩展并未经过深入的测试，并可能存有小错误。目前，它正在Veggie Van Gogh wiki站点上使用。

在Mediawiki中增加本特性的请求参见bug #1257.

语法

本扩展的语法如下：

1. 
   
2. <showhide>
   
3. 部分不需要隐藏的文本（通常为标题） __HIDER__
   
4. <hide>隐现文本内容</hide>
   
5. </showhide>
   

复制代码

__HIDER__ 是放置隐现开关链接的地方。用户通过点击隐现开关，可显示/隐藏位于<hide></hide>标签之间的内容。 在上面的例子里，可被隐现的内容是“隐现文本内容”,

如果使用<show></show>标签，隐现文本内容将默认处于显示状态，通过点击隐现开关可以把它折叠隐藏起来。

源代码

v 0.1

当忘记html_entity_decode()以及 $wgOut->addHTML()，而仅仅把JS粘贴到$out时，有时可能不能正常工作（在PHP 5.x下测试） --Smerf

请注意，这个扩展有违反XHTML 1.0 Transitional兼容性的地方!! --Smerf

1. <?php
   
2. # WikiMedia ShowHide extension v0.1
   
3. #
   
4. # Based on example code from
   
5. # http://meta.wikimedia.org/wiki/Write_your_own_MediaWiki_extension
   
6. # Contains code from MediaWiki's Skin.php and wikibits.js
   
7. #
   
8. # All other code is copyright © 2005 Nikola Smolenski <smolensk@eunet.yu>
   
9. #
   
10. # This program is free software; you can redistribute it and/or modify
    
11. # it under the terms of the GNU General Public License as published by
    
12. # the Free Software Foundation; either version 2 of the License, or
    
13. # (at your option) any later version.
    
14. #
    
15. # To install, copy the extension to your extensions directory and add line
    
16. # include("extensions/ShowHide.php");
    
17. # to the bottom of your LocalSettings.php
    
18. #
    
19. # Example syntax:
    
20. #
    
21. # <showhide>
    
22. # Some text (usually title) which will not be hidden __HIDER__
    
23. # <hide>Text which will be hidden</hide>
    
24. # </showhide>
    
25. #
    
26. # If <show></show> tags are used instead of <hide></hide>, the text will be
    
27. # shown by default
    
28. #
    
29. # For more information see its page at
    
30. # http://meta.wikimedia.org/wiki/ShowHide_Extension
    
31. 
    
32. $wgExtensionFunctions[]="wfShowHideExtension";
    
33. 
    
34. function wfShowHideExtension()
    
35. {
    
36.     $GLOBALS['wgParser']->setHook("showhide","ShowHideExtension");
    
37. }
    
38. 
    
39. function ShowHideExtension($in)
    
40. {
    
41.     global $wgOut;
    
42.     static $numrun=0;
    
43. 
    
44.     $out=$wgOut->parse($in);
    
45.     if(
    
46.         strpos($out,"__HIDER__")!==FALSE &&
    
47.         ((
    
48.             ($s=strpos($out,"<show>"))!==FALSE &&
    
49.             strpos($out,"</show>")>$s
    
50.         ) || (
    
51.             ($h=strpos($out,"<hide>"))!==FALSE &&
    
52.             strpos($out,"</hide>")>$h
    
53.         ))
    
54.     ) {
    
55.         if($numrun==0) {
    
56.             $out=
    
57. "<script type="text/javascript"><!--
    
58. shWas=new Array();
    
59. function showSHToggle(show,hide,num) {
    
60.     if(document.getElementById) {
    
61.         document.writeln('<span class=\'toctoggle\'>[<a href="javascript:toggleSH('+num+')" class="internal">' +
    
62.         '<span id="showlink'+num+'" style="display:none;">' + show + '</span>' +
    
63.         '<span id="hidelink'+num+'">' + hide + '</span>' +
    
64.         '</a>]</span>');
    
65.     }
    
66. }
    
67. function toggleSH(num) {
    
68.     var shmain = document.getElementById('showhide'+num);
    
69.     var sh = document.getElementById('shinside'+num);
    
70.     var showlink=document.getElementById('showlink'+num);
    
71.     var hidelink=document.getElementById('hidelink'+num);
    
72.     if(sh.style.display == 'none') {
    
73.         sh.style.display = shWas[num];
    
74.         hidelink.style.display='';
    
75.         showlink.style.display='none';
    
76.         shmain.className = '';
    
77.     } else {
    
78.         shWas[num] = sh.style.display;
    
79.         sh.style.display = 'none';
    
80.         hidelink.style.display='none';
    
81.         showlink.style.display='';
    
82.         shmain.className = 'tochidden';
    
83.     }
    
84. } // --></script>
    
85. ".$out;
    
86.         }
    
87.         $numrun++;
    
88. 
    
89.         if($s!==FALSE)
    
90.             $act="show";
    
91.         else
    
92.             $act="hide";
    
93. 
    
94.         $hideline = ' <script type="text/javascript">showSHToggle("' . addslashes( wfMsg('showtoc') ) . '","' . addslashes( wfMsg('hidetoc') ) . '",' . $numrun . ')</script>';
    
95. 
    
96.         $out=str_replace("__HIDER__","$hideline",$out);
    
97.         $out=str_replace(
    
98.             array("<$act>",                "</$act>"),
    
99.             array("<div id="shinside$numrun">","</div>"),
    
100.             $out
     
101.         );
     
102.         $out="<span id="showhide$numrun">$out</span>";
     
103.         if($act=="hide")
     
104.             $out.="<script type="text/javascript">toggleSH($numrun)</script>";
     
105.     }
     
106.     return $out;
     
107. }
     
108. ?>

复制代码

v 0.1.1

PHP5 version with corrections according to 根据Smerf's的意见.

    注意：我无法让下面这个版本在MediaWiki 1.5版本上正确运行。下面的内容可以在首次加载时正确工作，但经过cache加载，由$wgOut->addHtml插入的一次性 Javascript代码无法加进去导致了这个问题。前面的v.0.1则在我这里能正常工作。

1. <?php
   
2. # WikiMedia ShowHide extension v0.1.1
   
3. #
   
4. # Based on example code from
   
5. # http://meta.wikimedia.org/wiki/Write_your_own_MediaWiki_extension
   
6. # Contains code from MediaWiki's Skin.php and wikibits.js
   
7. #
   
8. # All other code is copyright © 2005 Nikola Smolenski <smolensk@eunet.yu>
   
9. #
   
10. # This program is free software; you can redistribute it and/or modify
    
11. # it under the terms of the GNU General Public License as published by
    
12. # the Free Software Foundation; either version 2 of the License, or
    
13. # (at your option) any later version.
    
14. #
    
15. # To install, copy the extension to your extensions directory and add line
    
16. # include("extensions/ShowHide.php");
    
17. # to the bottom of your LocalSettings.php
    
18. #
    
19. # Example syntax:
    
20. #
    
21. # <showhide>
    
22. # Some text (usually title) which will not be hidden __HIDER__
    
23. # <hide>Text which will be hidden</hide>
    
24. # </showhide>
    
25. #
    
26. # If <show></show> tags are used instead of <hide></hide>, the text will be
    
27. # shown by default
    
28. #
    
29. # For more information see its page at
    
30. # http://meta.wikimedia.org/wiki/ShowHide_Extension
    
31. 
    
32. $wgExtensionFunctions[]="wfShowHideExtension";
    
33. 
    
34. function wfShowHideExtension()
    
35. {
    
36.     $GLOBALS['wgParser']->setHook("showhide","ShowHideExtension");
    
37. }
    
38. 
    
39. function ShowHideExtension($in)
    
40. {
    
41.     global $wgOut;
    
42.     static $numrun=0;
    
43. 
    
44.     $out=$wgOut->parse($in);
    
45.     if(
    
46.                 strpos($out,"__HIDER__")!==FALSE &&
    
47.                 ((
    
48.                         ($s=strpos($out,htmlentities("<show>")))!==FALSE &&
    
49.                         strpos($out,htmlentities("</show>"))>$s
    
50.                 ) || (
    
51.                         ($h=strpos($out,htmlentities("<hide>")))!==FALSE &&
    
52.                         strpos($out,htmlentities("</hide>"))>$h
    
53.                 ))
    
54.         ) {
    
55.                 if($numrun==0) {
    
56.                         $wgOut->addHTML(
    
57. "<script type="text/javascript"><!--
    
58. shWas=new Array();
    
59. function showSHToggle(show,hide,num) {
    
60.         if(document.getElementById) {
    
61.                 document.writeln('<span class=\'toctoggle\'>[<a href="javascript:toggleSH('+num+')" class="internal">' +
    
62.                 '<span id="showlink'+num+'" style="display:none;">' + show + '</span>' +
    
63.                 '<span id="hidelink'+num+'">' + hide + '</span>' +
    
64.                 '</a>]</span>');
    
65.         }
    
66. }
    
67. function toggleSH(num) {
    
68.         var shmain = document.getElementById('showhide'+num);
    
69.         var sh = document.getElementById('shinside'+num);
    
70.         var showlink=document.getElementById('showlink'+num);
    
71.         var hidelink=document.getElementById('hidelink'+num);
    
72.         if(sh.style.display == 'none') {
    
73.                 sh.style.display = shWas[num];
    
74.                 hidelink.style.display='';
    
75.                 showlink.style.display='none';
    
76.                 shmain.className = '';
    
77.         } else {
    
78.                 shWas[num] = sh.style.display;
    
79.                 sh.style.display = 'none';
    
80.                 hidelink.style.display='none';
    
81.                 showlink.style.display='';
    
82.                 shmain.className = 'tochidden';
    
83.         }
    
84. } // --></script>
    
85. ");
    
86.                 }
    
87.                 $numrun++;
    
88. 
    
89.                 if($s!==FALSE)
    
90.                         $act="show";
    
91.                 else
    
92.                         $act="hide";
    
93. 
    
94.                 $hideline = ' <script type="text/javascript">showSHToggle("' . addslashes( wfMsg('showtoc') ) . '","' . addslashes( wfMsg('hidetoc') ) . '",' . $numrun . ')</script>';
    
95. 
    
96.                 $out=str_replace("__HIDER__","$hideline",$out);
    
97.                 $out=str_replace(
    
98.                         array(htmlentities("<$act>"),                htmlentities("</$act>")),
    
99.                         array("<div id="shinside$numrun">","</div>"),
    
100.                         $out
     
101.                 );
     
102.         $out="<span id="showhide$numrun">$out</span>";
     
103.         if($act=="hide")
     
104.             $out.="<script type="text/javascript">toggleSH($numrun)</script>";
     
105.     }
     
106.     return $out;
     
107. }
     
108. ?>

复制代码

其他

还有其他的版本，由Austin Che编写。参见 http://austin.mit.edu/mediawiki/showhide.php.txt