미디어위키:Common.js: 두 판 사이의 차이

  • 최근 수정 시각: 2026년 8월 20일 (목) 15:13
편집 토론 문서 역사
편집 요약 없음
태그: 되돌려진 기여
편집 요약 없음
 
(같은 사용자의 중간 판 47개는 보이지 않습니다)
1번째 줄: 1번째 줄:
/**
/* MediaWiki:Common.js */
* MediaWiki customtoggle 펼치기/접기 애니메이션
mw.hook('wikipage.content').add(function ($content) {
*
* 예:
* .mw-customtoggle-KSC_LEADER
*     ↓
* #mw-customcollapsible-KSC_LEADER
*/


( function () {
    var initialized = {};
'use strict';


var DURATION = 300;
    $content.find('[class*="mw-customtoggle-"]').each(function () {
        var classList = (this.className || '').split(/\s+/);


/**
        classList.forEach(function (cls) {
* customtoggle에서 식별자 추출
            if (cls.indexOf('mw-customtoggle-') !== 0) {
*
                return;
* mw-customtoggle-KSC_LEADER
            }
* → KSC_LEADER
*/
function getToggleId( toggle ) {
var classes = toggle.className.split( /\\s+/ );
var i;


for ( i = 0; i < classes.length; i++ ) {
            var suffix = cls.substring('mw-customtoggle-'.length);
if (
classes[ i ].indexOf( 'mw-customtoggle-' ) === 0
) {
return classes[ i ].substring(
'mw-customtoggle-'.length
);
}
}


return null;
            if (initialized[suffix]) {
}
                return;
            }


/**
            initialized[suffix] = true;
* 연결된 collapsible 찾기
*/
function getTarget( id ) {
if ( !id ) {
return null;
}


/*
            var targetId = 'mw-customcollapsible-' + suffix;
* 가장 일반적인 MediaWiki 형식
*/
var target = document.getElementById(
'mw-customcollapsible-' + id
);


if ( target ) {
            /*
return target;
            * 중복 ID가 있을 수 있으므로
}
            * #id 대신 attribute selector 사용
            */
            var $targets = $content.find('[id="' + targetId + '"]');


/*
            if (!$targets.length) {
* 일부 틀에서 class 방식으로 만들어진 경우 대응
                return;
*/
            }
target = document.querySelector(
'.mw-customcollapsible-' +
CSS.escape( id )
);


return target;
}


/**
            /*
* 실제 접히고 펼쳐지는 내용 찾기
            * =====================================================
*/
            * 특수형
function getContent( target ) {
            *
var content = target.querySelector(
            * 아나운서 표처럼:
'.mw-collapsible-content'
            *
);
            * [상단 버튼 wrapper]
            * [실제 내용 패널]
            *
            * 두 요소가 같은 ID를 공유하고,
            * 실제 패널 안에 wikitable이 있는 구조
            * =====================================================
            */
            var $specialPanel = $targets.filter(function () {
                return $(this).find('table.wikitable').length > 0;
            });


if ( content ) {
            if ($targets.length > 1 && $specialPanel.length) {
return content;
                initStackedCollapsible(
}
                    $content,
                    cls,
                    $targets
                );


/*
                return;
* 별도의 mw-collapsible-content가 없으면
            }
* target 자체를 애니메이션
*/
return target;
}


function isCollapsed( target, content ) {
return (
target.classList.contains( 'mw-collapsed' ) ||
window.getComputedStyle( content ).display === 'none'
);
}


function expand( target, content, toggle ) {
            /*
if (
            * =====================================================
content.classList.contains(
            * 일반 MediaWiki collapsible
'mw-custom-collapse-animating'
            * =====================================================
)
            */
) {
            initNormalCollapsible(
return;
                $content,
}
                cls,
                $targets.first()
            );
        });
    });


target.classList.remove( 'mw-collapsed' );


content.style.display = 'block';
content.style.height = 'auto';


var targetHeight = content.scrollHeight;
    /*
    * =============================================================
    * 일반 펼치기 · 접기
    * =============================================================
    */
    function initNormalCollapsible($content, cls, $target) {


content.style.height = '0px';
        var $toggles = $content.find('.' + cls);
content.style.opacity = '0';


content.classList.add(
        /*
'mw-custom-collapse-animating'
        * 일반 MediaWiki 구조:
);
        *
        * .mw-collapsible
        *  └ .mw-collapsible-content
        *
        * content가 있으면 content만 애니메이션
        */
        var $contentTarget = $target.children('.mw-collapsible-content');


/* reflow */
        if (!$contentTarget.length) {
content.offsetHeight;
            $contentTarget = $target.find('.mw-collapsible-content').first();
        }


var animation = content.animate(
        var $animTarget = $contentTarget.length
[
            ? $contentTarget
{
            : $target;
height: '0px',
opacity: 0
},
{
height: targetHeight + 'px',
opacity: 1
}
],
{
duration: DURATION,
easing: 'ease',
fill: 'forwards'
}
);


animation.onfinish = function () {
content.classList.remove(
'mw-custom-collapse-animating'
);


content.style.display = '';
        /*
content.style.height = '';
        * 현재 상태를 기준으로 초기 aria 설정
content.style.opacity = '';
        */
        var initiallyOpen = $animTarget.is(':visible');


toggle.setAttribute(
        $toggles.attr(
'aria-expanded',
            'aria-expanded',
'true'
            initiallyOpen ? 'true' : 'false'
);
        );


animation.cancel();
};
}


function collapse( target, content, toggle ) {
        $toggles
if (
            .off('click.smoothSlide')
content.classList.contains(
            .on('click.smoothSlide', function (e) {
'mw-custom-collapse-animating'
)
) {
return;
}


var startHeight =
                e.preventDefault();
content.getBoundingClientRect().height;
                e.stopImmediatePropagation();


content.style.display = 'block';


content.classList.add(
                /*
'mw-custom-collapse-animating'
                * 애니메이션 중 재클릭 방지
);
                */
                if ($animTarget.is(':animated')) {
                    return false;
                }


var animation = content.animate(
[
{
height: startHeight + 'px',
opacity: 1
},
{
height: '0px',
opacity: 0
}
],
{
duration: DURATION,
easing: 'ease',
fill: 'forwards'
}
);


animation.onfinish = function () {
                var opening = !$animTarget.is(':visible');
target.classList.add( 'mw-collapsed' );


content.classList.remove(
'mw-custom-collapse-animating'
);


content.style.display = 'none';
                /*
content.style.height = '';
                * -------------------------------------------------
content.style.opacity = '';
                * 펼치기
                * -------------------------------------------------
                */
                if (opening) {


toggle.setAttribute(
                    /*
'aria-expanded',
                    * MediaWiki collapsed 상태 제거
'false'
                    */
);
                    $target.removeClass('mw-collapsed');


animation.cancel();
};
}


function handleToggle( toggle ) {
                    /*
var id = getToggleId( toggle );
                    * 내용만 펼침
                    */
                    $animTarget
                        .stop(true, true)
                        .hide()
                        .slideDown(250, function () {


if ( !id ) {
                            /*
return;
                            * jQuery 애니메이션 inline style 정리
}
                            */
                            $(this).css({
                                height: '',
                                overflow: '',
                                paddingTop: '',
                                paddingBottom: '',
                                marginTop: '',
                                marginBottom: ''
                            });
                        });


var target = getTarget( id );


if ( !target ) {
                    $toggles.attr('aria-expanded', 'true');
return;
                }
}


var content = getContent( target );


if ( !content ) {
                /*
return;
                * -------------------------------------------------
}
                * 접기
                * -------------------------------------------------
                */
                else {


if ( isCollapsed( target, content ) ) {
                    $animTarget
expand(
                        .stop(true, true)
target,
                        .slideUp(250, function () {
content,
toggle
);
} else {
collapse(
target,
content,
toggle
);
}
}


/*
                            /*
* MediaWiki 기본 customtoggle 동작보다 먼저 실행
                            * 애니메이션 종료 후 collapsed 복원
*/
                            */
document.addEventListener(
                            $target.addClass('mw-collapsed');
'click',
function ( event ) {
var toggle = event.target.closest(
'.mw-customtoggle'
);


if ( !toggle ) {
                            $(this).css({
return;
                                display: 'none',
}
                                height: '',
                                overflow: '',
                                paddingTop: '',
                                paddingBottom: '',
                                marginTop: '',
                                marginBottom: ''
                            });
                        });


if ( !getToggleId( toggle ) ) {
return;
}


event.preventDefault();
                    $toggles.attr('aria-expanded', 'false');
event.stopPropagation();
                }
event.stopImmediatePropagation();


handleToggle( toggle );
},
true
);


/*
                return false;
* 키보드 접근
            });
*/
    }
document.addEventListener(
'keydown',
function ( event ) {
if (
event.key !== 'Enter' &&
event.key !== ' '
) {
return;
}


var toggle = event.target.closest(
'.mw-customtoggle'
);


if ( !toggle ) {
return;
}


event.preventDefault();
    /*
event.stopPropagation();
    * =============================================================
event.stopImmediatePropagation();
    * 아나운서형 특수 펼치기 · 접기
    * =============================================================
    *
    * DOM 예:
    *
    * [남성 버튼 wrapper]
    * [남성 실제 패널]
    * [여성 버튼 wrapper]
    * [여성 실제 패널]
    *
    * 패널을 이동시키지 않고
    * 원래 DOM 위치에서 펼친다.
    *
    * 중요한 점:
    *
    * wrapper와 panel을 둘 다 애니메이션하지 않는다.
    *
    * 버튼 wrapper는 즉시 교체하고,
    * 실제 패널 하나만 slide 애니메이션한다.
    *
    * 따라서 이중 움직임이나
    * 중간 겹침 현상이 최소화된다.
    * =============================================================
    */
    function initStackedCollapsible($content, cls, $targets) {


handleToggle( toggle );
        /*
},
        * wikitable이 들어 있는 요소를 실제 패널로 사용
true
        */
);
        var $panel = $targets.filter(function () {
            return $(this).find('table.wikitable').length > 0;
        }).first();


}() );
        if (!$panel.length) {
            return;
        }
 
 
        /*
        * 실제 패널이 아닌 동일 ID 요소 중
        * 해당 toggle을 포함하는 요소 = 상단 버튼 wrapper
        */
        var $topWrapper = $targets.not($panel).filter(function () {
            return $(this).find('.' + cls).length > 0;
        }).first();
 
        if (!$topWrapper.length) {
            return;
        }
 
 
        var $topToggle = $topWrapper.find('.' + cls).first();
        var $panelToggle = $panel.find('.' + cls).first();
 
 
        if (!$topToggle.length || !$panelToggle.length) {
            return;
        }
 
 
 
        /*
        * =========================================================
        * 최초 상태
        * =========================================================
        */
        $panel
            .stop(true, true)
            .addClass('mw-collapsed')
            .hide()
            .css({
                height: '',
                overflow: '',
                paddingTop: '',
                paddingBottom: '',
                marginTop: '',
                marginBottom: ''
            });
 
 
        $topWrapper
            .stop(true, true)
            .show()
            .css({
                height: '',
                overflow: '',
                paddingTop: '',
                paddingBottom: '',
                marginTop: '',
                marginBottom: ''
            });
 
 
        $topToggle.attr('aria-expanded', 'false');
        $panelToggle.attr('aria-expanded', 'false');
 
 
 
        /*
        * =========================================================
        * 위쪽 버튼 클릭 → 펼치기
        * =========================================================
        */
        $topToggle
            .off('click.smoothSlide')
            .on('click.smoothSlide', function (e) {
 
                e.preventDefault();
                e.stopImmediatePropagation();
 
 
                /*
                * 애니메이션 중 재클릭 방지
                */
                if ($panel.is(':animated')) {
                    return false;
                }
 
 
                /*
                * 이미 열려 있으면 중단
                */
                if ($panel.is(':visible')) {
                    return false;
                }
 
 
                /*
                * -------------------------------------------------
                * 상단 버튼 wrapper는 즉시 숨김
                *
                * wrapper 자체를 애니메이션하지 않으므로
                * 이중 움직임이 발생하지 않는다.
                * -------------------------------------------------
                */
                $topWrapper
                    .stop(true, true)
                    .hide();
 
 
                /*
                * MediaWiki collapsed 상태 제거
                */
                $panel.removeClass('mw-collapsed');
 
 
                /*
                * -------------------------------------------------
                * 실제 패널 하나만 부드럽게 펼침
                * -------------------------------------------------
                */
                $panel
                    .stop(true, true)
                    .hide()
                    .slideDown(260, function () {
 
                        /*
                        * animation 종료 후
                        * jQuery가 만든 inline style 정리
                        */
                        $(this).css({
                            height: '',
                            overflow: '',
                            paddingTop: '',
                            paddingBottom: '',
                            marginTop: '',
                            marginBottom: ''
                        });
                    });
 
 
                /*
                * ARIA
                */
                $topToggle.attr('aria-expanded', 'true');
                $panelToggle.attr('aria-expanded', 'true');
 
 
                return false;
            });
 
 
 
        /*
        * =========================================================
        * 패널 안쪽 버튼 클릭 → 접기
        * =========================================================
        */
        $panelToggle
            .off('click.smoothSlide')
            .on('click.smoothSlide', function (e) {
 
                e.preventDefault();
                e.stopImmediatePropagation();
 
 
                /*
                * 애니메이션 중 재클릭 방지
                */
                if ($panel.is(':animated')) {
                    return false;
                }
 
 
                /*
                * -------------------------------------------------
                * 실제 패널 하나만 접음
                * -------------------------------------------------
                */
                $panel
                    .stop(true, true)
                    .slideUp(260, function () {
 
                        /*
                        * 패널을 완전히 닫은 뒤
                        * collapsed 상태 복원
                        */
                        $(this)
                            .addClass('mw-collapsed')
                            .css({
                                display: 'none',
                                height: '',
                                overflow: '',
                                paddingTop: '',
                                paddingBottom: '',
                                marginTop: '',
                                marginBottom: ''
                            });
 
 
                        /*
                        * -------------------------------------------------
                        * 원래 상단 버튼 즉시 복귀
                        *
                        * 별도 애니메이션을 하지 않기 때문에
                        * 닫힘 동작도 한 번의 움직임으로 보인다.
                        * -------------------------------------------------
                        */
                        $topWrapper
                            .stop(true, true)
                            .show()
                            .css({
                                height: '',
                                overflow: '',
                                paddingTop: '',
                                paddingBottom: '',
                                marginTop: '',
                                marginBottom: ''
                            });
                    });
 
 
                /*
                * ARIA
                */
                $topToggle.attr('aria-expanded', 'false');
                $panelToggle.attr('aria-expanded', 'false');
 
 
                return false;
            });
    }
 
});

2026년 8월 20일 (목) 15:13 기준 최신판

/* MediaWiki:Common.js */
mw.hook('wikipage.content').add(function ($content) {

    var initialized = {};

    $content.find('[class*="mw-customtoggle-"]').each(function () {
        var classList = (this.className || '').split(/\s+/);

        classList.forEach(function (cls) {
            if (cls.indexOf('mw-customtoggle-') !== 0) {
                return;
            }

            var suffix = cls.substring('mw-customtoggle-'.length);

            if (initialized[suffix]) {
                return;
            }

            initialized[suffix] = true;

            var targetId = 'mw-customcollapsible-' + suffix;

            /*
             * 중복 ID가 있을 수 있으므로
             * #id 대신 attribute selector 사용
             */
            var $targets = $content.find('[id="' + targetId + '"]');

            if (!$targets.length) {
                return;
            }


            /*
             * =====================================================
             * 특수형
             *
             * 아나운서 표처럼:
             *
             * [상단 버튼 wrapper]
             * [실제 내용 패널]
             *
             * 두 요소가 같은 ID를 공유하고,
             * 실제 패널 안에 wikitable이 있는 구조
             * =====================================================
             */
            var $specialPanel = $targets.filter(function () {
                return $(this).find('table.wikitable').length > 0;
            });

            if ($targets.length > 1 && $specialPanel.length) {
                initStackedCollapsible(
                    $content,
                    cls,
                    $targets
                );

                return;
            }


            /*
             * =====================================================
             * 일반 MediaWiki collapsible
             * =====================================================
             */
            initNormalCollapsible(
                $content,
                cls,
                $targets.first()
            );
        });
    });



    /*
     * =============================================================
     * 일반 펼치기 · 접기
     * =============================================================
     */
    function initNormalCollapsible($content, cls, $target) {

        var $toggles = $content.find('.' + cls);

        /*
         * 일반 MediaWiki 구조:
         *
         * .mw-collapsible
         *   └ .mw-collapsible-content
         *
         * content가 있으면 content만 애니메이션
         */
        var $contentTarget = $target.children('.mw-collapsible-content');

        if (!$contentTarget.length) {
            $contentTarget = $target.find('.mw-collapsible-content').first();
        }

        var $animTarget = $contentTarget.length
            ? $contentTarget
            : $target;


        /*
         * 현재 상태를 기준으로 초기 aria 설정
         */
        var initiallyOpen = $animTarget.is(':visible');

        $toggles.attr(
            'aria-expanded',
            initiallyOpen ? 'true' : 'false'
        );


        $toggles
            .off('click.smoothSlide')
            .on('click.smoothSlide', function (e) {

                e.preventDefault();
                e.stopImmediatePropagation();


                /*
                 * 애니메이션 중 재클릭 방지
                 */
                if ($animTarget.is(':animated')) {
                    return false;
                }


                var opening = !$animTarget.is(':visible');


                /*
                 * -------------------------------------------------
                 * 펼치기
                 * -------------------------------------------------
                 */
                if (opening) {

                    /*
                     * MediaWiki collapsed 상태 제거
                     */
                    $target.removeClass('mw-collapsed');


                    /*
                     * 내용만 펼침
                     */
                    $animTarget
                        .stop(true, true)
                        .hide()
                        .slideDown(250, function () {

                            /*
                             * jQuery 애니메이션 inline style 정리
                             */
                            $(this).css({
                                height: '',
                                overflow: '',
                                paddingTop: '',
                                paddingBottom: '',
                                marginTop: '',
                                marginBottom: ''
                            });
                        });


                    $toggles.attr('aria-expanded', 'true');
                }


                /*
                 * -------------------------------------------------
                 * 접기
                 * -------------------------------------------------
                 */
                else {

                    $animTarget
                        .stop(true, true)
                        .slideUp(250, function () {

                            /*
                             * 애니메이션 종료 후 collapsed 복원
                             */
                            $target.addClass('mw-collapsed');

                            $(this).css({
                                display: 'none',
                                height: '',
                                overflow: '',
                                paddingTop: '',
                                paddingBottom: '',
                                marginTop: '',
                                marginBottom: ''
                            });
                        });


                    $toggles.attr('aria-expanded', 'false');
                }


                return false;
            });
    }



    /*
     * =============================================================
     * 아나운서형 특수 펼치기 · 접기
     * =============================================================
     *
     * DOM 예:
     *
     * [남성 버튼 wrapper]
     * [남성 실제 패널]
     * [여성 버튼 wrapper]
     * [여성 실제 패널]
     *
     * 패널을 이동시키지 않고
     * 원래 DOM 위치에서 펼친다.
     *
     * 중요한 점:
     *
     * wrapper와 panel을 둘 다 애니메이션하지 않는다.
     *
     * 버튼 wrapper는 즉시 교체하고,
     * 실제 패널 하나만 slide 애니메이션한다.
     *
     * 따라서 이중 움직임이나
     * 중간 겹침 현상이 최소화된다.
     * =============================================================
     */
    function initStackedCollapsible($content, cls, $targets) {

        /*
         * wikitable이 들어 있는 요소를 실제 패널로 사용
         */
        var $panel = $targets.filter(function () {
            return $(this).find('table.wikitable').length > 0;
        }).first();

        if (!$panel.length) {
            return;
        }


        /*
         * 실제 패널이 아닌 동일 ID 요소 중
         * 해당 toggle을 포함하는 요소 = 상단 버튼 wrapper
         */
        var $topWrapper = $targets.not($panel).filter(function () {
            return $(this).find('.' + cls).length > 0;
        }).first();

        if (!$topWrapper.length) {
            return;
        }


        var $topToggle = $topWrapper.find('.' + cls).first();
        var $panelToggle = $panel.find('.' + cls).first();


        if (!$topToggle.length || !$panelToggle.length) {
            return;
        }



        /*
         * =========================================================
         * 최초 상태
         * =========================================================
         */
        $panel
            .stop(true, true)
            .addClass('mw-collapsed')
            .hide()
            .css({
                height: '',
                overflow: '',
                paddingTop: '',
                paddingBottom: '',
                marginTop: '',
                marginBottom: ''
            });


        $topWrapper
            .stop(true, true)
            .show()
            .css({
                height: '',
                overflow: '',
                paddingTop: '',
                paddingBottom: '',
                marginTop: '',
                marginBottom: ''
            });


        $topToggle.attr('aria-expanded', 'false');
        $panelToggle.attr('aria-expanded', 'false');



        /*
         * =========================================================
         * 위쪽 버튼 클릭 → 펼치기
         * =========================================================
         */
        $topToggle
            .off('click.smoothSlide')
            .on('click.smoothSlide', function (e) {

                e.preventDefault();
                e.stopImmediatePropagation();


                /*
                 * 애니메이션 중 재클릭 방지
                 */
                if ($panel.is(':animated')) {
                    return false;
                }


                /*
                 * 이미 열려 있으면 중단
                 */
                if ($panel.is(':visible')) {
                    return false;
                }


                /*
                 * -------------------------------------------------
                 * 상단 버튼 wrapper는 즉시 숨김
                 *
                 * wrapper 자체를 애니메이션하지 않으므로
                 * 이중 움직임이 발생하지 않는다.
                 * -------------------------------------------------
                 */
                $topWrapper
                    .stop(true, true)
                    .hide();


                /*
                 * MediaWiki collapsed 상태 제거
                 */
                $panel.removeClass('mw-collapsed');


                /*
                 * -------------------------------------------------
                 * 실제 패널 하나만 부드럽게 펼침
                 * -------------------------------------------------
                 */
                $panel
                    .stop(true, true)
                    .hide()
                    .slideDown(260, function () {

                        /*
                         * animation 종료 후
                         * jQuery가 만든 inline style 정리
                         */
                        $(this).css({
                            height: '',
                            overflow: '',
                            paddingTop: '',
                            paddingBottom: '',
                            marginTop: '',
                            marginBottom: ''
                        });
                    });


                /*
                 * ARIA
                 */
                $topToggle.attr('aria-expanded', 'true');
                $panelToggle.attr('aria-expanded', 'true');


                return false;
            });



        /*
         * =========================================================
         * 패널 안쪽 버튼 클릭 → 접기
         * =========================================================
         */
        $panelToggle
            .off('click.smoothSlide')
            .on('click.smoothSlide', function (e) {

                e.preventDefault();
                e.stopImmediatePropagation();


                /*
                 * 애니메이션 중 재클릭 방지
                 */
                if ($panel.is(':animated')) {
                    return false;
                }


                /*
                 * -------------------------------------------------
                 * 실제 패널 하나만 접음
                 * -------------------------------------------------
                 */
                $panel
                    .stop(true, true)
                    .slideUp(260, function () {

                        /*
                         * 패널을 완전히 닫은 뒤
                         * collapsed 상태 복원
                         */
                        $(this)
                            .addClass('mw-collapsed')
                            .css({
                                display: 'none',
                                height: '',
                                overflow: '',
                                paddingTop: '',
                                paddingBottom: '',
                                marginTop: '',
                                marginBottom: ''
                            });


                        /*
                         * -------------------------------------------------
                         * 원래 상단 버튼 즉시 복귀
                         *
                         * 별도 애니메이션을 하지 않기 때문에
                         * 닫힘 동작도 한 번의 움직임으로 보인다.
                         * -------------------------------------------------
                         */
                        $topWrapper
                            .stop(true, true)
                            .show()
                            .css({
                                height: '',
                                overflow: '',
                                paddingTop: '',
                                paddingBottom: '',
                                marginTop: '',
                                marginBottom: ''
                            });
                    });


                /*
                 * ARIA
                 */
                $topToggle.attr('aria-expanded', 'false');
                $panelToggle.attr('aria-expanded', 'false');


                return false;
            });
    }

});