feat: enhance plugin settings and UI components with new label and text measurement utilities

Author: qianlifeng

CHANGELOG.md

@@ -8,19 +8,34 @@
   - Add "App font family" setting to choose system font for Wox interface #4335
   - [`Plugin Setting`] Add image emoji selector for plugin table image fields
   - [`Plugin Setting`] Add `maxHeight` property support in plugin table setting value #4339
+  - [`Plugin Store`] Add filter functionality and upgrade indicators for plugins #4356
+  - [`Browser Bookmarks`] Add Firefox support #4354
+  - [`Web Search`] Allow user to select custom browser #3597
+  - [`Setting`] Add log management features including clearing logs and changing log level
+  - [`Explorer`] Add quick jump paths and enhance file dialog interactions
 
 - Improve
   - [`Shell`] Enhance Shell plugin terminal preview to support search/full-screen/scroll-to-load functions
   - Improve query hotkey tooltips and add Wox Chrome extension link in settings #4333
   - Improve app process exit handling when shutting down Wox #4338
   - Improve the layout of the plugin settings page
+  - [`Plugin Setting`] Improve focus management and validation
+  - Improve preview functionality and local actions
+  - Improve Windows Start Menu handling by dismissing it when Wox opens #4341
+  - [`Explorer`] Improve overlay positioning and DPI handling
+  - [`Calculator`] Improve history management and limit displayed history to top 100 entries #4340
+  - [`Explorer`] Improve file path resolution for open/save dialogs on macOS
+  - Improve listview rendering performance
 
 - Fix
   - [`File Explorer Search`] Fix an issue that file explorer search plugin cannot navigate on open/save dialog
   - [`Clipboard`] Fix self-triggering in clipboard watch #4309
   - Fix an issue that Wox setting table values can't be saved sometimes
   - Fix query results not being cleared correctly when app visibility changes
   - Fix Base64 JPEG decode issue in image preview
+  - [`Plugin Setting`] Fix an issue with handling null and empty JSON responses in plugin table settings
+  - [`File`] Fix Windows Phone Link automatic downloads occurring when fetching file icons #4352
+  - Fix image loading error handling in image view
 
 ## v2.0.0 - 2026-02-09
 

wox.core/plugin/manager.go

@@ -481,9 +481,8 @@ func (m *Manager) ParseMetadata(ctx context.Context, pluginDirectory string) (Me
 }
 
 // ParseScriptMetadata parses metadata from script plugin file comments
-// Supports two formats:
+// Supports formats:
 // 1. JSON block format (preferred): # { ... } with complete plugin.json structure
