summaryrefslogtreecommitdiffstats
path: root/includes/view-helpers/select_field.php
diff options
context:
space:
mode:
Diffstat (limited to 'includes/view-helpers/select_field.php')
-rw-r--r--includes/view-helpers/select_field.php32
1 files changed, 32 insertions, 0 deletions
diff --git a/includes/view-helpers/select_field.php b/includes/view-helpers/select_field.php
new file mode 100644
index 0000000..816f8ef
--- /dev/null
+++ b/includes/view-helpers/select_field.php
@@ -0,0 +1,32 @@
+<?php
+// SPDX-FileCopyrightText: 2021 Andrea Chirulescu <andrea.chirulescu@gmail.com>
+// SPDX-FileCopyrightText: 2021 Harald Eilertsen <haraldei@anduin.net>
+//
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+namespace EternalTerror\ViewHelpers;
+
+/**
+ * Return HTML code for a selction box with the given options and preselected value.
+ *
+ * @param string $name The name attribute for the selection box
+ * @param array $opts The options as arrays of [value, label] pairs
+ * @param mixed|int $selected The value of the preselected option, or null if no
+ * option is preselected.
+ * @param string $blank Text to use for "no selection", defaults to "Please
+ * select..."
+ * @return string
+ */
+function select_field(
+ string $name,
+ ?array $opts = [],
+ $selected = null,
+ string $blank = "Please select...") : string
+{
+ $body = "<option value=\"\">{$blank}</option>";
+ foreach ($opts as $opt) {
+ $sel = selected($selected, $opt[0], false);
+ $body .= "<option value=\"{$opt[0]}\"{$sel}>{$opt[1]}</option>";
+ }
+ return "<select name=\"{$name}\">{$body}</select>";
+}