モジュール:Separated entries

モジュールの解説[表示] [編集] [履歴] [キャッシュを破棄]

使い方

Module:Separated entries と {{Separated entries}} は、mw.text.listToText へのテンプレートフロントエンドとして機能します。これらは任意数の位置パラメーターを受け取り、それらを |separator =  で結合します。最後と最後から2番目の項目の間に別の区切り文字を使いたい場合は |conjunction =  を任意指定できます。開始位置パラメーターは |start =  で指定できます。前後の空白は自動的に除去されます。意図的に前後に空白を入れたい場合は、スペースには  、改行には 
 を使用してください。Separated entries は設計上、エラーを発生させません。

{{#invoke:separated entries|main|separator=...}}

より複雑なケース（特定のパラメーターのみを選ぶ、前処理を行う、最後のパラメーターを省くなど）では、{{#invoke:params|list_values}} を利用できます。以下の2つの例は区切り文字を「 + 」、連結語を「 ... 」とした場合で、ほぼ同様の結果を生成します。

1. {{#invoke:separated entries|main|separator= + |conjunction= ... }}
2. {{#invoke:params|sequential|trimming_values|with_value_not_matching||strict|squeezing|setting|i/l| + | ... |list_values}}

関連項目

• {{Enum}}
• {{Br separated entries}}
• {{#invoke:params|list_values}}

この解説は、モジュール:Separated entries/docから呼び出されています。 (編集 | 履歴)
編集者は、このモジュールをサンドボックス (作成 | 複製)とテストケース (作成)で試すことができます。（解説）
このモジュールのサブページ一覧。

-- This module takes positional parameters as input and concatenates them with
-- an optional separator. The final separator (the "conjunction") can be
-- specified independently, enabling natural-language lists like
-- "foo, bar, baz and qux". The starting parameter can also be specified.

local compressSparseArray = require('Module:TableTools').compressSparseArray
local p = {}

function p._main(args)
	local dataPlural = args.dataPlural
	local separator = args.separator
		-- Decode (convert to Unicode) HTML escape sequences, such as " " for space.
		and mw.text.decode(args.separator) or ''
	local conjunction = args.conjunction and mw.text.decode(args.conjunction) or separator
	-- Discard values before the starting parameter.
	local start = tonumber(args.start)
	if start then
		for i = 1, start - 1 do args[i] = nil end
	end
	-- Discard named parameters.
	local values = compressSparseArray(args)
	local result = mw.text.listToText(values, separator, conjunction)
	if dataPlural and #values > 0 and (#separator > 0 or #conjunction > 0) then
		-- flag to [[Module:Detect singular]] whether this is a list with >1 element
		result = result..'<span style="display:none" data-plural="'..(#values > 1 and '1' or '0')..'"></span>'
	end
	return result
end

local function makeInvokeFunction(separator, conjunction, first)
	return function (frame)
		local args = require('Module:Arguments').getArgs(frame, {frameOnly = (frame.args.frameOnly or '') ~= ''})
		args.separator = separator or args.separator
		args.conjunction = conjunction or args.conjunction
		args.first = first or args.first
		return p._main(args)
	end
end

p.main = makeInvokeFunction()
p.br = makeInvokeFunction('<br />')
p.comma = makeInvokeFunction(mw.message.new('comma-separator'):plain())

return p