پرش به محتوا

مدیاویکی:Gadget-AncreTitres.js

از دانشنامه علوم انسانی
نسخهٔ تاریخ ۵ مارس ۲۰۲۵، ساعت ۰۷:۰۹ توسط imported>Ebrahim (عدم استفاده از mw.Uri)

نکته: پس از انتشار ممکن است برای دیدن تغییرات نیاز باشد که حافظهٔ نهانی مرورگر خود را پاک کنید.

  • فایرفاکس / سافاری: کلید Shift را نگه دارید و روی دکمهٔ Reload کلیک کنید، یا کلید‌های Ctrl-F5 یا Ctrl-R را با هم فشار دهید (در رایانه‌های اپل مکینتاش کلید‌های ⌘-R)
  • گوگل کروم: کلیدهای Ctrl+Shift+R را با هم فشار دهید (در رایانه‌های اپل مکینتاش کلید‌های ⌘-Shift-R)
  • Edge: کلید Ctrl را نگه‌دارید و روی دکمهٔ Refresh کلیک کنید، یا کلید‌های Ctrl-F5 را با هم فشار دهید
/**
 * AncreTitres
 *
 * Cette fonction fournit un lien vers une section de page en cliquant
 * sur le lien [URL] ou [[lien]] à droite du titre de section.
 *
 * Auteurs : Pabix, Phe, Bayo, Chphe, Arkanosis, Mah3110, Ash_Crow, Dalba, Jeeputer
 * {{Projet:JavaScript/Script|AncreTitres}}
 */
