Module:Navbar: Difference between revisions
m 1 revision imported |
Per edit request on talk |
||
| Line 1: | Line 1: | ||
local p = {} | local p = {} | ||
local cfg = mw.loadData('Module:Navbar/configuration') | |||
local | local function get_title_arg(is_collapsible, template) | ||
local | local title_arg = 1 | ||
if is_collapsible then title_arg = 2 end | |||
if template then title_arg = 'template' end | |||
return title_arg | |||
end | |||
function | local function choose_links(template, args) | ||
-- The show table indicates the default displayed items. | |||
-- view, talk, edit, hist, move, watch | |||
-- TODO: Move to configuration. | |||
local show = {true, true, true, false, false, false} | |||
if template then | |||
show[2] = false | |||
show[3] = false | |||
local index = {t = 2, d = 2, e = 3, h = 4, m = 5, w = 6, | |||
talk = 2, edit = 3, hist = 4, move = 5, watch = 6} | |||
-- TODO: Consider removing TableTools dependency. | |||
for _, v in ipairs(require ('Module:TableTools').compressSparseArray(args)) do | |||
local num = index[v] | |||
if num then show[num] = true end | |||
end | |||
end | |||
local remove_edit_link = args.noedit | |||
if remove_edit_link then show[3] = false end | |||
return show | |||
end | |||
local function add_link(link_description, ul, is_mini, font_style) | |||
local l | local l | ||
if url then | if link_description.url then | ||
l = {'[', '', ']'} | l = {'[', '', ']'} | ||
else | else | ||
| Line 12: | Line 41: | ||
end | end | ||
ul:tag('li') | ul:tag('li') | ||
:addClass('nv-'..full) | :addClass('nv-' .. link_description.full) | ||
:wikitext(l[1] .. link .. l[2]) | :wikitext(l[1] .. link_description.link .. l[2]) | ||
:tag( | :tag(is_mini and 'abbr' or 'span') | ||
:attr('title', | :attr('title', link_description.html_title) | ||
:cssText( | :cssText(font_style) | ||
:wikitext( | :wikitext(is_mini and link_description.mini or link_description.full) | ||
:done() | :done() | ||
:wikitext(l[3]) | :wikitext(l[3]) | ||
:done() | |||
end | end | ||
function | local function make_list(title_text, has_brackets, displayed_links, is_mini, font_style) | ||
if | |||
local title = mw.title.new(mw.text.trim(title_text), cfg.title_namespace) | |||
: | if not title then | ||
error(cfg.invalid_title .. title_text) | |||
end | |||
local talkpage = title.talkPageTitle and title.talkPageTitle.fullText or '' | |||
-- TODO: Get link_descriptions and show into the configuration module. | |||
-- link_descriptions should be easier... | |||
local link_descriptions = { | |||
{ ['mini'] = 'v', ['full'] = 'view', ['html_title'] = 'View this template', | |||
['link'] = title.fullText, ['url'] = false }, | |||
{ ['mini'] = 't', ['full'] = 'talk', ['html_title'] = 'Discuss this template', | |||
['link'] = talkpage, ['url'] = false }, | |||
{ ['mini'] = 'e', ['full'] = 'edit', ['html_title'] = 'Edit this template', | |||
['link'] = 'Special:EditPage/' .. title.fullText, ['url'] = false }, | |||
{ ['mini'] = 'h', ['full'] = 'hist', ['html_title'] = 'History of this template', | |||
['link'] = 'Special:PageHistory/' .. title.fullText, ['url'] = false }, | |||
{ ['mini'] = 'm', ['full'] = 'move', ['html_title'] = 'Move this template', | |||
['link'] = mw.title.new('Special:Movepage'):fullUrl('target='..title.fullText), ['url'] = true }, | |||
{ ['mini'] = 'w', ['full'] = 'watch', ['html_title'] = 'Watch this template', | |||
['link'] = title:fullUrl('action=watch'), ['url'] = true } | |||
} | |||
local ul = mw.html.create('ul') | |||
if has_brackets then | |||
ul:addClass(cfg.classes.brackets) | |||
:cssText(font_style) | |||
end | |||
for i, _ in ipairs(displayed_links) do | |||
if displayed_links[i] then add_link(link_descriptions[i], ul, is_mini, font_style) end | |||
end | end | ||
return ul:done() | |||
end | end | ||
function p._navbar(args) | function p._navbar(args) | ||
-- TODO: We probably don't need both fontstyle and fontcolor... | |||
local font_style = args.fontstyle | |||
local font_color = args.fontcolor | |||
local is_collapsible = args.collapsible | |||
local is_mini = args.mini | |||
local is_plain = args.plain | |||
if | local collapsible_class = nil | ||
if is_collapsible then | |||
collapsible_class = cfg.classes.collapsible | |||
if not is_plain then is_mini = 1 end | |||
if font_color then | |||
font_style = (font_style or '') .. '; color: ' .. font_color .. ';' | |||
end | end | ||
end | end | ||
local navbar_style = args.style | |||
local | |||
local div = mw.html.create():tag('div') | local div = mw.html.create():tag('div') | ||
div | div | ||
:addClass( | :addClass(cfg.classes.navbar) | ||
:addClass( | :addClass(cfg.classes.plainlinks) | ||
:addClass( | :addClass(cfg.classes.horizontal_list) | ||
:cssText( | :addClass(collapsible_class) -- we made the determination earlier | ||
:cssText(navbar_style) | |||
if | if is_mini then div:addClass(cfg.classes.mini) end | ||
local box_text = (args.text or cfg.box_text) .. ' ' | |||
-- the concatenated space guarantees the box text is separated | |||
if not (is_mini or is_plain) then | |||
div | div | ||
:tag('span') | :tag('span') | ||
: | :addClass(cfg.classes.box_text) | ||
:cssText( | :cssText(font_style) | ||
:wikitext(box_text) | |||
:wikitext( | |||
end | end | ||
local template = args.template | |||
local displayed_links = choose_links(template, args) | |||
local has_brackets = args.brackets | |||
local title_arg = get_title_arg(is_collapsible, template) | |||
local title_text = args[title_arg] or (':' .. mw.getCurrentFrame():getParent():getTitle()) | |||
local list = make_list(title_text, has_brackets, displayed_links, is_mini, font_style) | |||
div:node(list) | |||
if | |||
local | if is_collapsible then | ||
local title_text_class | |||
if is_mini then | |||
title_text_class = cfg.classes.collapsible_title_mini | |||
else | |||
title_text_class = cfg.classes.collapsible_title_full | |||
end | |||
div | div:done() | ||
:tag('div') | |||
:addClass(title_text_class) | |||
: | :cssText(font_style) | ||
:cssText( | |||
:wikitext(args[1]) | :wikitext(args[1]) | ||
end | end | ||
return tostring(div:done()) | local frame = mw.getCurrentFrame() | ||
-- hlist -> navbar is best-effort to preserve old Common.css ordering. | |||
return frame:extensionTag{ | |||
name = 'templatestyles', args = { src = cfg.hlist_templatestyles } | |||
} .. frame:extensionTag{ | |||
name = 'templatestyles', args = { src = cfg.templatestyles } | |||
} .. tostring(div:done()) | |||
end | end | ||
function p.navbar(frame) | function p.navbar(frame) | ||
return p._navbar(require('Module:Arguments').getArgs(frame)) | |||
end | end | ||
return p | return p | ||
Revision as of 22:34, 10 October 2023
| Warning | This Lua module is used {{#if:|{{{1}}}|in system messages}}, and on approximately 4,940,000 pages, or roughly 1960317% of all pages. Changes to it can cause immediate changes to the Wikipedia user interface. To avoid major disruption and server load, any changes should be tested in the module's /sandbox or /testcases subpages, or in your own module sandbox. The tested changes can be added to this page in a single edit. Please discuss changes on the talk page before implementing them. |
{{#switch:Navbar|sandbox|doc=|#default={{#switch:Lua error: First parameter must be one of edit, move, create, upload, undelete, autoreview.|sysop|templateeditor|interfaceadmin=|#default=}}}}
{{#switch:
{{#if:
|
| {{#ifeq:Module|Module
| module
| other
}}
}}
| module =
{{#switch: protected
| pre-alpha | prealpha | pa = File:OOjs UI icon text-style.svg | alpha | a = File:OOjs UI icon bold-a.svg | beta | b = File:OOjs UI icon bold-b.svg | release | r | general | g = File:OOjs UI icon check-constructive.svg | protected | protect | p = [[File:{{#if:|Cascade-protection-shackle.svg|{{#ifeq:|sysop|Full-protection-shackle-red.svg|Semi-protection-shackle-no-text.svg}}}}|40x40px|link=]] | semiprotected | semiprotect | semi = File:Semi-protection-shackle.svg | #default = File:OOjs UI icon alert-destructive.svg}} | {{#switch: protected
| pre-alpha | prealpha | pa = <translate> This module is rated as [[<tvar name=1>Special:MyLanguage/Category:Modules in pre-alpha development</tvar>|pre-alpha]].</translate> <translate> It is unfinished, and may or may not be in active development.</translate> <translate> It should not be used from article namespace pages.</translate> <translate> Modules remain pre-alpha until the original editor (or someone who takes one over if it is abandoned for some time) is satisfied with the basic structure.</translate>{{#ifexpr:
{{#ifexpr: (
{{#ifeq:navbar|doc|1|0}} or ( {{#ifeq:{{#titleparts:module:navbar|-1|-2}}|doc|1|0}} and {{#if:{{#translation:}}|1|0}} ) )|1|0}} or {{#ifeq:Navbar|sandbox|1|0}} || {{#ifeq: | true | | }}
}}
| alpha | a = <translate> This module is rated as [[<tvar name=1>Special:MyLanguage/Category:Modules in alpha</tvar>|alpha]].</translate> <translate> It is ready for third party input, and may be used on a few pages to see if problems arise, but should be watched.</translate> <translate> Suggestions for new features or changes in their input and output mechanisms are welcome.</translate>{{#ifexpr:
{{#ifexpr: (
{{#ifeq:navbar|doc|1|0}} or ( {{#ifeq:{{#titleparts:module:navbar|-1|-2}}|doc|1|0}} and {{#if:{{#translation:}}|1|0}} ) )|1|0}} or {{#ifeq:Navbar|sandbox|1|0}} || {{#ifeq: | true | | }}
}}
| beta | b = <translate> This module is rated as [[<tvar name=1>Special:MyLanguage/Category:Modules in beta</tvar>|beta]], and is ready for widespread use.</translate> <translate> It is still new and should be used with some caution to ensure the results are as expected.</translate>{{#ifexpr:
{{#ifexpr: (
{{#ifeq:navbar|doc|1|0}} or ( {{#ifeq:{{#titleparts:module:navbar|-1|-2}}|doc|1|0}} and {{#if:{{#translation:}}|1|0}} ) )|1|0}} or {{#ifeq:Navbar|sandbox|1|0}} || {{#ifeq: | true | | }}
}}
| release | r | general | g = <translate> This module is rated as [[<tvar name=1>Special:MyLanguage/Category:Modules for general use</tvar>|ready for general use]].</translate> <translate> It has reached a mature form and is thought to be bug-free and ready for use wherever appropriate.</translate> <translate> It is ready to mention on help pages and other resources as an option for new users to learn.</translate> <translate> To reduce server load and bad output, it should be improved by sandbox testing rather than repeated trial-and-error editing.</translate>{{#ifexpr:
{{#ifexpr: (
{{#ifeq:navbar|doc|1|0}} or ( {{#ifeq:{{#titleparts:module:navbar|-1|-2}}|doc|1|0}} and {{#if:{{#translation:}}|1|0}} ) )|1|0}} or {{#ifeq:Navbar|sandbox|1|0}} || {{#ifeq: | true | | }}
}}
| protected | protect | p = <translate> This module is [[<tvar name=1>Special:MyLanguage/Category:Modules subject to page protection</tvar>|subject to {{<tvar name=2>#if:</tvar>|cascading|page}} protection]].</translate> <translate> It is a highly visible module in use by a very large number of pages.</translate> <translate> Because vandalism or mistakes would affect many pages, and even trivial editing might cause substantial load on the servers, it is [[<tvar name=1>Special:MyLanguage/Project:Protected page</tvar>|protected]] from editing.</translate>{{#ifexpr:
{{#ifexpr: (
{{#ifeq:navbar|doc|1|0}} or ( {{#ifeq:{{#titleparts:module:navbar|-1|-2}}|doc|1|0}} and {{#if:{{#translation:}}|1|0}} ) )|1|0}} or {{#ifeq:Navbar|sandbox|1|0}} || {{#ifeq: | true | | }}
}}
| #default = Template:Error
}} |
| other | #default = Template:Error }}
| File:Lua-Logo.svg | This module depends on the following other modules: |
Lua error in Module:TNT at line 159: Missing JsonConfig extension; Cannot load https://commons.wikimedia.org/wiki/Data:I18n/Uses TemplateStyles.tab. This is a Lua implementation of {{Navbar}}. It is used in Module:Navbox.
local p = {}
local cfg = mw.loadData('Module:Navbar/configuration')
local function get_title_arg(is_collapsible, template)
local title_arg = 1
if is_collapsible then title_arg = 2 end
if template then title_arg = 'template' end
return title_arg
end
local function choose_links(template, args)
-- The show table indicates the default displayed items.
-- view, talk, edit, hist, move, watch
-- TODO: Move to configuration.
local show = {true, true, true, false, false, false}
if template then
show[2] = false
show[3] = false
local index = {t = 2, d = 2, e = 3, h = 4, m = 5, w = 6,
talk = 2, edit = 3, hist = 4, move = 5, watch = 6}
-- TODO: Consider removing TableTools dependency.
for _, v in ipairs(require ('Module:TableTools').compressSparseArray(args)) do
local num = index[v]
if num then show[num] = true end
end
end
local remove_edit_link = args.noedit
if remove_edit_link then show[3] = false end
return show
end
local function add_link(link_description, ul, is_mini, font_style)
local l
if link_description.url then
l = {'[', '', ']'}
else
l = {'[[', '|', ']]'}
end
ul:tag('li')
:addClass('nv-' .. link_description.full)
:wikitext(l[1] .. link_description.link .. l[2])
:tag(is_mini and 'abbr' or 'span')
:attr('title', link_description.html_title)
:cssText(font_style)
:wikitext(is_mini and link_description.mini or link_description.full)
:done()
:wikitext(l[3])
:done()
end
local function make_list(title_text, has_brackets, displayed_links, is_mini, font_style)
local title = mw.title.new(mw.text.trim(title_text), cfg.title_namespace)
if not title then
error(cfg.invalid_title .. title_text)
end
local talkpage = title.talkPageTitle and title.talkPageTitle.fullText or ''
-- TODO: Get link_descriptions and show into the configuration module.
-- link_descriptions should be easier...
local link_descriptions = {
{ ['mini'] = 'v', ['full'] = 'view', ['html_title'] = 'View this template',
['link'] = title.fullText, ['url'] = false },
{ ['mini'] = 't', ['full'] = 'talk', ['html_title'] = 'Discuss this template',
['link'] = talkpage, ['url'] = false },
{ ['mini'] = 'e', ['full'] = 'edit', ['html_title'] = 'Edit this template',
['link'] = 'Special:EditPage/' .. title.fullText, ['url'] = false },
{ ['mini'] = 'h', ['full'] = 'hist', ['html_title'] = 'History of this template',
['link'] = 'Special:PageHistory/' .. title.fullText, ['url'] = false },
{ ['mini'] = 'm', ['full'] = 'move', ['html_title'] = 'Move this template',
['link'] = mw.title.new('Special:Movepage'):fullUrl('target='..title.fullText), ['url'] = true },
{ ['mini'] = 'w', ['full'] = 'watch', ['html_title'] = 'Watch this template',
['link'] = title:fullUrl('action=watch'), ['url'] = true }
}
local ul = mw.html.create('ul')
if has_brackets then
ul:addClass(cfg.classes.brackets)
:cssText(font_style)
end
for i, _ in ipairs(displayed_links) do
if displayed_links[i] then add_link(link_descriptions[i], ul, is_mini, font_style) end
end
return ul:done()
end
function p._navbar(args)
-- TODO: We probably don't need both fontstyle and fontcolor...
local font_style = args.fontstyle
local font_color = args.fontcolor
local is_collapsible = args.collapsible
local is_mini = args.mini
local is_plain = args.plain
local collapsible_class = nil
if is_collapsible then
collapsible_class = cfg.classes.collapsible
if not is_plain then is_mini = 1 end
if font_color then
font_style = (font_style or '') .. '; color: ' .. font_color .. ';'
end
end
local navbar_style = args.style
local div = mw.html.create():tag('div')
div
:addClass(cfg.classes.navbar)
:addClass(cfg.classes.plainlinks)
:addClass(cfg.classes.horizontal_list)
:addClass(collapsible_class) -- we made the determination earlier
:cssText(navbar_style)
if is_mini then div:addClass(cfg.classes.mini) end
local box_text = (args.text or cfg.box_text) .. ' '
-- the concatenated space guarantees the box text is separated
if not (is_mini or is_plain) then
div
:tag('span')
:addClass(cfg.classes.box_text)
:cssText(font_style)
:wikitext(box_text)
end
local template = args.template
local displayed_links = choose_links(template, args)
local has_brackets = args.brackets
local title_arg = get_title_arg(is_collapsible, template)
local title_text = args[title_arg] or (':' .. mw.getCurrentFrame():getParent():getTitle())
local list = make_list(title_text, has_brackets, displayed_links, is_mini, font_style)
div:node(list)
if is_collapsible then
local title_text_class
if is_mini then
title_text_class = cfg.classes.collapsible_title_mini
else
title_text_class = cfg.classes.collapsible_title_full
end
div:done()
:tag('div')
:addClass(title_text_class)
:cssText(font_style)
:wikitext(args[1])
end
local frame = mw.getCurrentFrame()
-- hlist -> navbar is best-effort to preserve old Common.css ordering.
return frame:extensionTag{
name = 'templatestyles', args = { src = cfg.hlist_templatestyles }
} .. frame:extensionTag{
name = 'templatestyles', args = { src = cfg.templatestyles }
} .. tostring(div:done())
end
function p.navbar(frame)
return p._navbar(require('Module:Arguments').getArgs(frame))
end
return p