Module:Mbox

Module documentation[view][edit][history][purge]

This documentation is transcluded from Module:Mbox/doc. Changes can be proposed in the talk page.

Module:Mbox requires 2 modules: Module:Error and Module:LibraryUtil.

Module:Mbox is required by 2 modules: Module:DependencyList and Module:Documentation.

Module:Mbox loads styles from Module:Mbox/styles.css.

Function list
L 13 — makeWikitextError L 20 — p.mbox L 37 — p._mbox

---

local libraryUtil = require( 'libraryUtil' )
local checkType = libraryUtil.checkType
local mArguments -- lazily initialise [[Module:Arguments]]
local mError -- lazily initialise [[Module:Error]]

local p = {}

--- Helper function to throw error
--
-- @param msg string - Error message
--
-- @return string - Formatted error message in wikitext
local function makeWikitextError( msg )
	mError = require( 'Module:Error' )
	return mError.error{
		message = 'Error: ' .. msg .. '.'
	}
end

function p.mbox( frame )
	local args = getArgs( frame )
	local title = args[1] or args[ 'title' ]
	local text = args[2] or args[ 'text' ]
	if not s then
		return p.makeWikitextError(
			'no text specified',
			'Template:Mbox#Errors',
			args.category
		)
	end
	return p._mbox( title, text, {
		extraclasses = args.extraclasses,
		icon = args.icon
	} )
end

function p._mbox( title, text, options )
	checkType( '_mbox', 1, title, 'string' )
	checkType( '_mbox', 2, text, 'string' )
	checkType( '_mbox', 3, options, 'table', true )

	options = options or {}
	local mbox = mw.html.create( 'div' )
	local extraclasses
	if type( options.extraclasses ) == 'string' then
		extraclasses = options.extraclasses
	end

	mbox
		:attr( 'role', 'presentation' )
		:addClass( 'mbox' )
		:addClass( extraclasses )

	local mboxTitle = mbox:tag( 'div' ):addClass( 'mbox-title' )
	
	if options.icon and type( options.icon ) == 'string' then
		mboxTitle:tag( 'div' )
			:addClass( 'mbox-icon metadata' )
			:wikitext( '[[File:' .. options.icon .. '|14px|link=]]' )
			:done()
			:tag( 'div' )
				:wikitext( title )
	else
		mboxTitle:wikitext( title )
	end

	mbox:tag( 'div' )
		:addClass( 'mbox-text' )
		:wikitext( text )

	return mw.getCurrentFrame():extensionTag{
		name = 'templatestyles', args = { src = 'Module:Mbox/styles.css' }
	} .. tostring(mbox)
end

return p