-// 2. Legacy @wox.xxx format: individual @wox.id, @wox.name, etc. annotations
 func (m *Manager) ParseScriptMetadata(ctx context.Context, scriptPath string) (Metadata, error) {
 	content, err := os.ReadFile(scriptPath)
 	if err != nil {

wox.ui.flutter/wox/lib/components/plugin/wox_setting_plugin_head_view.dart

@@ -1,14 +1,13 @@
 import 'package:flutter/material.dart';
 import 'package:wox/entity/setting/wox_plugin_setting_head.dart';
 import 'package:wox/utils/colors.dart';
-import 'package:wox/utils/consts.dart';
 
 import 'wox_setting_plugin_item_view.dart';
 
 class WoxSettingPluginHead extends WoxSettingPluginItem {
   final PluginSettingValueHead item;
 
-  const WoxSettingPluginHead({super.key, required this.item, required super.value, required super.onUpdate, super.labelWidth = SETTING_LABEL_DEAULT_WIDTH});
+  const WoxSettingPluginHead({super.key, required this.item, required super.value, required super.onUpdate, required super.labelWidth});
 
   @override
   Widget build(BuildContext context) {

wox.ui.flutter/wox/lib/components/plugin/wox_setting_plugin_label_view.dart

@@ -2,14 +2,13 @@ import 'package:flutter/material.dart';
 import 'package:wox/entity/setting/wox_plugin_setting_label.dart';
 import 'package:wox/entity/wox_plugin_setting.dart';
 import 'package:wox/utils/colors.dart';
-import 'package:wox/utils/consts.dart';
 
 import 'wox_setting_plugin_item_view.dart';
 
 class WoxSettingPluginLabel extends WoxSettingPluginItem {
   final PluginSettingValueLabel item;
 
-  const WoxSettingPluginLabel({super.key, required this.item, required super.value, required super.onUpdate, super.labelWidth = SETTING_LABEL_DEAULT_WIDTH});
+  const WoxSettingPluginLabel({super.key, required this.item, required super.value, required super.onUpdate, required super.labelWidth});
 
   PluginSettingValueStyle buildEffectiveStyle() {
     final style = PluginSettingValueStyle.fromJson(<String, dynamic>{});

wox.ui.flutter/wox/lib/components/plugin/wox_setting_plugin_newline_view.dart

@@ -7,7 +7,7 @@ import 'wox_setting_plugin_item_view.dart';
 class WoxSettingPluginNewLine extends WoxSettingPluginItem {
   final PluginSettingValueNewLine item;
 
-  const WoxSettingPluginNewLine({super.key, required this.item, required super.value, required super.onUpdate, super.labelWidth = SETTING_LABEL_DEAULT_WIDTH});
+  const WoxSettingPluginNewLine({super.key, required this.item, required super.value, required super.onUpdate, required super.labelWidth});
 
   @override
   Widget build(BuildContext context) {

wox.ui.flutter/wox/lib/components/plugin/wox_setting_plugin_table_view.dart

@@ -42,7 +42,7 @@ class WoxSettingPluginTable extends WoxSettingPluginItem {
     required this.item,
     required super.value,
     required super.onUpdate,
-    super.labelWidth = SETTING_LABEL_DEAULT_WIDTH,
+    super.labelWidth = 160.0,
     this.tableWidth = 740.0,
     this.readonly = false,
     this.onUpdateValidate,

wox.ui.flutter/wox/lib/components/wox_form_action_view.dart

@@ -3,6 +3,7 @@ import 'package:flutter/services.dart';
 import 'package:wox/components/wox_button.dart';
 import 'package:wox/components/wox_checkbox.dart';
 import 'package:wox/components/wox_dropdown_button.dart';
+import 'package:wox/components/wox_platform_focus.dart';
 import 'package:wox/components/wox_textfield.dart';
 import 'package:wox/entity/setting/wox_plugin_setting_checkbox.dart';
 import 'package:wox/entity/setting/wox_plugin_setting_head.dart';
@@ -12,6 +13,7 @@ import 'package:wox/entity/setting/wox_plugin_setting_textbox.dart';
 import 'package:wox/entity/wox_plugin_setting.dart';
 import 'package:wox/entity/wox_query.dart';
 import 'package:wox/utils/colors.dart';
+import 'package:wox/utils/wox_text_measure_util.dart';
 
 /// A form panel for collecting form action values
 class WoxFormActionView extends StatefulWidget {
@@ -34,24 +36,23 @@ class _WoxFormActionViewState extends State<WoxFormActionView> {
   late Map<String, String> _values;
   final Map<String, TextEditingController> _textControllers = {};
   double _maxLabelWidth = 60;
+  bool _formInitialized = false;
 
-  double _measureLabelWidth(String text) {
+  double _measureLabelWidth(BuildContext context, String text) {
     final trimmed = text.trim();
     if (trimmed.isEmpty) {
       return 60;
     }
 
-    final painter = TextPainter(text: TextSpan(text: trimmed, style: const TextStyle(fontSize: 14, fontWeight: FontWeight.w600)), textDirection: TextDirection.ltr, maxLines: 1)
-      ..layout();
-    return painter.width + 8;
+    return WoxTextMeasureUtil.measureTextWidth(context: context, text: trimmed, style: const TextStyle(fontSize: 14, fontWeight: FontWeight.w600)) + 8;
   }
 
   @override
   void initState() {
     super.initState();
     _values = Map<String, String>.from(widget.initialValues);
 
-    // Find first focusable control, init text controllers, and calculate max label width
+    // Find first focusable control and init text controllers.
     for (int i = 0; i < widget.action.form.length; i++) {
       final item = widget.action.form[i];
       if (item.type == "textbox") {
@@ -61,27 +62,13 @@ class _WoxFormActionViewState extends State<WoxFormActionView> {
 
         final textbox = item.value as PluginSettingValueTextBox;
         _textControllers[textbox.key] = TextEditingController(text: _values[textbox.key] ?? textbox.defaultValue);
-        final labelWidth = _measureLabelWidth(widget.translate(textbox.label));
-        if (labelWidth > _maxLabelWidth) {
-          _maxLabelWidth = labelWidth;
-        }
       } else if (item.type == "select") {
         if (_firstFocusableIndex == -1) {
           _firstFocusableIndex = i;
         }
-        final select = item.value as PluginSettingValueSelect;
-        final labelWidth = _measureLabelWidth(widget.translate(select.label));
-        if (labelWidth > _maxLabelWidth) {
-          _maxLabelWidth = labelWidth;
-        }
-      } else if (item.type == "checkbox") {
-        final checkbox = item.value as PluginSettingValueCheckBox;
-        final labelWidth = _measureLabelWidth(widget.translate(checkbox.label));
-        if (labelWidth > _maxLabelWidth) {
-          _maxLabelWidth = labelWidth;
-        }
       }
     }
+    _formInitialized = true;
 
     // Request focus on the first focusable control after build
     WidgetsBinding.instance.addPostFrameCallback((_) {
@@ -93,6 +80,39 @@ class _WoxFormActionViewState extends State<WoxFormActionView> {
     });
   }
 
+  @override
+  void didChangeDependencies() {
+    super.didChangeDependencies();
+    if (!_formInitialized) {
+      return;
+    }
+
+    double maxLabelWidth = 60;
+    for (int i = 0; i < widget.action.form.length; i++) {
+      final item = widget.action.form[i];
+      if (item.type == "textbox") {
+        final textbox = item.value as PluginSettingValueTextBox;
+        final measuredWidth = _measureLabelWidth(context, widget.translate(textbox.label));
+        if (measuredWidth > maxLabelWidth) {
+          maxLabelWidth = measuredWidth;
+        }
+      } else if (item.type == "select") {
+        final select = item.value as PluginSettingValueSelect;
+        final measuredWidth = _measureLabelWidth(context, widget.translate(select.label));
+        if (measuredWidth > maxLabelWidth) {
+          maxLabelWidth = measuredWidth;
+        }
+      } else if (item.type == "checkbox") {
+        final checkbox = item.value as PluginSettingValueCheckBox;
+        final measuredWidth = _measureLabelWidth(context, widget.translate(checkbox.label));
+        if (measuredWidth > maxLabelWidth) {
+          maxLabelWidth = measuredWidth;
+        }
+      }
+    }
+    _maxLabelWidth = maxLabelWidth;
+  }
+
   @override
   void dispose() {
     _firstFocusNode.dispose();
@@ -122,10 +142,17 @@ class _WoxFormActionViewState extends State<WoxFormActionView> {
   @override
   Widget build(BuildContext context) {
     return CallbackShortcuts(
-      bindings: {const SingleActivator(LogicalKeyboardKey.enter, control: true): _handleSave, const SingleActivator(LogicalKeyboardKey.escape): widget.onCancel},
-      child: Focus(
+      bindings: {const SingleActivator(LogicalKeyboardKey.enter, control: true): _handleSave},
+      child: WoxPlatformFocus(
         focusNode: _formFocusNode,
         autofocus: true,
+        onKeyEvent: (node, event) {
+          if (event is KeyDownEvent && event.logicalKey == LogicalKeyboardKey.escape) {
+            widget.onCancel();
+            return KeyEventResult.handled;
+          }
+          return KeyEventResult.ignored;
+        },
         child: Column(
           crossAxisAlignment: CrossAxisAlignment.start,
           mainAxisSize: MainAxisSize.min,

wox.ui.flutter/wox/lib/components/wox_label.dart

@@ -0,0 +1,39 @@
+import 'package:flutter/material.dart';
+import 'package:wox/components/wox_tooltip.dart';
+import 'package:wox/utils/colors.dart';
+import 'package:wox/utils/wox_text_measure_util.dart';
+
+class WoxLabel extends StatelessWidget {
+  final String label;
+  final double width;
+  final TextStyle? style;
+  final TextAlign textAlign;
+  final bool enableTooltipOnOverflow;
+
+  const WoxLabel({super.key, required this.label, required this.width, this.style, this.textAlign = TextAlign.right, this.enableTooltipOnOverflow = true});
+
+  @override
+  Widget build(BuildContext context) {
+    final resolvedStyle = TextStyle(color: getThemeTextColor(), fontSize: 13).merge(style);
+    final textWidget = Text(label, textAlign: textAlign, style: resolvedStyle, maxLines: 1, overflow: TextOverflow.ellipsis);
+
+    return SizedBox(
+      width: width,
+      child: LayoutBuilder(
+        builder: (context, constraints) {
+          final maxWidth = constraints.maxWidth;
+          final hasLabel = label.trim().isNotEmpty;
+          final shouldShowTooltip =
+              enableTooltipOnOverflow && hasLabel && maxWidth > 0 && WoxTextMeasureUtil.isTextOverflow(context: context, text: label, style: resolvedStyle, maxWidth: maxWidth);
+          final child = SizedBox(width: double.infinity, child: textWidget);
+
+          if (!shouldShowTooltip) {
+            return child;
+          }
+
+          return WoxTooltip(message: label, child: child);
+        },
+      ),
+    );
+  }
+}

wox.ui.flutter/wox/lib/components/wox_setting_form_field.dart

@@ -1,6 +1,5 @@
 import 'package:flutter/material.dart';
-import 'package:wox/components/wox_tooltip.dart';
-import 'package:wox/utils/colors.dart';
+import 'package:wox/components/wox_label.dart';
 
 class WoxSettingFormField extends StatelessWidget {
   final String label;
@@ -16,8 +15,8 @@ class WoxSettingFormField extends StatelessWidget {
     super.key,
     required this.label,
     required this.child,
+    required this.labelWidth,
     this.tips,
-    this.labelWidth = 160,
     this.labelGap = 20,
     this.bottomSpacing = 20,
     this.tipsTopSpacing = 2,
@@ -33,7 +32,7 @@ class WoxSettingFormField extends StatelessWidget {
           Row(
             crossAxisAlignment: rowCrossAxisAlignment,
             children: [
-              Padding(padding: EdgeInsets.only(right: labelGap), child: SizedBox(width: labelWidth, child: _SettingLabelWithTooltip(label: label))),
+              Padding(padding: EdgeInsets.only(right: labelGap), child: WoxLabel(label: label, width: labelWidth)),
               Flexible(child: Align(alignment: Alignment.centerLeft, child: child)),
             ],
           ),
@@ -47,45 +46,3 @@ class WoxSettingFormField extends StatelessWidget {
     );
   }
 }
-
-class _SettingLabelWithTooltip extends StatelessWidget {
-  final String label;
-
-  const _SettingLabelWithTooltip({required this.label});
-
-  bool _isTextOverflow({required BuildContext context, required String text, required TextStyle style, required double maxWidth}) {
-    // Merge with DefaultTextStyle to match how the Text widget actually renders
-    // (Text widget inherits letterSpacing, fontFamily, etc. from the theme)
-    final resolvedStyle = DefaultTextStyle.of(context).style.merge(style);
-    final textPainter = TextPainter(
-      text: TextSpan(text: text, style: resolvedStyle),
-      textDirection: Directionality.of(context),
-      textScaler: MediaQuery.textScalerOf(context),
-      locale: Localizations.maybeLocaleOf(context),
-      maxLines: 1,
-    )..layout(minWidth: 0, maxWidth: double.infinity);
-
-    return textPainter.width > maxWidth;
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    final textStyle = TextStyle(color: getThemeTextColor(), fontSize: 13);
-    final textWidget = Text(label, textAlign: TextAlign.right, style: textStyle, maxLines: 1, overflow: TextOverflow.ellipsis);
-
-    return LayoutBuilder(
-      builder: (context, constraints) {
-        final maxWidth = constraints.maxWidth;
-        final hasLabel = label.trim().isNotEmpty;
-        final shouldShowTooltip = hasLabel && maxWidth > 0 && _isTextOverflow(context: context, text: label, style: textStyle, maxWidth: maxWidth);
-        final child = SizedBox(width: double.infinity, child: textWidget);
-
-        if (!shouldShowTooltip) {
-          return child;
-        }
-
-        return WoxTooltip(message: label, child: child);
-      },
-    );
-  }
-}