/* global $, mw */
/* eslint-env browser */
// <nowiki>
mw.loader.using( [ 'mediawiki.util', 'mediawiki.Uri', 'user' ], function () {
	'use strict';

	$( function ( $ ) {
		var lang = mw.config.get( 'wgUserLanguage' ),
			messages = {
				en: {
					'ancretitres-anchor-name': '[URL]',
					'ancretitres-internal-link-name': '[[Link]]',
					'ancretitres-permanent-link-name': '[[Permalink]]',
					'ancretitres-description': 'Get an URL to this section',
					'ancretitres-int-description': 'Get an internal link to this section',
					'ancretitres-int-description': 'Get a permanent link to this section',
					'ancretitres-notif-title': 'Text copied to clipboard',
					'ancretitres-notif-error': 'Could not copy to clipboard'
				},
				fa: {
					'ancretitres-anchor-name': '[نشانی وب]',
					'ancretitres-internal-link-name': '[[ویکی‌پیوند]]',
					'ancretitres-permanent-link-name': '[[پایاپیوند]]',
					'ancretitres-description': 'دریافت نشانی وب برای این بخش',
					'ancretitres-int-description': 'دریافت پیوند داخلی به این بخش',
					'ancretitres-permanent-description': 'دریافت پیوند پایدار به این بخش',
					'ancretitres-notif-title': 'متن به بریده‌دان منتقل شد',
					'ancretitres-notif-error': 'ناتوان از رونویسی در بریده‌دان'
				}
			},
			options = {
				afficheE: true,
				afficheI: true,
				afficheP: true
			};

		mw.messages.set( messages.en );
		if ( lang !== 'en' && lang in messages ) {
			mw.messages.set( messages[ lang ] );
		}

		function copyTextToClipboard( text ) {
			function notifySuccess() {
				mw.notify( text, { title: mw.msg( 'ancretitres-notif-title' ), tag: 'ancretitres', type: 'info', autoHide: true } );
			}

			function notifyError() {
				mw.notify( mw.msg( 'ancretitres-notif-error' ), { tag: 'ancretitres', type: 'error', autoHide: true } );
			}

			if ( navigator.clipboard ) {
				// Clipboard API
				navigator.clipboard.writeText( text ).then( notifySuccess, notifyError );
			} else {
				notifyError();
			}
		}

		if ( typeof window.AncreTitres !== 'undefined' ) {
			Object.assign( options, window.AncreTitres );
		}

		if ( !options.afficheI && !options.afficheE && !options.afficheP ) {
			return;
		}

		// https://phabricator.wikimedia.org/T13555
		// https://www.mediawiki.org/wiki/Heading_HTML_changes

		// old markup (hN > .mw-headline)
		$( '.mw-headline' ).each( function ( _, mwHeadline ) {
			if ( mwHeadline.id ) {
				processHeading( mwHeadline.parentElement, mwHeadline.id );
			}
		} );

		// new markup (.mw-heading > hN)
		$( '.mw-heading' ).each( function ( _, mwHeading ) {
			var heading = mwHeading.querySelector( 'h1, h2, h3, h4, h5, h6' );
			if ( heading && heading.id ) {
				processHeading( mwHeading, heading.id );
			}
		} );

		function processHeading( headingContainer, sectionId ) {
			var $span = $( '<span>' )
				.addClass( 'noprint ancretitres' )
				.css( {
					'font-size': 'xx-small',
					'font-weight': 'normal',
					'user-select': 'none' // jQuery se charge d'ajouter un vendor prefix si nécessaire
				} );

			var sectionUrl = new URL(mw.util.getUrl(), window.location).toString() + '#' + sectionId;

			if ( options.afficheE ) {
				var $linkE = $( '<a>' )
					.attr( 'href', sectionUrl )
					.attr( 'title', mw.msg( 'ancretitres-description' ) )
					.text( mw.msg( 'ancretitres-anchor-name' ) )
					.click( function ( e ) {
						e.preventDefault();
						copyTextToClipboard( sectionUrl );
					} );
				$span.append( ' ', $linkE );
			}

			if ( options.afficheI ) {
				var $linkI = $( '<a>' )
					.attr( 'href', sectionUrl )
					.attr( 'title', mw.msg( 'ancretitres-int-description' ) )
					.text( mw.msg( 'ancretitres-internal-link-name' ) )
					.click( function ( e ) {
						e.preventDefault();
						var escapedAnchor = sectionId
							// escaping caractères spéciaux HTML
							// (partiel, '"& ne sont pas escapés pour ne pas dégrader inutilement la lisibilité du lien)
							.replaceAll( '<', '&lt;' )
							.replaceAll( '>', '&gt;' )
							// escaping caractères spéciaux MediaWiki
							.replaceAll( '[', '&#91;' )
							.replaceAll( ']', '&#93;' )
							.replaceAll( '{', '&#123;' )
							.replaceAll( '|', '&#124;' )
							.replaceAll( '}', '&#125;' );
						var outputText = '[[' + ( mw.config.get( 'wgPageName' ) + '#' + escapedAnchor ).replaceAll( '_', ' ' ) + ']]';
						copyTextToClipboard( outputText );
					} );
				$span.append( ' ', $linkI );
			}
			
			if ( options.afficheP ) {
				var $linkP = $( '<a>' )
					.attr( 'href', sectionUrl )
					.attr( 'title', mw.msg( 'ancretitres-permanent-description' ) )
					.text( mw.msg( 'ancretitres-permanent-link-name' ) )
					.click( function ( e ) {
						e.preventDefault();
						var api = new mw.Api(),
						apiParams = {
							action: 'query',
							prop: 'revisions',
							titles:  mw.config.get( 'wgPageName' ),
							rvprop: 'ids',
							rvslots: 'main',
							formatversion: '2',
							format: 'json'
						},
						escapedAnchor = sectionId
							// escaping caractères spéciaux HTML
							// (partiel, '"& ne sont pas escapés pour ne pas dégrader inutilement la lisibilité du lien)
							.replaceAll( '<', '&lt;' )
							.replaceAll( '>', '&gt;' )
							// escaping caractères spéciaux MediaWiki
							.replaceAll( '[', '&#91;' )
							.replaceAll( ']', '&#93;' )
							.replaceAll( '{', '&#123;' )
							.replaceAll( '|', '&#124;' )
							.replaceAll( '}', '&#125;' ),
						revid;
						api.get( apiParams ).done( function ( data ) {
							revid = data.query.pages[0].revisions[0].revid
							var outputText = '[[ویژه:پیوند دائمی/' + revid + '#' + ( escapedAnchor ).replaceAll( '_', ' ' ) + ']]';
							copyTextToClipboard( outputText );
						});
					} );
				$span.append( ' ', $linkP );
			}

			headingContainer.append( $span[ 0 ] );
		}

	} );

} );